Media tools

Generate images and videos using 40+ AI models. Always call get_models first to see available models, costs, and whether a model needs an input image.

#generate_media

Starts an image or video generation.

Parameters:

Example (text-to-image):

{
  "prompt": "A futuristic city at sunset with flying cars",
  "model": "nano-banana",
  "generation_type": "text-to-image",
  "aspect_ratio": "16:9",
  "quality": "pro"
}

Example (image-to-video, one input image required):

{
  "prompt": "Gentle motion and subtle movement",
  "model": "kling-2-6-image-to-video",
  "generation_type": "image-to-video",
  "source_media_urls": ["https://example.com/your-image.jpg"],
  "aspect_ratio": "16:9",
  "duration": "5s"
}

Response: Includes generation_id, status (e.g. pending), and often estimated_time_seconds and estimated_cost_credits. Poll with get_generation_status until status is completed or failed.

Models that support duration:

For image-only models, duration is ignored.

Models that support negative_prompt:

All other models ignore negative_prompt.

Models that support quality (or equivalent):

For other models, quality is ignored.

Prompt character limits:

Some models enforce a maximum prompt length. Exceeding it may return an error or truncation.

Others may have no documented limit or use server defaults.

Input file (image and video) limits:

For image-to-video and image-to-image, source_media_urls is a list of URLs. Most models accept images only (JPEG, PNG, WebP, typically 10 MB max per file). Some models also accept video inputs; when they do, format and size limits apply (e.g. MP4, max duration).

Use get_models to confirm input_media_types and capabilities for a given model. See Account tools for model list and pricing.

Kling 3.0 – elements (optional):

Elements let you reference images or videos in your prompt using @element_name. Pass kling_elements as an array of objects with name, description, and either element_input_urls (2–4 image URLs) or element_input_video_urls (1 video URL). Elements can only be used when you have at least 1 picture: text-to-video + 1 image, or image-to-video with first and last frame. Each element requires a title (name) and description. Image elements: JPG/PNG, min 300×300px, max 10MB each. Video elements: MP4/MOV, max 50MB.

Seedance 1.5 Pro – two modes (check generation_type before using images):

Models that support audio (sound parameter):

All other video models do not support the sound parameter. Image-only models ignore sound.

#get_generation_status

Check the status of a media generation and get output URLs when done.

Parameters:

Response: Includes status (pending, queued, processing, completed, failed), progress, and when completed an outputs array with url, thumbnail_url, optimized_url, media_type, dimensions, etc.

#get_generation_estimate

Get a parameter-specific estimated processing time for a given model and options (no job is started). For a per-model estimated duration in one call, use get_models; each model includes estimated_time_seconds. Use get_generation_estimate when you need an estimate that depends on prompt length, duration, or other parameters.

Parameters:

Response: Estimated time (and optionally confidence/sample size) so you can set user expectations before calling generate_media.

#Model rules

• Text-to-image and text-to-video: Do not send source_media_urls (unless the model supports an optional reference image). Exception: seedance-1-5-pro in text-to-video mode accepts 0–1 optional images.
• Image-to-video and image-to-image: Send image (and when supported, video) URL(s) in source_media_urls. Most models need images only; some (e.g. Kling 2.6 Motion Control) require 1 image + 1 video. seedance-1-5-pro in image-to-video mode requires exactly 2 images (start + end frame). Respect each model’s input limits above.
• Audio: kling-2-6 and kling-3-0 support sound: true; other models ignore sound.
• Use get_models to see which models support which generation types, input_media_types (e.g. image, video), and required input counts.

See Limitations for rate limits and credits.