Generate
generateRun a capability (see list_capabilities). model is optional; the capability's first available model,
in list_capabilities order, is used. estimate_cost shows which model that is and its price.
inputs maps slot names to asset ids, e.g. {"images": [id1, id2]} for image.edit or
{"start_frame": [id]} for video.generate; ids come from upload_asset or earlier jobs' outputs. A public
https URL or a data: URI also works in place of an id; the API stores it as an asset at submit.
Credits are charged per job; the response has credits_estimate. With wait=false (default) it returns at
once with request_id; with wait=true the API holds the submit until the job finishes (up to 60s, then
polling continues) for up to timeout_s (max 600) and returns the final status,
whose outputs list the produced asset ids. Images take seconds to a minute; video takes minutes, so
prefer wait=false then wait_for_job. workflow_run_id/step_key tag the job as a step of a workflow.
item (an item id, slug or @slug in project; see list_items) records the output as a new take of that
item. The take is not starred automatically: review it with list_takes and keep it with star_take.
Image models only: num_outputs (1 to the model's max_outputs, at most 4) makes several images in one
job, priced per image and charged only for images delivered; output_format is png (default), jpeg or
webp, and output_quality (1-100) sets jpeg/webp encoding quality.
loras applies up to three platform LoRAs (styles, looks) by slug, optionally with a strength as
"slug:0.8" (default is the LoRA's own). Only models with a lora_family accept them, and only LoRAs of that
family; list_loras shows what fits a model. Each LoRA adds 15% to the price and its trigger words to the prompt.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"capability": "<capability>"
},
"name": "generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | ||
| seed | No | ||
| wait | No | ||
| loras | No | ||
| model | No | ||
| inputs | No | ||
| prompt | No | ||
| project | No | ||
| quality | No | ||
| step_key | No | ||
| timeout_s | No | ||
| capability | Yes | ||
| duration_s | No | ||
| resolution | No | ||
| num_outputs | No | ||
| aspect_ratio | No | ||
| output_format | No | ||
| output_quality | No | ||
| workflow_run_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||