Reference
Models, tasks, schemas, and pricing
Inspect every customer-visible model, availability state, generation task, input schema, output contract, and published unit price.
On this page
This reference is generated from the same checked catalog used by docs and pricing. Use task discovery at runtime before constructing requests, and use POST /v1/estimate for a concrete total.
01
Model availability
Available tasks12
Available models14
Published prices29
gemini-omniGemini Omnigemini-omni
Available. Runnable tasks: video.create.
gemini-omniGemini Omni Flashgemini-omni-flash
Available. Runnable tasks: video.create.
gpt-imageGPT Image 2gpt-image-2
Available. Runnable tasks: image.create, image.edit.
gpt-imageGPT Image 2.5 Flaregpt-image-2.5-flare
Available. Runnable tasks: image.create, image.edit.
gpt-imageGPT Image 2.5 Sunburstgpt-image-2.5-sunburst
Available. Runnable tasks: image.create, image.edit.
nano-bananaNano Banana 2nano-banana-2
Available. Runnable tasks: image.create, image.edit.
nano-bananaNano Banana 2 Litenano-banana-2-lite
Available. Runnable tasks: image.create, image.edit.
nano-bananaNano Banana Pronano-banana-pro
Available. Runnable tasks: image.create, image.edit.
seedanceSeedance 2seedance-2
Available. Runnable tasks: video.create.
seedanceSeedance 2 Fastseedance-2-fast
Available. Runnable tasks: video.create.
seedanceSeedance 2 Miniseedance-2-mini
Available. Runnable tasks: video.create.
seedanceSeedance 2.5seedance-2.5
Available. Runnable tasks: video.create, video.edit.
seedreamSeedream 5.0 Proseedream-5-pro
Available. Runnable tasks: image.create, image.edit.
sync-lipsyncSync Lipsync V3sync-lipsync-v3
Available. Runnable tasks: video.lipsync.
02
Task contracts
imageCreate Imageimage.create
gpt-image-2$0.03 per imageMinimum $0.03gpt-image-2.5-flare$0.00474 per imageMinimum $0.004745gpt-image-2.5-sunburst$0.00474 per imageMinimum $0.004745nano-banana-2$0.04 per imageMinimum $0.04nano-banana-2-lite$0.02 per imageMinimum $0.02nano-banana-pro$0.09 per imageMinimum $0.09seedream-5-pro$0.035 per imageMinimum $0.035{
"model": "gpt-image-2",
"defaults": {
"aspect_ratio": "auto",
"background": null,
"resolution": "1K"
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"aspect_ratio": {
"const": "auto"
}
}
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "5:4"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "4:5"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "3:1"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "1:3"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "9:21"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "1:1"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K",
"2K"
]
}
}
}
},
{
"if": {
"properties": {
"background": {
"type": "string"
}
},
"required": [
"background"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
}
],
"properties": {
"aspect_ratio": {
"default": "auto",
"enum": [
"auto",
"1:1",
"3:2",
"2:3",
"4:3",
"3:4",
"16:9",
"9:16",
"2:1",
"1:2",
"3:1",
"1:3",
"21:9",
"9:21",
"5:4",
"4:5"
],
"type": "string"
},
"background": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Background choices require 1K. Choose Default to use any supported resolution.",
"enum": [
"transparent",
"opaque",
"auto",
null
]
},
"prompt": {
"maxLength": 32000,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"reference_images": {
"items": {
"$ref": "#/$defs/ReferenceUrlInput"
},
"maxItems": 16,
"type": "array"
},
"resolution": {
"default": "1K",
"description": "Auto and restricted aspect ratios require 1K; square supports 1K or 2K. Invalid combinations are rejected.",
"enum": [
"1K",
"2K",
"4K"
],
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}imageEdit Imageimage.edit
gpt-image-2$0.03 per imageMinimum $0.03gpt-image-2.5-flare$0.00474 per imageMinimum $0.070281gpt-image-2.5-sunburst$0.00474 per imageMinimum $0.070281nano-banana-2$0.04 per imageMinimum $0.04nano-banana-2-lite$0.02 per imageMinimum $0.02nano-banana-pro$0.09 per imageMinimum $0.09seedream-5-pro$0.035 per imageMinimum $0.035{
"model": "gpt-image-2",
"defaults": {
"aspect_ratio": "auto",
"background": null,
"resolution": "1K"
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"aspect_ratio": {
"const": "auto"
}
}
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "5:4"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "4:5"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "3:1"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "1:3"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "9:21"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
},
{
"if": {
"properties": {
"aspect_ratio": {
"const": "1:1"
}
},
"required": [
"aspect_ratio"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K",
"2K"
]
}
}
}
},
{
"if": {
"properties": {
"background": {
"type": "string"
}
},
"required": [
"background"
]
},
"then": {
"properties": {
"resolution": {
"enum": [
"1K"
]
}
}
}
}
],
"properties": {
"aspect_ratio": {
"default": "auto",
"enum": [
"auto",
"1:1",
"3:2",
"2:3",
"4:3",
"3:4",
"16:9",
"9:16",
"2:1",
"1:2",
"3:1",
"1:3",
"21:9",
"9:21",
"5:4",
"4:5"
],
"type": "string"
},
"background": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Background choices require 1K. Choose Default to use any supported resolution.",
"enum": [
"transparent",
"opaque",
"auto",
null
]
},
"images": {
"items": {
"$ref": "#/$defs/ReferenceUrlInput"
},
"maxItems": 16,
"minItems": 1,
"type": "array"
},
"prompt": {
"maxLength": 32000,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"resolution": {
"default": "1K",
"description": "Auto and restricted aspect ratios require 1K; square supports 1K or 2K. Invalid combinations are rejected.",
"enum": [
"1K",
"2K",
"4K"
],
"type": "string"
}
},
"required": [
"prompt",
"images"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoSearch Social Videossocial.search
Omit model$0.35 per operation; exact price varies by platform and result limitMinimum $0.01{
"model": null,
"defaults": {
"limit": 20,
"max_duration_seconds": null,
"media_type": "video",
"min_views": null,
"published_after": null,
"sort": "relevance"
},
"input_schema": {
"$defs": {
"SocialMediaType": {
"enum": [
"video",
"carousel"
],
"type": "string"
},
"SocialPlatform": {
"enum": [
"tiktok",
"instagram_reels",
"youtube_shorts"
],
"type": "string"
},
"SocialSort": {
"enum": [
"relevance",
"recent",
"popular"
],
"type": "string"
}
},
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"max_duration_seconds": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 600,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"media_type": {
"$ref": "#/$defs/SocialMediaType",
"default": "video",
"description": "Use carousel to search multi-image TikTok photo posts. Carousel results carry ordered image_urls and no duration. Carousel search is only available on TikTok."
},
"min_views": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"platform": {
"$ref": "#/$defs/SocialPlatform",
"description": "TikTok searches use a US context. Instagram Reels and YouTube Shorts use their search integration's default context because those integrations do not support country selection."
},
"published_after": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"query": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"sort": {
"$ref": "#/$defs/SocialSort",
"default": "relevance"
}
},
"required": [
"platform",
"query"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
},
"SocialCreator": {
"properties": {
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"SocialMediaType": {
"enum": [
"video",
"carousel"
],
"type": "string"
},
"SocialMetrics": {
"properties": {
"comments": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"likes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"shares": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"views": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"SocialPlatform": {
"enum": [
"tiktok",
"instagram_reels",
"youtube_shorts"
],
"type": "string"
},
"SocialSearchResult": {
"properties": {
"count": {
"minimum": 0,
"type": "integer"
},
"platform": {
"$ref": "#/$defs/SocialPlatform"
},
"query": {
"type": "string"
},
"videos": {
"items": {
"$ref": "#/$defs/SocialVideo"
},
"type": "array"
}
},
"required": [
"platform",
"query",
"videos",
"count"
],
"type": "object"
},
"SocialVideo": {
"properties": {
"caption": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"creator": {
"$ref": "#/$defs/SocialCreator"
},
"duration_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"hashtags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"image_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"media_type": {
"$ref": "#/$defs/SocialMediaType",
"default": "video"
},
"metrics": {
"$ref": "#/$defs/SocialMetrics"
},
"platform": {
"$ref": "#/$defs/SocialPlatform"
},
"published_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"thumbnail_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"url": {
"type": "string"
}
},
"required": [
"id",
"platform",
"url",
"creator"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 0,
"type": "array"
},
"data": {
"$ref": "#/$defs/SocialSearchResult"
}
},
"required": [
"assets",
"data"
],
"type": "object"
}videoAdd Audio to Videovideo.add_audio
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {
"audio_volume": 1,
"mode": "replace",
"original_audio_volume": null
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"audio": {
"$ref": "#/$defs/ReferenceUrlInput"
},
"audio_volume": {
"default": 1,
"description": "Volume level for the added audio (1.0 = normal)",
"maximum": 2,
"minimum": 0,
"type": "number"
},
"mode": {
"default": "replace",
"enum": [
"replace",
"mix"
],
"type": "string"
},
"original_audio_volume": {
"anyOf": [
{
"maximum": 2,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Existing video audio volume when mode is mix."
},
"video": {
"$ref": "#/$defs/ReferenceUrlInput"
}
},
"required": [
"video",
"audio"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoConcatenate Videosvideo.concat
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"videos": {
"items": {
"$ref": "#/$defs/ReferenceUrlInput"
},
"maxItems": 8,
"minItems": 2,
"type": "array"
}
},
"required": [
"videos"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
},
"VideoConcatOutputData": {
"properties": {
"duration_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"$ref": "#/$defs/VideoConcatOutputData"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoCreate Videovideo.create
gemini-omni$0.315 per generationMinimum $0.315gemini-omni-flash$0.315 per generationMinimum $0.315seedance-2$0.0575 per secondMinimum $0.345seedance-2-fast$0.045 per secondMinimum $0.27seedance-2-mini$0.03 per secondMinimum $0.18seedance-2.5$0.085 per secondMinimum $0.51{
"model": "gemini-omni",
"defaults": {
"aspect_ratio": "9:16",
"duration_seconds": 4,
"reference_video": null,
"seed": null
},
"input_schema": {
"$defs": {
"ReferenceMediaInput": {
"additionalProperties": false,
"properties": {
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"reference_video": {
"type": "object"
}
},
"required": [
"reference_video"
]
},
"then": {
"properties": {
"reference_images": {
"maxItems": 5
}
}
}
}
],
"properties": {
"aspect_ratio": {
"default": "9:16",
"enum": [
"9:16",
"16:9"
],
"type": "string"
},
"duration_seconds": {
"default": 4,
"enum": [
4,
6,
8
],
"type": "integer"
},
"prompt": {
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"reference_images": {
"items": {
"$ref": "#/$defs/ReferenceMediaInput"
},
"maxItems": 7,
"type": "array"
},
"reference_video": {
"anyOf": [
{
"$ref": "#/$defs/ReferenceMediaInput"
},
{
"type": "null"
}
],
"default": null
},
"seed": {
"anyOf": [
{
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Random seed for reproducibility (leave empty for random)."
}
},
"required": [
"prompt"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoEdit Videovideo.edit
seedance-2.5$0.085 per secondMinimum $0.68{
"model": "seedance-2.5",
"defaults": {
"generate_audio": true,
"resolution": "720p"
},
"input_schema": {
"$defs": {
"ReferenceMediaInput": {
"additionalProperties": false,
"properties": {
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"generate_audio": {
"default": true,
"description": "Generate output audio.",
"type": "boolean"
},
"prompt": {
"maxLength": 30000,
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"reference_audio": {
"items": {
"$ref": "#/$defs/ReferenceMediaInput"
},
"maxItems": 10,
"type": "array"
},
"reference_images": {
"items": {
"$ref": "#/$defs/ReferenceMediaInput"
},
"maxItems": 30,
"type": "array"
},
"reference_videos": {
"description": "Additional videos guiding the edit, each 2–30 seconds. Source and references must total at most 30 seconds. The source is submitted first, followed by these references in order.",
"items": {
"$ref": "#/$defs/ReferenceMediaInput"
},
"maxItems": 9,
"type": "array"
},
"resolution": {
"default": "720p",
"description": "Output video resolution.",
"enum": [
"480p",
"720p",
"1080p"
],
"type": "string"
},
"video": {
"$ref": "#/$defs/ReferenceMediaInput",
"description": "Source video to edit, 4–30 seconds. Output inherits its duration and aspect ratio."
}
},
"required": [
"video",
"prompt"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}audioExtract Audiovideo.extract_audio
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {
"bitrate": "192k",
"format": "mp3"
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"bitrate": {
"default": "192k",
"enum": [
"128k",
"192k",
"320k"
],
"type": "string"
},
"format": {
"default": "mp3",
"enum": [
"mp3",
"wav",
"aac"
],
"type": "string"
},
"video": {
"$ref": "#/$defs/ReferenceUrlInput"
}
},
"required": [
"video"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}imageExtract Video Framevideo.extract_frame
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {
"format": "jpg",
"timestamp_seconds": 0
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"format": {
"default": "jpg",
"enum": [
"jpg",
"png",
"webp"
],
"type": "string"
},
"timestamp_seconds": {
"default": 0,
"description": "Frame timestamp in seconds.",
"minimum": 0,
"type": "number"
},
"video": {
"$ref": "#/$defs/ReferenceUrlInput"
}
},
"required": [
"video"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
},
"VideoExtractFrameOutputData": {
"properties": {
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"$ref": "#/$defs/VideoExtractFrameOutputData"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoLip Sync Videovideo.lipsync
sync-lipsync-v3$8.00 per minuteMinimum $0.133333{
"model": "sync-lipsync-v3",
"defaults": {
"sync_mode": "cut_off"
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"audio": {
"$ref": "#/$defs/ReferenceUrlInput"
},
"sync_mode": {
"default": "cut_off",
"description": "How to handle audio and video duration mismatches.",
"enum": [
"cut_off",
"loop",
"bounce",
"silence",
"remap"
],
"type": "string"
},
"video": {
"$ref": "#/$defs/ReferenceUrlInput"
}
},
"required": [
"video",
"audio"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}videoSplit Video Into Scenesvideo.split_scenes
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {
"minimum_scene_length_seconds": 0,
"threshold": 20
},
"input_schema": {
"$defs": {
"ReferenceMediaInput": {
"additionalProperties": false,
"properties": {
"role": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"minimum_scene_length_seconds": {
"default": 0,
"maximum": 60,
"minimum": 0,
"type": "number"
},
"threshold": {
"default": 20,
"maximum": 100,
"minimum": 1,
"type": "number"
},
"video": {
"$ref": "#/$defs/ReferenceMediaInput"
}
},
"required": [
"video"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
},
"SceneRecord": {
"properties": {
"asset_index": {
"minimum": 0,
"type": "integer"
},
"duration_seconds": {
"exclusiveMinimum": 0,
"type": "number"
},
"end_seconds": {
"minimum": 0,
"type": "number"
},
"start_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"asset_index",
"start_seconds",
"end_seconds",
"duration_seconds"
],
"type": "object"
},
"SplitScenesOutputData": {
"properties": {
"fps": {
"exclusiveMinimum": 0,
"type": "number"
},
"scene_count": {
"minimum": 1,
"type": "integer"
},
"scenes": {
"items": {
"$ref": "#/$defs/SceneRecord"
},
"type": "array"
},
"total_frame_count": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"scene_count",
"fps",
"total_frame_count",
"scenes"
],
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"minItems": 1,
"type": "array"
},
"data": {
"$ref": "#/$defs/SplitScenesOutputData"
}
},
"required": [
"assets",
"data"
],
"type": "object"
}videoTrim Videovideo.trim
Omit model$0.00 per operationMinimum $0.00{
"model": null,
"defaults": {
"start_seconds": 0
},
"input_schema": {
"$defs": {
"ReferenceUrlInput": {
"additionalProperties": false,
"properties": {
"url": {
"format": "uri",
"minLength": 1,
"pattern": "^https://(?:\\[[0-9A-Fa-f:.]+\\]|[^@\\s/:?#]+)(?::443)?(?:[/?#]|$)",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"end_seconds": {
"description": "End timestamp in seconds.",
"minimum": 0,
"type": "number"
},
"start_seconds": {
"default": 0,
"description": "Start timestamp in seconds.",
"minimum": 0,
"type": "number"
},
"video": {
"$ref": "#/$defs/ReferenceUrlInput"
}
},
"required": [
"video",
"end_seconds"
],
"type": "object"
}
}{
"$defs": {
"PublicAsset": {
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"id": {
"type": "string"
},
"mime_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"type": {
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"type": "string"
}
},
"required": [
"id",
"type",
"url"
],
"type": "object"
},
"VideoTrimOutputData": {
"properties": {
"duration_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
}
},
"properties": {
"assets": {
"items": {
"$ref": "#/$defs/PublicAsset"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"data": {
"anyOf": [
{
"$ref": "#/$defs/VideoTrimOutputData"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"assets"
],
"type": "object"
}03
Guide coverage
image.createmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingimage.editmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingsocial.searchmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.add_audiomodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.concatmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.createmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.editmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.extract_audiomodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.extract_framemodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.lipsyncmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billingvideo.split_scenesmodels, estimate, create and monitor, cancel and retry, billing and usage, errors and manual reviewmodels, statuses, errors, billing