Skip to main content
POST
Create a generation

Authorizations

Authorization
string
header
required

Headers

Idempotency-Key
string
required

Stable key for this logical request. Reuse only with the exact same body.

Required string length: 1 - 255

Body

application/json
mode
enum<string>
required
Available options:
text_to_image,
image_to_image,
image_edit,
text_to_video,
image_to_video
prompt
string
required
Minimum string length: 1
seed_mode
enum<string>
required
Available options:
random,
custom
checkpoint
object
required
negative_prompt
string
edit_instruction
string
seed
integer

Required when seed_mode is custom.

Required range: 0 <= x <= 1999999999
loras
object[]
Maximum array length: 4
source_creation_id
string<uuid>

Required for image_to_image, image_edit, and image_to_video.

reference_creation_id
string<uuid>
width
number
default:768
height
number
default:1024
steps
number
default:8
cfg_scale
number
default:1
duration_seconds
number
default:5
quality
string
default:medium
fps
number
default:30
audio_enabled
boolean
default:false
audio_prompt
string
webhook_url
string<uri>
Pattern: ^https://

Response

Generation accepted

object
string
required
Allowed value: "generation"
request_id
string
required
Pattern: ^req_
status
enum<string>
required
Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED
poll_url
string<uri>
required
credits
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
kind
enum<string> | null
Available options:
image,
video,
null
progress
number
output
object
error
object
completed_at
string<date-time> | null