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 when it fails without doing the work.
Models
Every generation runs on a model. When none is given, the account’s default for that medium applies;manage_settings sets it. list_models is 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
Resolution, quality, duration, aspect ratio, sound, count, and on some models the input images and clips set the price, each taken from the call or from the model’s default. Models and prices lists them.estimate_cost quotes a planned call from the same rates. Every charged call takes 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, sends and prices only the stretch the clip plays, and the result takes the clip’s place when it is ready, with its position and look kept.
The result
A finished generation carries its prompt and settings on the item (get_items), which is the starting point for a variation. Readable text rarely survives video generation, so words are usually placed on a still first, 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.