{"openapi":"3.1.0","info":{"title":"Scenetra API","version":"1.0.0","description":"Run 50+ AI image and video models over one REST API. Every request is priced across the providers that serve the model and runs on the cheapest one that supports your settings, billed in credits at provider cost. Generation is async: submit, then poll the run (or pass callbackUrl). Failed runs are refunded automatically.","contact":{"email":"hello@scenetra.com","url":"https://www.scenetra.com"}},"servers":[{"url":"https://app.scenetra.com/api/v1"}],"security":[{"bearerAuth":[]}],"externalDocs":{"description":"Model pages with pricing and code samples","url":"https://www.scenetra.com/models"},"paths":{"/models":{"get":{"operationId":"listModels","summary":"List API-enabled models","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["image","video","audio"]}}],"responses":{"200":{"description":"Model catalog","content":{"application/json":{"schema":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/ModelSummary"}}}}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/models/{modelId}":{"get":{"operationId":"getModel","summary":"A model's request contract (inputs, outputs, pricing)","parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Model schema","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"model_not_available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/dreamactor-m2.0":{"post":{"operationId":"generate_dreamactor_m2_0","summary":"Generate with DreamActor M2.0","description":"Apply motion, facial expressions, and lip movements from a template video to a human subject image. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 1500 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image","video"],"properties":{"image":{"description":"Input image containing a human subject. Supported formats: JPEG, JPG, PNG. Max size: 4.7 MB. Resolution: 480x480 to 1920x1080.","type":"string","format":"uri","pattern":"^https://"},"video":{"description":"Template video whose motion, facial expressions, and lip movements will be applied to the image subject. Supported formats: MP4, MOV, WebM. Max duration: 30 seconds. Resolution: 200x200 to 2048x1440.","type":"string","format":"uri","pattern":"^https://"},"cut_first_second":{"description":"Whether to crop the first second of the output video (removes the 1-second transition at the beginning).","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/flux-2-pro":{"post":{"operationId":"generate_flux_2_pro","summary":"Generate with Flux 2 Pro","description":"Professional text-to-image generation and image editing with high quality outputs and safety controls. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 25 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional reference images to edit or compose from (up to 8; some providers cap lower). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model infer framing from your inputs where supported.","enum":["auto","1:1","4:3","3:4","16:9","9:16","3:2","2:3"]},"resolution":{"description":"Output resolution tier (1K ≈ 1MP, 2K ≈ 4MP).","enum":["1K","2K"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/flux-3-draft-i2v":{"post":{"operationId":"generate_flux_3_draft_i2v","summary":"Generate with FLUX 3 Draft Image to Video","description":"Fast, low-cost FLUX 3 draft previews from an image (720p) — iterate cheaply, then switch the node to FLUX 3 for the full-quality final. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 300 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, and any audio you want. Plain language works — the prompt is interpreted and expanded before generation.","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (5-20)","enum":["5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20"]},"resolution":{"description":"Output resolution.","enum":["720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","2:1","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Generate synchronized audio (ambient sound, speech, effects). Off for a silent clip.","enum":["false","true"]},"safety_tolerance":{"description":"Moderation strictness, 0 (strictest) to 4 (most permissive). Runs with image inputs are capped at 2 by the model.","enum":["0","1","2","3","4"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/flux-3-draft-t2v":{"post":{"operationId":"generate_flux_3_draft_t2v","summary":"Generate with FLUX 3 Draft Text to Video","description":"Fast, low-cost FLUX 3 draft previews (720p) — iterate cheaply, then switch the node to FLUX 3 for the full-quality final. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 300 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, and any audio you want. Plain language works — the prompt is interpreted and expanded before generation.","type":"string"},"duration":{"description":"Duration of the video in seconds (5-20)","enum":["5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20"]},"resolution":{"description":"Output resolution.","enum":["720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","2:1","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Generate synchronized audio (ambient sound, speech, effects). Off for a silent clip.","enum":["false","true"]},"safety_tolerance":{"description":"Moderation strictness, 0 (strictest) to 4 (most permissive). Runs with image inputs are capped at 2 by the model.","enum":["0","1","2","3","4"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/flux-3-i2v":{"post":{"operationId":"generate_flux_3_i2v","summary":"Generate with FLUX 3 Image to Video","description":"Animate an image into video with synchronized audio using FLUX 3 by Black Forest Labs — optionally pin a last frame for exact transitions. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 850 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, and any audio you want. Plain language works — the prompt is interpreted and expanded before generation.","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (5-20)","enum":["5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20"]},"resolution":{"description":"Output resolution.","enum":["720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","2:1","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Generate synchronized audio (ambient sound, speech, effects). Off for a silent clip.","enum":["false","true"]},"safety_tolerance":{"description":"Moderation strictness, 0 (strictest) to 4 (most permissive). Runs with image inputs are capped at 2 by the model.","enum":["0","1","2","3","4"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/flux-3-t2v":{"post":{"operationId":"generate_flux_3_t2v","summary":"Generate with FLUX 3 Text to Video","description":"Generate video with synchronized audio from text using FLUX 3 by Black Forest Labs — 5-20 seconds, native audio, director-level prompting. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 850 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, and any audio you want. Plain language works — the prompt is interpreted and expanded before generation.","type":"string"},"duration":{"description":"Duration of the video in seconds (5-20)","enum":["5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20"]},"resolution":{"description":"Output resolution.","enum":["720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","2:1","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Generate synchronized audio (ambient sound, speech, effects). Off for a silent clip.","enum":["false","true"]},"safety_tolerance":{"description":"Moderation strictness, 0 (strictest) to 4 (most permissive). Runs with image inputs are capped at 2 by the model.","enum":["0","1","2","3","4"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-1.2-flash-edit":{"post":{"operationId":"generate_gemini_omni_1_2_flash_edit","summary":"Generate with Gemini Omni 1.2 Flash Video Edit","description":"Edit an existing video (up to 15s) with a simple text instruction using Gemini Omni 1.2 Flash — output keeps the source's length and framing. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 360 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","video_url"],"properties":{"prompt":{"description":"Describe the change. Keep it simple; add \"Keep everything else the same.\" to preserve the rest of the scene.","type":"string"},"video_url":{"description":"Source video to edit (up to 15 seconds). Output keeps its length and framing.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"360p is a fast, cheap draft; 720p is native; 1080p and 4k upscale the render.","enum":["360p","720p","1080p","4k"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-1.2-flash-extend":{"post":{"operationId":"generate_gemini_omni_1_2_flash_extend","summary":"Generate with Gemini Omni 1.2 Flash Video Extend","description":"Continue an existing video by 3 to 10 seconds with Gemini Omni 1.2 Flash — the continuation follows on from its last moments. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 666 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","video_url"],"properties":{"prompt":{"description":"Describe what happens next. The continuation follows on from the last seconds of the source.","type":"string"},"video_url":{"description":"Source video to continue (up to 15 seconds).","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Seconds of new video to add after the source (3-10).","enum":["3","4","5","6","7","8","9","10"]},"resolution":{"description":"360p is a fast, cheap draft; 720p is native; 1080p and 4k upscale the render.","enum":["360p","720p","1080p","4k"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-1.2-flash-i2v":{"post":{"operationId":"generate_gemini_omni_1_2_flash_i2v","summary":"Generate with Gemini Omni 1.2 Flash Image to Video","description":"Animate a first frame — optionally into a last frame — with native audio using Gemini Omni 1.2 Flash, 3 to 15 seconds. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 360 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style — and the audio: dialogue, music and sound effects are rendered natively and directed through this prompt.","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image — the video moves from the first frame to this one (duration up to 10s).","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (3-15; up to 10 with a last frame).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"360p is a fast, cheap draft; 720p is native; 1080p and 4k upscale the render.","enum":["360p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-1.2-flash-ref2v":{"post":{"operationId":"generate_gemini_omni_1_2_flash_ref2v","summary":"Generate with Gemini Omni 1.2 Flash Reference to Video","description":"Generate video from reference images and short clips with Gemini Omni 1.2 Flash — keep characters, products and style consistent, with native audio. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 360 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the result and how the references should be used (characters, products, style, motion). Audio is rendered natively and directed through this prompt.","type":"string"},"reference_images":{"description":"Up to 6 reference images for characters, products, style or scene (some providers accept up to 10).","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 3 short reference clips (3s or less each; only 1 for videos over 10s) for motion, camera or subject. Their audio is ignored.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (3-15; up to 10 with a last frame).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"360p is a fast, cheap draft; 720p is native; 1080p and 4k upscale the render.","enum":["360p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-1.2-flash-t2v":{"post":{"operationId":"generate_gemini_omni_1_2_flash_t2v","summary":"Generate with Gemini Omni 1.2 Flash Text to Video","description":"Generate 3-15 second videos with native audio from text using Google's Gemini Omni 1.2 Flash — 360p drafts up to 4K, dialogue, music and SFX directed through the prompt. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 360 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style — and the audio: dialogue, music and sound effects are rendered natively and directed through this prompt.","type":"string"},"duration":{"description":"Duration of the video in seconds (3-15; up to 10 with a last frame).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"360p is a fast, cheap draft; 720p is native; 1080p and 4k upscale the render.","enum":["360p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-flash-edit":{"post":{"operationId":"generate_gemini_omni_flash_edit","summary":"Generate with Gemini Omni Flash Video Edit","description":"Edit an existing video (up to 10s) with a simple text instruction using Gemini Omni Flash — output keeps the source's length, framing and audio. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 1076 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","video_url"],"properties":{"prompt":{"description":"Describe the scene, action, camera, style — and the audio: dialogue, music and sound effects are rendered natively and directed purely through this prompt.","type":"string"},"video_url":{"description":"Source video to edit (up to 10 seconds). Output length and aspect follow this video. Keep prompts simple; add \"Keep everything else the same.\" to preserve the rest of the scene.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"720p is native; 1080p and 4k upscale the 720p render (1080p at no extra cost).","enum":["720p","1080p","4k"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-flash-i2v":{"post":{"operationId":"generate_gemini_omni_flash_i2v","summary":"Generate with Gemini Omni Flash Image to Video","description":"Animate a first-frame image into video with native audio using Gemini Omni Flash. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 525 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera, style — and the audio: dialogue, music and sound effects are rendered natively and directed purely through this prompt.","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (3-10)","enum":["3","4","5","6","7","8","9","10"]},"resolution":{"description":"720p is native; 1080p and 4k upscale the 720p render (1080p at no extra cost).","enum":["720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-flash-ref2v":{"post":{"operationId":"generate_gemini_omni_flash_ref2v","summary":"Generate with Gemini Omni Flash Reference to Video","description":"Generate video from up to 10 reference images with Gemini Omni Flash — keep subjects, products and style consistent, with native audio. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the result and how the reference images should be used (subjects, style, composition). Audio is rendered natively and directed through this prompt.","type":"string"},"image_urls":{"description":"Up to 10 reference images for subjects, products, style or composition.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (3-10)","enum":["3","4","5","6","7","8","9","10"]},"resolution":{"description":"720p is native; 1080p and 4k upscale the 720p render (1080p at no extra cost).","enum":["720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gemini-omni-flash-t2v":{"post":{"operationId":"generate_gemini_omni_flash_t2v","summary":"Generate with Gemini Omni Flash Text to Video","description":"Generate 3-10 second videos with native audio from text using Gemini Omni Flash — dialogue, music and SFX directed purely through the prompt. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera, style — and the audio: dialogue, music and sound effects are rendered natively and directed purely through this prompt.","type":"string"},"duration":{"description":"Duration of the video in seconds (3-10)","enum":["3","4","5","6","7","8","9","10"]},"resolution":{"description":"720p is native; 1080p and 4k upscale the 720p render (1080p at no extra cost).","enum":["720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gpt-image-2":{"post":{"operationId":"generate_gpt_image_2","summary":"Generate with GPT Image 2","description":"OpenAI's most advanced image generation model with transparent backgrounds, quality control, and multi-image input support. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 30 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or use as reference (up to 10). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution tier.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose, and is only available at 1K.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"quality":{"description":"Rendering quality. Low is a fast draft, high is the premium tier — the price difference between them is large.","enum":["low","medium","high"]},"background":{"description":"Transparent requires a PNG output. Auto lets the model decide.","enum":["auto","transparent","opaque"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gpt-image-25-flare":{"post":{"operationId":"generate_gpt_image_25_flare","summary":"Generate with GPT Image 2.5 Flare","description":"OpenAI's fast everyday image model — five quality tiers up to Max, resolutions up to 4K, transparent backgrounds and up to 16 reference images, with lower latency than Sunburst. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 11 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or use as reference (up to 16). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution tier.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"quality":{"description":"Rendering quality. Low is a fast draft; xhigh and max push detail for final assets — the price difference is large.","enum":["low","medium","high","xhigh","max"]},"background":{"description":"Transparent requires a PNG or WebP output. Auto lets the model decide.","enum":["auto","transparent","opaque"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg","webp"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gpt-image-25-sunburst":{"post":{"operationId":"generate_gpt_image_25_sunburst","summary":"Generate with GPT Image 2.5 Sunburst","description":"OpenAI's precision image model — five quality tiers up to Max, resolutions up to 4K, transparent backgrounds and up to 16 reference images for exact, instruction-following edits. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 11 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or use as reference (up to 16). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution tier.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"quality":{"description":"Rendering quality. Low is a fast draft; xhigh and max push detail for final assets — the price difference is large.","enum":["low","medium","high","xhigh","max"]},"background":{"description":"Transparent requires a PNG or WebP output. Auto lets the model decide.","enum":["auto","transparent","opaque"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg","webp"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gpt-image-26-flare":{"post":{"operationId":"generate_gpt_image_26_flare","summary":"Generate with GPT Image 2.6 Flare","description":"OpenAI's fast image model with animated GIF and SVG vector output — five quality tiers up to Max, resolutions up to 4K, transparent backgrounds and up to 16 reference images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 30 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or use as reference (up to 16). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution tier.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"quality":{"description":"Rendering quality. Low is a fast draft; xhigh and max push detail for final assets — the price difference is large.","enum":["low","medium","high","xhigh","max"]},"background":{"description":"Transparent requires PNG, WebP or SVG output (not JPEG or GIF). Auto lets the model decide.","enum":["auto","transparent","opaque"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"File type of the result. GIF returns a short looping animation; SVG returns an editable vector file.","enum":["png","jpeg","webp","gif","svg"]},"complexity":{"description":"How much the model plans before rendering. Higher helps dense text and complex layouts; no extra cost.","enum":["low","medium","high"]},"frame_count":{"description":"Number of frames in the animated GIF: 2-8 share one frame size and price; 16 gives smoother motion with smaller frames.","enum":["2","3","4","5","6","7","8","16"]},"frame_duration_ms":{"description":"How long each GIF frame shows, in milliseconds (20-2000).","type":"number","minimum":20,"maximum":2000},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/gpt-image-26-sunburst":{"post":{"operationId":"generate_gpt_image_26_sunburst","summary":"Generate with GPT Image 2.6 Sunburst","description":"OpenAI's precision image model with animated GIF and SVG vector output — five quality tiers up to Max, resolutions up to 4K, transparent backgrounds and up to 16 reference images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 30 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or use as reference (up to 16). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution tier.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"quality":{"description":"Rendering quality. Low is a fast draft; xhigh and max push detail for final assets — the price difference is large.","enum":["low","medium","high","xhigh","max"]},"background":{"description":"Transparent requires PNG, WebP or SVG output (not JPEG or GIF). Auto lets the model decide.","enum":["auto","transparent","opaque"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"File type of the result. GIF returns a short looping animation; SVG returns an editable vector file.","enum":["png","jpeg","webp","gif","svg"]},"complexity":{"description":"How much the model plans before rendering. Higher helps dense text and complex layouts; no extra cost.","enum":["low","medium","high"]},"frame_count":{"description":"Number of frames in the animated GIF: 2-8 share one frame size and price; 16 gives smoother motion with smaller frames.","enum":["2","3","4","5","6","7","8","16"]},"frame_duration_ms":{"description":"How long each GIF frame shows, in milliseconds (20-2000).","type":"number","minimum":20,"maximum":2000},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/grok-image-2":{"post":{"operationId":"generate_grok_image_2","summary":"Generate with Grok Imagine 2","description":"xAI's Grok Imagine Image 2.0 — fast, expressive image generation and single-image editing with quality tiers up to 2K. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 40 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input image.","type":"string"},"image_urls":{"description":"Optional input image to edit (this model edits ONE image). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model infer framing where supported.","enum":["auto","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"resolution":{"description":"Output resolution tier.","enum":["1k","2k"]},"quality":{"description":"Generation quality — 'medium' produces the best results, 'low' is faster and cheaper.","enum":["low","medium"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/grok-imagine-video-1.5-i2v":{"post":{"operationId":"generate_grok_imagine_video_1_5_i2v","summary":"Generate with Grok Imagine Video 1.5","description":"Animate an image into a video using xAI Grok Imagine Video v1.5. Audio is generated alongside at no extra cost. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 135 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image_url"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"image_url":{"description":"Starting frame — the video animates from this image.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"duration":{"description":"Length of the generated video in seconds (1-15).","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/grok-imagine-video-1.5-ref2v":{"post":{"operationId":"generate_grok_imagine_video_1_5_ref2v","summary":"Generate with Grok Imagine Video 1.5 References","description":"Generate video from up to 7 reference images with xAI Grok Imagine Video 1.5 — consistent people, objects and styles. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 72 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","reference_image_urls"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"reference_image_urls":{"description":"1-7 reference images contributing people, objects, or styles. Cite them in the prompt as @Image1, @Image2, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt.","enum":["auto","16:9","4:3","3:2","1:1","2:3","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (1-15).","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/grok-imagine-video-1.5-t2v":{"post":{"operationId":"generate_grok_imagine_video_1_5_t2v","summary":"Generate with Grok Imagine Video 1.5","description":"Generate video with native synchronized audio from a text prompt using xAI Grok Imagine Video 1.5. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 135 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose from your prompt.","enum":["auto","16:9","4:3","3:2","1:1","2:3","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (1-15).","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/happy-horse-1.1-i2v":{"post":{"operationId":"generate_happy_horse_1_1_i2v","summary":"Generate with Happy Horse 1.1 Image to Video","description":"Animate a first-frame image into video with native audio using Happy Horse 1.1 — output keeps the image's aspect ratio. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 725 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional prompt guiding the motion, style and audio of the animation.","type":"string"},"image":{"description":"First-frame image. The video starts from this image and keeps its aspect ratio. JPEG/PNG/WEBP, at least 300px per side, up to 20MB.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (3-15)","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 1080p is the model's default; 480p is the budget rung.","enum":["480p","720p","1080p"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/happy-horse-1.1-ref2v":{"post":{"operationId":"generate_happy_horse_1_1_ref2v","summary":"Generate with Happy Horse 1.1 Reference to Video","description":"Generate video from up to 9 reference images with Happy Horse 1.1 — cite them in the prompt as [Image 1], [Image 2], with native audio. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 725 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video and reference your images positionally: \"the woman in [Image 1] wearing the jacket from [Image 2]\". Audio is generated natively.","type":"string"},"images":{"description":"1-9 reference images for subjects, products or style. Address them in the prompt positionally: [Image 1], [Image 2], … JPEG/PNG/WEBP, shortest side ≥ 400px, up to 20MB each.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (3-15)","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 1080p is the model's default; 480p is the budget rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","9:21","21:9"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/happy-horse-1.1-t2v":{"post":{"operationId":"generate_happy_horse_1_1_t2v","summary":"Generate with Happy Horse 1.1 Text to Video","description":"Generate 3-15 second videos with native audio from text using Happy Horse 1.1 — nine aspect ratios from 9:21 to 21:9. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 725 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style. Audio (dialogue, music, SFX) is generated natively and directed through this prompt.","type":"string"},"duration":{"description":"Duration of the video in seconds (3-15)","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 1080p is the model's default; 480p is the budget rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","9:21","21:9"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-4-i2v":{"post":{"operationId":"generate_kling_4_i2v","summary":"Generate with Kling 4.0 Image to Video","description":"Animate a first frame into cinematic video with native audio using Kling 4.0 — add keyframes and a last frame to pin up to 10 moments in one 3-30 second shot. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 600 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","first_frame_url"],"properties":{"prompt":{"description":"Describe the motion between frames. Cite frames as @first_frame, @keyframe_1, @keyframe_2, … and @last_frame; every cited frame must be attached.","type":"string"},"first_frame_url":{"description":"First frame — the video starts from this image. Cite as @first_frame.","type":"string","format":"uri","pattern":"^https://"},"keyframe_urls":{"description":"Up to 8 keyframes between the first and last frame, in timeline order. Cite as @keyframe_1, @keyframe_2, … Total frames are capped by duration (4 at 3s, up to 10 from 9s).","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"last_frame_url":{"description":"Optional last frame — the video ends on this image. Cite as @last_frame.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"Output resolution.","enum":["720p","1080p"]},"duration":{"description":"Length of the generated video in seconds (3-30).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-4-ref2v":{"post":{"operationId":"generate_kling_4_ref2v","summary":"Generate with Kling 4.0 References","description":"Generate video with Kling 4.0 from reference images and videos — consistent characters and objects, motion or camera work copied from a clip. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 600 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video. Cite reference images as @image_1, @image_2, … and reference videos as @video_1, @video_2, … in upload order; every cited reference must be attached.","type":"string"},"reference_image_urls":{"description":"Up to 10 reference images for characters, objects or style. Cite in the prompt as @image_1, @image_2, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_video_urls":{"description":"Up to 5 reference clips (2-30s each, 30s combined) for motion, choreography or camera work. Cite as @video_1, @video_2, … Their length is billed.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution.","enum":["720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' follows your references (16:9 without any).","enum":["auto","16:9","9:16","1:1","21:9"]},"duration":{"description":"Length of the generated video in seconds (3-30).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"keep_original_sound":{"description":"Keep the reference videos' own audio. Without reference videos, Kling always generates native audio.","enum":["true","false"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-4-t2v":{"post":{"operationId":"generate_kling_4_t2v","summary":"Generate with Kling 4.0","description":"Generate cinematic video with native audio from a text prompt using Kling 4.0 — 3 to 30 seconds at 720p or 1080p, including 21:9. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 600 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, setting, camera work — and the sound you want to hear (Kling 4.0 generates native audio).","type":"string"},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1","21:9"]},"resolution":{"description":"Output resolution.","enum":["720p","1080p"]},"duration":{"description":"Length of the generated video in seconds (3-30).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-motion-control-pro":{"post":{"operationId":"generate_kling_v3_motion_control_pro","summary":"Generate with Kling 3.0 Motion Control Pro","description":"Make a character copy the moves from a video, in 1080p, with Kling 3.0 Motion Control Pro. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 3600 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image_url","video_url"],"properties":{"prompt":{"description":"Optional: describe the scene or the look. Max 2500 characters.","type":"string"},"image_url":{"description":"The character to animate. Clear head, shoulders and torso; JPG/PNG, min 340px, aspect ratio 2:5 to 5:2.","type":"string","format":"uri","pattern":"^https://"},"video_url":{"description":"The movement to copy. MP4/MOV, 3-30 seconds (10 seconds max when the character follows the image). Billed per second of this video.","type":"string","format":"uri","pattern":"^https://"},"character_orientation":{"description":"'video': the character faces as the person in the motion video (up to 30s). 'image': keeps the pose of the character image (up to 10s).","enum":["video","image"]},"keep_original_sound":{"description":"Keep the motion video's audio in the result.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-motion-control-standard":{"post":{"operationId":"generate_kling_v3_motion_control_standard","summary":"Generate with Kling 3.0 Motion Control","description":"Make a character copy the moves from a video, in 720p, with Kling 3.0 Motion Control. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 2100 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image_url","video_url"],"properties":{"prompt":{"description":"Optional: describe the scene or the look. Max 2500 characters.","type":"string"},"image_url":{"description":"The character to animate. Clear head, shoulders and torso; JPG/PNG, min 340px, aspect ratio 2:5 to 5:2.","type":"string","format":"uri","pattern":"^https://"},"video_url":{"description":"The movement to copy. MP4/MOV, 3-30 seconds (10 seconds max when the character follows the image). Billed per second of this video.","type":"string","format":"uri","pattern":"^https://"},"character_orientation":{"description":"'video': the character faces as the person in the motion video (up to 30s). 'image': keeps the pose of the character image (up to 10s).","enum":["video","image"]},"keep_original_sound":{"description":"Keep the motion video's audio in the result.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-pro":{"post":{"operationId":"generate_kling_v3_pro","summary":"Generate with Kling 3.0 Pro","description":"Generate 1080p cinematic video with native audio (lip-synced dialogue, ambience) from a text prompt using Kling 3.0 Pro. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work — and dialogue or sound direction when audio is enabled.","type":"string"},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1"]},"duration":{"description":"Length of the generated video in seconds (3-15).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"generate_audio":{"description":"Native audio: lip-synced dialogue, ambience and sound effects. A real billing rung — adds ~50% to the per-second price.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-pro-i2v":{"post":{"operationId":"generate_kling_v3_pro_i2v","summary":"Generate with Kling 3.0 Pro","description":"Animate a still image into 1080p cinematic video with native audio using Kling 3.0 Pro. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 450 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image_url"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work — and dialogue or sound direction when audio is enabled.","type":"string"},"image_url":{"description":"Starting frame — the video animates from this image.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Length of the generated video in seconds (3-15).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"generate_audio":{"description":"Native audio: lip-synced dialogue, ambience and sound effects. A real billing rung — adds ~50% to the per-second price.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-standard":{"post":{"operationId":"generate_kling_v3_standard","summary":"Generate with Kling 3.0 Standard","description":"Generate cinematic video with native audio (lip-synced dialogue, ambience) from a text prompt using Kling 3.0 Standard. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 300 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work — and dialogue or sound direction when audio is enabled.","type":"string"},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1"]},"duration":{"description":"Length of the generated video in seconds (3-15).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"generate_audio":{"description":"Native audio: lip-synced dialogue, ambience and sound effects. A real billing rung — adds ~50% to the per-second price.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/kling-v3-standard-i2v":{"post":{"operationId":"generate_kling_v3_standard_i2v","summary":"Generate with Kling 3.0 Standard","description":"Animate a still image into cinematic video with native audio using Kling 3.0 Standard. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 350 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image_url"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work — and dialogue or sound direction when audio is enabled.","type":"string"},"image_url":{"description":"Starting frame — the video animates from this image.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Length of the generated video in seconds (3-15).","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"generate_audio":{"description":"Native audio: lip-synced dialogue, ambience and sound effects. A real billing rung — adds ~50% to the per-second price.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/krea-2-large":{"post":{"operationId":"generate_krea_2_large","summary":"Generate with Krea 2 Large","description":"Krea 2 Large — Krea's flagship foundation image model, strongest at photorealism and rich, expressive styles, with optional style-reference images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 60 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate.","type":"string"},"style_reference_images":{"description":"Optional reference images (up to 10) whose STYLE is transferred to the output — they guide the look, not the content. Adding any costs slightly more on most providers.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image.","enum":["1:1","4:3","3:2","16:9","2.35:1","4:5","2:3","9:16"]},"creativity":{"description":"How loosely the model interprets the prompt — 'raw' renders only what you describe, 'high' takes real creative liberty.","enum":["raw","low","medium","high"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/krea-2-medium":{"post":{"operationId":"generate_krea_2_medium","summary":"Generate with Krea 2 Medium","description":"Krea 2 Medium — fast, expressive image generation from Krea's foundation model, tuned for illustration, anime and painterly styles, with optional style-reference images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 30 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate.","type":"string"},"style_reference_images":{"description":"Optional reference images (up to 10) whose STYLE is transferred to the output — they guide the look, not the content. Adding any costs slightly more on most providers.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image.","enum":["1:1","4:3","3:2","16:9","2.35:1","4:5","2:3","9:16"]},"creativity":{"description":"How loosely the model interprets the prompt — 'raw' renders only what you describe, 'high' takes real creative liberty.","enum":["raw","low","medium","high"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/krea-3":{"post":{"operationId":"generate_krea_3","summary":"Generate with Krea 3","description":"Krea 3 — Krea's instruction-following image model. Generates images from text, or edits and combines up to 8 input images from a plain-language instruction, at 1K or 2K. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 60 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to make. For edits, say what should change and what should stay the same.","type":"string"},"image_urls":{"description":"Optional images to edit or combine (up to 8). Leave empty for text-to-image. Each input image adds to the price.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the output. 'Auto' lets the model pick the framing from your input images and prompt.","enum":["auto","1:1","4:5","3:4","2:3","9:16","5:4","4:3","3:2","16:9","21:9"]},"resolution":{"description":"Output resolution (1K ≈ 1MP, 2K ≈ 4MP).","enum":["1K","2K"]},"thinking_mode":{"description":"How much planning happens before generation. 'Fast' suits most requests; 'High' plans complex or multi-step edits more carefully, is slower and costs more.","enum":["fast","high"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/minimax-h3-i2v":{"post":{"operationId":"generate_minimax_h3_i2v","summary":"Generate with MiniMax H3 Image to Video","description":"Animate a first frame (optionally pinning a last frame) into video with native audio using MiniMax H3 (Hailuo 03). Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 325 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, visual style, dialogue, music and sound effects — H3 renders audio natively.","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (5-15)","enum":["5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"768P is native; 2K and 4K upscale a 768P base render.","enum":["768P","2K","4K"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/minimax-h3-ref2v":{"post":{"operationId":"generate_minimax_h3_ref2v","summary":"Generate with MiniMax H3 Reference to Video","description":"Generate video from up to 9 reference images, 3 videos and 3 audio tracks with MiniMax H3 — keep subjects consistent and sync motion to a beat. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 325 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the result and cite reference inputs in order: Image 1, Video 1, Audio 1, and so on. Audio (dialogue, music, SFX) is rendered natively.","type":"string"},"reference_image_urls":{"description":"Up to 9 reference images for subjects, products, style or composition. Cite in prompt as Image 1, Image 2, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_video_urls":{"description":"Up to 3 reference clips (2-15s each, combined ≤ 15s) for motion, pacing or editing rhythm. Cite as Video 1, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audio_urls":{"description":"Up to 3 audio tracks (2-15s each, combined ≤ 15s) to sync motion, voice or music. Needs at least one image or video reference alongside. Cite as Audio 1, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (5-15)","enum":["5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"768P is native; 2K and 4K upscale a 768P base render.","enum":["768P","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' follows the reference media.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/minimax-h3-t2v":{"post":{"operationId":"generate_minimax_h3_t2v","summary":"Generate with MiniMax H3 Text to Video","description":"Generate 4-15 second videos with native stereo audio from text using MiniMax H3 (Hailuo 03) — dialogue, music and SFX rendered in the same pass. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 325 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera movement, visual style, dialogue, music and sound effects — H3 renders audio natively.","type":"string"},"duration":{"description":"Duration of the video in seconds (5-15)","enum":["5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"768P is native; 2K and 4K upscale a 768P base render.","enum":["768P","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["21:9","16:9","4:3","1:1","3:4","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/nano-banana":{"post":{"operationId":"generate_nano_banana","summary":"Generate with Nano Banana","description":"Fast image generation and editing. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 39 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional input images to edit or use as reference (up to 14). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/nano-banana-2":{"post":{"operationId":"generate_nano_banana_2","summary":"Generate with Nano Banana 2","description":"Fast image generation optimized for speed with resolution up to 4K. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 40 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional input images to edit or use as reference (up to 14). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution. 0.5K and 1K are the cheap rungs; 4K is the premium rung.","enum":["0.5K","1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/nano-banana-2-lite":{"post":{"operationId":"generate_nano_banana_2_lite","summary":"Generate with Nano Banana 2 Lite","description":"Fastest, cheapest Nano Banana — ~4 second 1K image generation and editing. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 34 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional input images to edit or use as reference (up to 14; runs with more than 10 skip some providers). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"output_format":{"description":"The format of the generated image. Some providers serve PNG only.","enum":["png","jpeg"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/nano-banana-pro":{"post":{"operationId":"generate_nano_banana_pro","summary":"Generate with Nano Banana Pro","description":"Professional image generation and editing with resolution up to 4K. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 90 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional input images to edit or use as reference (up to 14; runs with more than 8 skip some providers). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution. 1K and 2K share a price everywhere; 4K is the premium rung.","enum":["1K","2K","4K"]},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model choose from your prompt and inputs.","enum":["auto","21:9","16:9","3:2","4:3","5:4","1:1","4:5","3:4","2:3","9:16"]},"num_images":{"description":"How many images to generate (1-4).","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/pixverse-v6-extend":{"post":{"operationId":"generate_pixverse_v6_extend","summary":"Generate with PixVerse v6 Video Extend","description":"Extend an existing video with PixVerse v6 — the continuation picks up from the last frame; billed only on the new seconds. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 180 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","video_url"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style. With audio enabled, BGM, SFX and dialogue are generated to match.","type":"string"},"video_url":{"description":"Source video to extend (MP4/MOV, up to 30s/50MB). The extension continues from its last frame; you pay only for the new seconds.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the generated video in seconds (1-15; on Extend this is the length of the new extension)","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 720p is the model's default.","enum":["360p","540p","720p","1080p"]},"generate_audio_switch":{"description":"Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/pixverse-v6-i2v":{"post":{"operationId":"generate_pixverse_v6_i2v","summary":"Generate with PixVerse v6 Image to Video","description":"Animate a first-frame image into video with PixVerse v6 — optional synchronized audio and multi-shot sequences. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 180 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style. With audio enabled, BGM, SFX and dialogue are generated to match.","type":"string"},"image":{"description":"First-frame image. JPEG/PNG/WEBP, up to 20MB; output keeps its aspect ratio.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the generated video in seconds (1-15; on Extend this is the length of the new extension)","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 720p is the model's default.","enum":["360p","540p","720p","1080p"]},"generate_audio_switch":{"description":"Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge.","enum":["false","true"],"default":"false"},"generate_multi_clip_switch":{"description":"Generate a multi-shot sequence with scene transitions and dynamic camera changes in one pass.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/pixverse-v6-ref2v":{"post":{"operationId":"generate_pixverse_v6_ref2v","summary":"Generate with PixVerse v6 Reference to Video","description":"Generate video from up to 7 reference images with PixVerse v6 — bind characters, objects and scenes in the prompt as @image1, @image2. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 203 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video and bind your references by upload order: \"@image1 walks through @image2\". With audio enabled, sound is generated to match.","type":"string"},"images":{"description":"1-7 reference images for characters, objects or scenes. Bind them in the prompt as @image1, @image2, … (in upload order).","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the generated video in seconds (1-15; on Extend this is the length of the new extension)","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 720p is the model's default.","enum":["360p","540p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","4:3","1:1","3:4","9:16","2:3","3:2","21:9"]},"generate_audio_switch":{"description":"Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/pixverse-v6-t2v":{"post":{"operationId":"generate_pixverse_v6_t2v","summary":"Generate with PixVerse v6 Text to Video","description":"Generate 1-15 second videos from text with PixVerse v6 — optional synchronized audio and multi-shot sequences, eight aspect ratios. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 180 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style. With audio enabled, BGM, SFX and dialogue are generated to match.","type":"string"},"duration":{"description":"Duration of the generated video in seconds (1-15; on Extend this is the length of the new extension)","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 720p is the model's default.","enum":["360p","540p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video.","enum":["16:9","4:3","1:1","3:4","9:16","2:3","3:2","21:9"]},"generate_audio_switch":{"description":"Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge.","enum":["false","true"],"default":"false"},"generate_multi_clip_switch":{"description":"Generate a multi-shot sequence with scene transitions and dynamic camera changes in one pass.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/pixverse-v6-transition":{"post":{"operationId":"generate_pixverse_v6_transition","summary":"Generate with PixVerse v6 Transition","description":"Generate a video that transitions from a first-frame image to a last-frame image with PixVerse v6. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 180 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image","end_image"],"properties":{"prompt":{"description":"Describe the scene, action, camera and style. With audio enabled, BGM, SFX and dialogue are generated to match.","type":"string"},"image":{"description":"First-frame image. JPEG/PNG/WEBP, up to 20MB; output keeps its aspect ratio.","type":"string","format":"uri","pattern":"^https://"},"end_image":{"description":"Last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the generated video in seconds (1-15; on Extend this is the length of the new extension)","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Output resolution. 720p is the model's default.","enum":["360p","540p","720p","1080p"]},"generate_audio_switch":{"description":"Generate synchronized audio (BGM, SFX, dialogue). Adds a per-second surcharge.","enum":["false","true"],"default":"false"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-flash-i2v":{"post":{"operationId":"generate_seedance_2_5_flash_i2v","summary":"Generate with Seedance2.5 Flash Image to Video","description":"Generate videos up to 30 seconds from a first-frame image (and optional last frame) with synchronized audio using Seedance 2.5 Flash by ByteDance — about 2x faster and cheaper than Seedance 2.5. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 793 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional text prompt describing the desired video motion (recommended).","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-flash-ref2v":{"post":{"operationId":"generate_seedance_2_5_flash_ref2v","summary":"Generate with Seedance2.5 Flash Reference to Video","description":"Generate videos up to 30 seconds from up to 10 reference images, 5 videos and 5 audio files using Seedance 2.5 Flash by ByteDance — about 2x faster and cheaper than Seedance 2.5. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 793 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Optional text prompt. Cite reference inputs in order with @-syntax: @Image1, @Video1, @Audio1.","type":"string"},"reference_images":{"description":"Up to 10 reference images for character/style/scene. Cite in prompt as @Image1, etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 5 reference videos (mp4/mov), each 2-30s, combined ≤ 30s. Cite in prompt as @Video1, etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audios":{"description":"Up to 5 reference audio files (wav/mp3), combined ≤ 30s. Cite in prompt as @Audio1, etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' uses the primary media aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-flash-t2v":{"post":{"operationId":"generate_seedance_2_5_flash_t2v","summary":"Generate with Seedance2.5 Flash Text to Video","description":"Seedance 2.5 Flash by ByteDance: near-flagship Seedance 2.5 quality about 2x faster and cheaper. Up to 30 seconds from text prompts with synchronized audio, 480p or 720p. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 793 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-i2v":{"post":{"operationId":"generate_seedance_2_5_i2v","summary":"Generate with Seedance2.5 Image to Video","description":"Generate videos up to 30 seconds from a first-frame image (and optional last frame) with synchronized audio using Seedance 2.5 by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 1350 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional text prompt describing the desired video motion (recommended).","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-ref2v":{"post":{"operationId":"generate_seedance_2_5_ref2v","summary":"Generate with Seedance2.5 Reference to Video","description":"Generate videos up to 30 seconds from reference images, videos, and audio — audio-only referencing can drive pacing, beats, and lip-sync — using Seedance 2.5 by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 1350 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Optional text prompt. Cite reference inputs in order with @-syntax: @Image1, @Video1, @Audio1.","type":"string"},"reference_images":{"description":"Up to 30 reference images for character/style/scene. Cite in prompt as @Image1, etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 10 reference videos (mp4/mov). Combined duration ≤ 30s. Cite in prompt as @Video1, etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audios":{"description":"Up to 10 reference audio files (wav/mp3), combined ≤ 30s. Audio-only referencing works: one track can drive pacing, beats and lip-sync.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' uses the primary media aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-5-t2v":{"post":{"operationId":"generate_seedance_2_5_t2v","summary":"Generate with Seedance2.5 Text to Video","description":"Generate cinematic videos up to 30 seconds from text prompts with synchronized audio using Seedance 2.5 by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 1156 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"duration":{"description":"Duration of the video in seconds (4-30)","enum":["4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"resolution":{"description":"Video resolution.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-i2v":{"post":{"operationId":"generate_seedance_2_i2v","summary":"Generate with Seedance2 Image to Video","description":"Generate videos from images using Seedance 2.0 by ByteDance. Supports start and end frame images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 900 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional text prompt describing the desired video motion (recommended).","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' matches the first-frame image aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-i2v-fast":{"post":{"operationId":"generate_seedance_2_i2v_fast","summary":"Generate with Seedance2 Fast Image to Video","description":"Faster, lower-cost variant of Seedance 2.0 image-to-video by ByteDance. Supports start and optional end frame. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 620 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional text prompt describing the desired video motion (recommended).","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' matches the first-frame image aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-mini-i2v":{"post":{"operationId":"generate_seedance_2_mini_i2v","summary":"Generate with Seedance2 Mini Image to Video","description":"Generate videos from a first-frame image (and optional last frame) using Seedance 2.0 Mini by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 205 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["image"],"properties":{"prompt":{"description":"Optional text prompt describing the desired video motion (recommended).","type":"string"},"image":{"description":"First-frame image. The video starts from this image.","type":"string","format":"uri","pattern":"^https://"},"last_image":{"description":"Optional last-frame image. The video transitions from the first frame to this one.","type":"string","format":"uri","pattern":"^https://"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' matches the first-frame image aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-mini-ref2v":{"post":{"operationId":"generate_seedance_2_mini_ref2v","summary":"Generate with Seedance2 Mini Reference to Video","description":"Generate videos from reference images, videos, and audio using Seedance 2.0 Mini by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 205 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"reference_images":{"description":"Up to 9 reference images for character/style/scene. Reference in prompt as 'image 1', etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 3 reference videos (mp4/mov) for editing/extension. Total duration ≤ 15s.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audios":{"description":"Up to 3 reference audio files (wav/mp3). Requires at least one reference image or video.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' uses the primary media aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-mini-t2v":{"post":{"operationId":"generate_seedance_2_mini_t2v","summary":"Generate with Seedance2 Mini Text to Video","description":"Generate cinematic videos from text prompts with audio-visual sync using Seedance 2.0 Mini by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 205 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-ref2v":{"post":{"operationId":"generate_seedance_2_ref2v","summary":"Generate with Seedance2 Reference to Video","description":"Generate videos from reference images, videos, and audio using Seedance 2.0 by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 900 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"The text prompt used to generate the video. Reference images as @Image1, @Image2, etc.","type":"string"},"reference_images":{"description":"Up to 9 reference images for character/style/scene. Reference in prompt as 'image 1', etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 3 reference videos (mp4/mov) for editing/extension. Total duration ≤ 15s.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audios":{"description":"Up to 3 reference audio files (wav/mp3). Requires at least one reference image or video.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' uses the primary media aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-ref2v-fast":{"post":{"operationId":"generate_seedance_2_ref2v_fast","summary":"Generate with Seedance2 Fast Reference to Video","description":"Generate videos from reference images, videos, and audio using Seedance 2.0 Fast by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 620 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"reference_images":{"description":"Up to 9 reference images for character/style/scene. Reference in prompt as 'image 1', etc.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_videos":{"description":"Up to 3 reference videos (mp4/mov) for editing/extension. Total duration ≤ 15s.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audios":{"description":"Up to 3 reference audio files (wav/mp3). Requires at least one reference image or video.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio. 'Auto' uses the primary media aspect ratio.","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-t2v":{"post":{"operationId":"generate_seedance_2_t2v","summary":"Generate with Seedance2 Text to Video","description":"Generate cinematic videos from text prompts with audio-visual sync using Seedance 2.0 by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 900 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p","1080p","4k"]},"aspect_ratio":{"description":"Aspect ratio of the generated video","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedance-2-t2v-fast":{"post":{"operationId":"generate_seedance_2_t2v_fast","summary":"Generate with Seedance2 Fast Text to Video","description":"Faster, lower-cost variant of Seedance 2.0 text-to-video by ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 458 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Text prompt describing the video to generate.","type":"string"},"duration":{"description":"Duration of the video in seconds (4-15)","enum":["4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution. Higher resolutions cost more per second.","enum":["480p","720p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"]},"generate_audio":{"description":"Whether to generate synchronized audio (voice, sound effects, music)","enum":["false","true"]},"subject_content":{"description":"What your video contains. Providers differ in what they allow: 'No faces' can unlock lower prices; 'Mature' routes only to providers without content restrictions.","enum":["general","people","mature"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedream45":{"post":{"operationId":"generate_seedream45","summary":"Generate with Seedream 4.5","description":"An upgraded text-to-image generation and image editing model with improved quality from ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 40 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional reference images to edit or compose from (up to 10). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model infer framing from your prompt and inputs.","enum":["auto","21:9","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"resolution":{"description":"Output resolution tier: 2K or 4K. Same price at both tiers.","enum":["2K","4K"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedream55":{"post":{"operationId":"generate_seedream55","summary":"Generate with Seedream 5.5","description":"ByteDance's newest image model: photorealistic generation, edits that stay precise over many rounds, native transparent backgrounds and up to 10 input images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 20 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional images to edit or compose from (up to 10). Leave empty for pure text-to-image. Each input image adds a small fee.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the output image. 'Auto' follows the first input image where supported.","enum":["auto","21:9","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"resolution":{"description":"Output resolution tier. 1K and 1.5K cost the same; 2K costs more.","enum":["1K","1.5K","2K"]},"output_format":{"description":"Image file format. A transparent background needs PNG.","enum":["png","jpeg"]},"background":{"description":"Auto lets the model decide from your prompt. Transparent returns a PNG with an alpha channel (cut-outs, stickers, product shots).","enum":["auto","transparent","opaque"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedream5lite":{"post":{"operationId":"generate_seedream5lite","summary":"Generate with Seedream 5 Lite","description":"Image generation with built-in reasoning, example-based editing, and deep domain knowledge from ByteDance. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 28 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional reference images to edit or compose from (up to 10). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model infer framing from your prompt and inputs where supported.","enum":["auto","21:9","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"resolution":{"description":"Output resolution tier: 2K (basic), 3K (high) or 4K (ultra). 4K runs on fewer providers.","enum":["2K","3K","4K"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/seedream5pro":{"post":{"operationId":"generate_seedream5pro","summary":"Generate with Seedream 5 Pro","description":"ByteDance's most advanced image generation and editing model with high-fidelity output up to 2K and support for up to 10 reference images. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 35 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate, or the edit to apply to the input images.","type":"string"},"image_urls":{"description":"Optional reference images to edit or compose from (up to 10). Leave empty for pure text-to-image.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"aspect_ratio":{"description":"Aspect ratio of the generated image. 'Auto' lets the model infer framing from your prompt and inputs where supported.","enum":["auto","21:9","16:9","3:2","4:3","1:1","3:4","2:3","9:16"]},"resolution":{"description":"Output resolution tier (Seedream's 1K ≈ 2MP, 2K ≈ 4MP).","enum":["1K","2K"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-i2v":{"post":{"operationId":"generate_wan_3_0_i2v","summary":"Generate with Wan 3.0","description":"Animate a still image into up to 30 seconds of video with native synchronized audio using Alibaba Wan 3.0. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image_url"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"image_url":{"description":"Starting frame — the video animates from this image.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-prime-i2v":{"post":{"operationId":"generate_wan_3_0_prime_i2v","summary":"Generate with Wan 3.0 Prime","description":"Animate a still image into up to 30 seconds of video with native synchronized audio using Alibaba Wan 3.0 Prime, the faster Wan 3.0. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 630 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt","image_url"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"image_url":{"description":"Starting frame — the video animates from this image.","type":"string","format":"uri","pattern":"^https://"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-prime-ref2v":{"post":{"operationId":"generate_wan_3_0_prime_ref2v","summary":"Generate with Wan 3.0 Prime References","description":"Generate video from reference images, videos and audio with Alibaba Wan 3.0 Prime, the faster Wan 3.0 — consistent people, objects and styles. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 630 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"reference_image_urls":{"description":"Up to 10 reference images contributing people, objects, or styles. Cite in the prompt as Image 1, Image 2, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_video_urls":{"description":"Up to 5 reference clips (1-15s each, 15s combined) for a subject's look and voice, motion, choreography or camera work. Cite as Video 1, Video 2, … Their length is billed on top of the output, and reference + output must stay within 30s.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audio_urls":{"description":"Up to 5 audio clips (wav/mp3, 1-15s each, 15s combined): a voice or song to lip-sync, dance or time the motion to. Cite as Audio 1, Audio 2, … Free at every seller.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-prime-t2v":{"post":{"operationId":"generate_wan_3_0_prime_t2v","summary":"Generate with Wan 3.0 Prime","description":"Generate up to 30 seconds of video with native synchronized audio in a single take using Alibaba Wan 3.0 Prime, the faster Wan 3.0. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 630 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-ref2v":{"post":{"operationId":"generate_wan_3_0_ref2v","summary":"Generate with Wan 3.0 References","description":"Generate video from up to 10 reference images with Alibaba Wan 3.0 — consistent people, objects and styles. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"reference_image_urls":{"description":"Up to 10 reference images contributing people, objects, or styles. Cite in the prompt as Image 1, Image 2, …","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_video_urls":{"description":"Up to 5 reference clips (1-15s each, 15s combined) for a subject's look and voice, motion, choreography or camera work. Cite as Video 1, Video 2, … Their length is billed on top of the output, and reference + output must stay within 30s.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"reference_audio_urls":{"description":"Up to 5 audio clips (wav/mp3, 1-15s each, 15s combined): a voice or song to lip-sync, dance or time the motion to. Cite as Audio 1, Audio 2, … Free at every seller.","type":"array","items":{"type":"string","format":"uri","pattern":"^https://"}},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/wan-3.0-t2v":{"post":{"operationId":"generate_wan_3_0_t2v","summary":"Generate with Wan 3.0","description":"Generate up to 30 seconds of video with native synchronized audio in a single take using Alibaba Wan 3.0. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 400 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["video"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the video: subject, motion, camera work, and audio direction. Native synchronized audio is generated in the same pass.","type":"string"},"resolution":{"description":"Output resolution. 480p is the budget rung; 1080p is the premium rung.","enum":["480p","720p","1080p"]},"aspect_ratio":{"description":"Aspect ratio of the generated video. 'Auto' lets the model choose the best framing for your prompt.","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"duration":{"description":"Length of the generated video in seconds (2-30). Wan 3.0 generates up to 30 seconds in a single take.","enum":["2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"]},"audio":{"description":"Generate synchronized audio (dialogue, SFX, music) in the same pass. Same price either way; some sellers cannot switch it off, so turning it off can change which seller wins.","enum":["true","false"],"default":"true"},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/generate/z-image-turbo":{"post":{"operationId":"generate_z_image_turbo","summary":"Generate with Z-Image Turbo","description":"A fast text-to-image model with high quality outputs and customizable acceleration. Async: returns a runId immediately; poll GET /runs/{runId}. Each request runs on the cheapest provider that supports its settings, billed in credits at provider cost. About 5 credits at default settings (1 credit = $0.001); ?dryRun=1 prices a request without running it.","tags":["image"],"parameters":[{"name":"dryRun","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"Validate and price the request without creating a run or charging credits."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"description":"Describe the image to generate.","type":"string"},"aspect_ratio":{"description":"Aspect ratio of the generated image.","enum":["1:1","4:3","3:4","16:9","9:16","3:2","2:3"]},"resolution":{"description":"Output resolution tier (1K ≈ 1 megapixel, 2K ≈ 4 megapixels). Billed per megapixel, so 2K costs four times 1K.","enum":["1K","2K"]},"num_images":{"description":"How many images to generate (1-4). Billed per image.","type":"number","minimum":1,"maximum":4},"output_format":{"description":"The format of the generated image.","enum":["png","jpeg"]},"callbackUrl":{"type":"string","format":"uri","pattern":"^https://","description":"Optional. When the run finishes we POST the final run status here once (best effort; polling stays the source of truth)."}}}}}},"responses":{"202":{"description":"Run created (or, with ?dryRun=1, the price estimate).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunCreated"}}}},"400":{"description":"invalid_parameter or missing_parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"insufficient_credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/runs/{runId}":{"get":{"operationId":"getRun","summary":"Poll a run until status is COMPLETED or FAILED","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Run status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Run"}}}},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"run_not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteRun","summary":"Remove a finished run","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deleted"},"401":{"description":"unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"run_not_found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"run_active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal API key (scnk_...), created in Scenetra settings."}},"schemas":{"ModelSummary":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"pricing":{"type":"object","properties":{"display":{"type":"string"},"estimatedCreditsDefault":{"type":"number"}}},"schemaUrl":{"type":"string"}}},"RunCreated":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["PENDING"]},"model":{"type":"string"},"estimatedCredits":{"type":"number","description":"1 credit = $0.001"},"statusUrl":{"type":"string"},"dryRun":{"type":"boolean"}}},"Run":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["PENDING","RUNNING","COMPLETED","FAILED"]},"progress":{"type":"object","properties":{"completed":{"type":"number"},"total":{"type":"number"}}},"outputs":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"error":{"type":["string","null"]},"creditsRefunded":{"type":"boolean"},"estimatedCredits":{"type":"number"},"statusUrl":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"}}},"Error":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true}}}}}}