Generate an image
generate_imageGenerate a still image from a prompt with a hosted model and put it on the timeline as an image item. The still takes its place on the timeline at start straight away, and the finished image fills it when the run ends. Quality standard (default) or best (holds fine detail and spells lettering, signage and title text reliably; costs more). image lists project images (id or file name) to redraw or take from, such as a product shot to put in a new scene; standard takes up to 6, best up to 4, and an edit at best costs more than drawing from text. durationSeconds is how long the still sits on the timeline (default 5). Returns at once with the generation id; generation_status with wait: true waits on the run and fills the still when it ends. Costs credits; the error says what to fix.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Item name; default: the prompt, shortened | |
| wait | No | true waits for the result in this call (a long run hands back a job); default: return at once | |
| image | No | Images to redraw or take from: media ids or names | |
| model | No | Exact image model id; overrides quality | |
| start | No | Timeline seconds; default: after the track’s last clip | |
| track | No | Track name or id; default: first video track or a new "Generated" one | |
| aspect | No | Default: the project’s, or the closest the model renders | |
| prompt | Yes | What the image should show; quote any words it has to spell | |
| project | Yes | Project id or exact name | |
| quality | No | ||
| durationSeconds | No | How long the still sits on the timeline |