Media Generation

TOOL generate_image

Generate an AI image from a text prompt. Requires Professional or Ultimate plan. Costs 1 studio credit per image (3 credits with fast=true).

Example prompts

"Generate a thumbnail image of a mysterious dark forest with glowing eyes, 16:9 aspect ratio"

"Generate a fast image of an astronaut riding a horse on Mars"

Parameter	Type	Default	Description
prompt	string	required	Description of the image to generate
model	string	nano-banana-2	Model: `nano-banana-2` (default, 1 credit), `nano-banana-pro` (2 credits; supports up to 8 reference images), `gpt-image-2` (0.35 credits, cheapest; text-to-image or image-to-image), `seedream-4.5-edit` (1 credit; requires reference_image_url), `seedream-5.0-lite` (1 credit; optional reference). With `fast=true` every model costs 3x its base, never less than 3.
aspect_ratio	string	16:9	Aspect ratio (e.g. 16:9, 9:16, 1:1)
reference_image_url	string	null	Optional reference image URL
reference_image_urls	array	null	Optional list of reference image URLs (up to 8 on nano-banana-pro; also multi-ref on nano-banana-2, seedream-5.0-lite, gpt-image-2). Takes precedence over reference_image_url.
fast	boolean	false	Fast mode — bypasses the standard ladder for sub-30s outputs. Costs 3x the model's base credits, never less than 3. Defaults to `false`.

Fast mode: set fast=true to bypass the standard provider ladder and route the request through a low-latency lane. Costs 3x the model's base credits, never less than 3. Same models, same prompt; sub-30s outputs in the typical case. Reference images still work.

TOOL generate_video

Generate an AI video from a text prompt. Requires Professional or Ultimate plan. Costs 3–520 studio credits depending on model, resolution, duration and sound — the exact figure comes back in credit_cost.

Example prompt

"Generate a 4-second vertical video of a cat walking through a neon-lit city at night using sora-2"

Parameter	Type	Default	Description
prompt	string	required	Description of the video to generate
model	string	sora-2	Model: `sora-2` (14/27/40 credits for 4/8/12s), `sora-2-pro` (40/80/120 at 720p; 67/134/200 at 1024p), `veo3-lite` (5/6/25 for 720p/1080p/4k), `veo3-fast` (10/11/30), `veo3-quality` (42/43/62), `kling-2.6` (5s=10, 10s=19; doubled with sound), `grok-image-to-video` / `grok-text-to-video` (3–40, per second), `seedance-2-mini` (4–52), `seedance-2-fast` (6–83), `seedance-2` (8–520), `seedance-2-5` (5–315, up to 30s, audio included)
seconds	string	4	Duration for sora-2 / sora-2-pro (4, 8, or 12 seconds)
size	string	720x1280	Sora resolution: 720x1280 / 1280x720, plus 1024x1792 / 1792x1024 on sora-2-pro. There is no 1080p Sora tier.
duration	string	5	Duration for kling (5 or 10), grok (6–30) and seedance (4–15; 1–30 on seedance-2-5). Clamped to range before billing.
sound	boolean	false	Include audio (kling and seedance). Raises the cost; seedance-2-5 includes audio free.
aspect_ratio	string	9:16	Aspect ratio (e.g. 9:16, 16:9)
input_reference_url	string	null	Reference image URL
resolution	string	null	Output resolution: veo3 720p/1080p/4k; grok 480p/720p/1080p; seedance 480p/720p (plus 1080p/4k on seedance-2; seedance-2-5 is 480p/720p only)

TOOL get_media_job_status

Check the status of a media generation job. Pass the job ID returned by generate_image, generate_video, or generate_tts; returns the job state and, when finished, the hosted result URL.

Parameter	Type	Default	Description
job_id	string	required	Job ID returned by generate_image, generate_video, or generate_tts

TOOL remove_captions

Remove captions or watermarks from a video. Costs 12 credits per minute (0.2 per second, rounded up). Requires Professional or Ultimate plan.

Parameter	Type	Default	Description
video_url	string	required	URL of the video to remove captions from

Buy More Credits