Skip to main content
POST
Create a Genjutsu task
Select one of the three modes. Read the limits and billing rules before submitting. Submit once and retrieve the returned task ID. An interrupted submission can have an uncertain outcome; do not automatically submit another task. For pending tasks, poll the returned ID. The successful task detail includes usage with billable seconds and the applicable price row. See usage fields.

Authorizations

Authorization
string
header
required

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

Body

application/json
model
string
required
Allowed value: "higgsfield-genjutsu"
mode
string
required
Allowed value: "motion_transfer"
assets
object
required
prompt
string
default:""
Maximum string length: 10000
controls
object

Response

Task accepted.

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