Skip to main content
GET
Retrieve a Genjutsu task
Use the complete higgsfieldgenjutsu: ID returned by creation and the API key that owns the task. Poll while queued or running. On succeeded, read outputs.videos; on failed or cancelled, stop polling. Results are stored by GENGEN and returned as signed HTTPS URLs. Retrieve again to renew a URL. Repeated retrieval does not create work or charge again.

Usage

On success, usage.inputVideoDurationSeconds gives the full source length. processedDurationSeconds is the portion processed, up to 30 seconds. billableSeconds rounds that portion up to a whole second. mode and the resolution tier string select the price row. Multiply billableSeconds by the per-second rate for priceRowId in the price catalog.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

Current task state, including outputs and usage on success.

id
string
required
Example:

"higgsfieldgenjutsu:12345678-1234-4234-8234-123456789abc"

model
string
required
Allowed value: "higgsfield-genjutsu"
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
cancelled
outputs
object
required
usage
object

Successful task detail. Billable seconds are the source video duration clipped to 30 seconds and rounded up. Mode and resolution select the price row.

failureReason
string