generate_image, generate_video and generate_audio run a model on a prompt and, where the type accepts them, on library items. Images, videos and music return a job, and get_jobs returns the item when it is ready; a voiceover or a sound effect finishes inside the call. A generation the model fails to produce is refunded. Audio is charged before the provider runs, and refunded if it fails without doing the work.
Models
Every generation runs on a model. When none is given, the account’s default for that medium is used, andmanage_settings sets it. list_models returns the catalogue: each image and video model’s id, supported types and price at its default settings, and which model is the default. With model it returns one model in full: its exact settings, limits and accepted references. type: "voice" lists the voiceover voices, and every voice speaks every language generate_audio accepts; a voiceover with no voice_id uses the brand kit’s voice, or the default one. Settings are validated against the catalogue before anything is charged. The catalogue changes as models are added and retired. Models and prices lists every model with its price for each setting.
Types
Each model’s catalogue entry lists the types it accepts.
source_refs are the media the model works from. reference_refs are images for style or character consistency, or videos for motion, on models that accept them.
Price
The price depends on resolution, quality, duration, aspect ratio, sound, count, and on some models the input images and clips, each taken from the call or from the model’s default. Models and prices lists them.estimate_cost gives the price of a planned call from the same rates. Every charged call accepts an idempotency_key; see Costs.
On a clip
Withtimeline_id and clip_id, a generation, an upscale or a video’s background removal works on that clip’s media, sending and charging for only the part the clip plays. When it is ready, the result replaces the clip and keeps its position and look.
The result
A finished generation keeps its prompt and settings on the item (get_items), which can be the starting point for a variation. Readable text rarely survives video generation. Words hold up better when placed on a still before generating, or added on the timeline as text.
Related tools
upscale_media (image to 4K, video to 4K up to five minutes at a time), remove_background and reframe_image are charged in credits the same way and return jobs. extract_media, which crops a picture or takes a still out of a video, is free; a frame of a timeline uses cloud processing.
