{"openapi":"3.1.0","info":{"title":"MiniMax H3 Public API","version":"1.1.0","description":"Asynchronous MiniMax H3 video generation funded by paid personal credits. Credits are atomically reserved before remote media is downloaded. Successful outputs are copied to MiniMax H3-managed storage before a task is marked completed.","termsOfService":"https://minimaxh3.studio/terms","contact":{"name":"MiniMax H3 API Support","email":"support@minimaxh3.studio","url":"https://minimaxh3.studio/contact"}},"servers":[{"url":"https://minimaxh3.studio/api/v1"}],"tags":[{"name":"Video","description":"Submit and query video generations."},{"name":"Credits","description":"Read the paid API credit balance."}],"paths":{"/video/generations":{"post":{"operationId":"createVideoGeneration","tags":["Video"],"summary":"Create a video generation task","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"A unique key for this logical request. Reuse only with the identical body.","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-zA-Z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationRequest"}}}},"responses":{"200":{"description":"An identical idempotent request returned its existing task.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTask"}}}},"202":{"description":"A new asynchronous task was accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTask"}}}},"400":{"description":"Invalid request or media.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Insufficient paid credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The idempotency key belongs to another body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"The JSON body exceeds 64 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Per-key rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Generation is temporarily unavailable or provider acceptance is uncertain. Retry only with the same Idempotency-Key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/tasks/{id}":{"get":{"operationId":"getVideoGeneration","tags":["Video"],"summary":"Get a public API video task","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"Current durable task state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTask"}}}},"400":{"description":"Invalid task id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Task not found for this account or API surface.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Per-key rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Task refresh is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/credits":{"get":{"operationId":"getPaidCreditBalance","tags":["Credits"],"summary":"Get paid personal credits available to the API","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Paid balance.","content":{"application/json":{"schema":{"type":"object","required":["available_credits","balance_type"],"properties":{"available_credits":{"type":"integer","minimum":0},"balance_type":{"type":"string","const":"paid"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Per-key rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/models":{"get":{"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current model capabilities or estimate.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"H3 service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"operationId":"listModels","summary":"List supported models and capabilities"}},"/video/estimate":{"post":{"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current model capabilities or estimate.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"H3 service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"operationId":"estimateVideo","summary":"Estimate video credits without downloading media or generating","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationRequest"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_"}},"schemas":{"VideoGenerationRequest":{"oneOf":[{"$ref":"#/components/schemas/LegacyVideoGenerationRequest"},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"minimax-h3"},"mode":{"const":"text-to-video","default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":4,"maximum":15,"default":5},"resolution":{"type":"string","enum":["768p","2k"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"default":"16:9"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode","image_url"],"properties":{"model":{"const":"minimax-h3"},"mode":{"const":"image-to-video","default":"image-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":4,"maximum":15,"default":5},"resolution":{"type":"string","enum":["768p","2k"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["adaptive"],"default":"adaptive"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode"],"properties":{"model":{"const":"minimax-h3"},"mode":{"const":"media-to-video","default":"media-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":4,"maximum":15,"default":5},"resolution":{"type":"string","enum":["768p","2k"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["21:9","16:9","4:3","1:1","3:4","9:16","adaptive"],"default":"adaptive"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"reference_image_urls":{"type":"array","maxItems":9,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":3,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":3,"items":{"type":"integer","minimum":2,"maximum":15},"description":"One rounded-up duration per URL; sum must not exceed 15 seconds. Fully decoded and verified by the server."},"reference_audio_urls":{"type":"array","maxItems":3,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":3,"items":{"type":"integer","minimum":2,"maximum":15},"description":"One rounded-up duration per URL; sum must not exceed 15 seconds. Fully decoded and verified by the server."}},"anyOf":[{"required":["reference_image_urls"],"properties":{"reference_image_urls":{"minItems":1}}},{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}}],"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"anyOf":[{"required":["reference_image_urls"],"properties":{"reference_image_urls":{"minItems":1}}},{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}}]}}],"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"minimax-h3-fast"},"mode":{"const":"text-to-video","default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":1,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","768p"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode","image_url","end_image_url"],"properties":{"model":{"const":"minimax-h3-fast"},"mode":{"const":"image-to-video","default":"image-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":1,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","768p"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode"],"properties":{"model":{"const":"minimax-h3-fast"},"mode":{"const":"media-to-video","default":"media-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":1,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","768p"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"reference_image_urls":{"type":"array","maxItems":9,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":3,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":3,"items":{"type":"integer","minimum":2,"maximum":15},"description":"One rounded-up duration per URL; sum must not exceed 15 seconds. Fully decoded and verified by the server."},"reference_audio_urls":{"type":"array","maxItems":3,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":3,"items":{"type":"integer","minimum":2,"maximum":15},"description":"One rounded-up duration per URL; sum must not exceed 15 seconds. Fully decoded and verified by the server."}},"anyOf":[{"required":["reference_image_urls"],"properties":{"reference_image_urls":{"minItems":1}}},{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}}],"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"properties":{"duration":{"minimum":4},"resolution":{"const":"768p"}}}}],"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"minimax-h3-max"},"mode":{"const":"text-to-video","default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":5,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","768p"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"default":"16:9"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode","image_url"],"properties":{"model":{"const":"minimax-h3-max"},"mode":{"const":"image-to-video","default":"image-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"duration":{"type":"integer","minimum":5,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","768p"],"default":"768p"},"aspect_ratio":{"type":"string","enum":["adaptive"],"default":"adaptive"},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"description":"H3, H3 Fast and H3 Max are available to authenticated API clients; check GET /models for capabilities. Maximum 12 typed references and 256 MiB total. JPEG/PNG/WebP images up to 30 MiB; MP4/MOV videos up to 50 MiB; MP3/WAV audio up to 15 MiB. Images/videos: width and height 256–5760, aspect ratio 0.4–2.5. Videos: 23.976–60 fps. Decoded video/audio: 2–15 seconds per file; per-type rounded totals <=15 seconds. Duration arrays must match URL counts. H3 and Fast support audio references; H3 requires accompanying images or videos, while Fast supports audio-only references. Unsupported fields, including seed and generate_audio, are rejected."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"seedance-2.5"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":4,"maximum":30,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":30,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":10,"items":{"type":"integer","minimum":2,"maximum":30},"description":"One rounded-up decoded duration per URL. Total limit: 30 seconds."},"reference_audio_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":10,"items":{"type":"integer","minimum":2,"maximum":30},"description":"One rounded-up decoded duration per URL. Total limit: 30 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"seedance-1.5-pro"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":4,"maximum":12,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"seedance-1.0-pro"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":4,"maximum":12,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"seedance-1.0-lite"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":4,"maximum":12,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"veo-3.1-fast"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p"},"duration":{"type":"integer","minimum":8,"maximum":8,"default":8,"enum":[8]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":3,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"kling-3.0"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p"},"duration":{"type":"integer","minimum":3,"maximum":15,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"kling-3.0-turbo"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":3,"maximum":15,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"kling-v3-omni"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p","4k"],"default":"720p"},"duration":{"type":"integer","minimum":3,"maximum":15,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":3,"maximum":10},"description":"One rounded-up decoded duration per URL. Total limit: 10 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"kling-video-o1"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":5,"maximum":10,"default":5,"enum":[5,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":3,"maximum":10},"description":"One rounded-up decoded duration per URL. Total limit: 10 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"grok-imagine-1.5"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p"],"default":"720p"},"duration":{"type":"integer","minimum":6,"maximum":15,"default":6},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":7,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"flux-3-video"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["hd","fhd"],"default":"hd"},"duration":{"type":"integer","minimum":5,"maximum":20,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":2,"maximum":20},"description":"One rounded-up decoded duration per URL. Total limit: 20 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"wan-3.0"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":2,"maximum":30,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":5,"items":{"type":"integer","minimum":1,"maximum":15},"description":"One rounded-up decoded duration per URL. Total limit: 15 seconds."},"reference_audio_urls":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":5,"items":{"type":"integer","minimum":1,"maximum":15},"description":"One rounded-up decoded duration per URL. Total limit: 15 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. Input video plus output duration must not exceed 30 seconds. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"gemini-omni-1.1-flash"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["360p","720p","1080p","4k"],"default":"720p"},"duration":{"type":"integer","minimum":10,"maximum":10,"default":10,"enum":[10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":10,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":1,"maximum":10},"description":"One rounded-up decoded duration per URL. Total limit: 10 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. Billed per generation using a fixed 10-second unit; output duration is automatic. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"vidu-q3-turbo"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":2000},"resolution":{"type":"string","enum":["540p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":1,"maximum":16,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","1:1"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":-1,"maximum":4294967295},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"wan-2.7"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":2,"maximum":15,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":2,"maximum":10},"description":"One rounded-up decoded duration per URL. Total limit: 10 seconds."},"reference_audio_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":2,"maximum":30},"description":"One rounded-up decoded duration per URL. Total limit: 30 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode"],"properties":{"model":{"const":"kling-motion-control"},"mode":{"type":"string","enum":["media-to-video"]},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":3,"maximum":30},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_video_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":3,"maximum":30},"description":"One rounded-up decoded duration per URL. Total limit: 30 seconds."}},"allOf":[{"if":{"required":["reference_video_urls"],"properties":{"reference_video_urls":{"minItems":1}}},"then":{"required":["reference_video_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. Exactly one character image and one motion video are required; duration follows the video. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"wan-2.6"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":5,"maximum":15,"default":5,"enum":[5,10,15]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":2,"maximum":15},"description":"One rounded-up decoded duration per URL. Total limit: 15 seconds."}},"allOf":[{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"wan-2.5"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":5,"maximum":10,"default":5,"enum":[5,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}},"reference_audio_durations":{"type":"array","maxItems":1,"items":{"type":"integer","minimum":2,"maximum":10},"description":"One rounded-up decoded duration per URL. Total limit: 10 seconds."}},"allOf":[{"if":{"required":["reference_audio_urls"],"properties":{"reference_audio_urls":{"minItems":1}}},"then":{"required":["reference_audio_durations"]}},{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio.  Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"kling-2.6"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":5,"maximum":10,"default":5,"enum":[5,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. End frame requires 1080p and generated audio disabled. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"hailuo-2.3"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"duration":{"type":"integer","minimum":6,"maximum":10,"default":6,"enum":[6,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. 1080p requires 6 seconds. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt","mode"],"properties":{"model":{"const":"hailuo-2.3-fast"},"mode":{"type":"string","enum":["image-to-video"]},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"duration":{"type":"integer","minimum":6,"maximum":10,"default":6,"enum":[6,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":1,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. A first-frame image is required. 1080p requires 6 seconds. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"hailuo-02"},"mode":{"type":"string","enum":["text-to-video","image-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["512p","768p","1080p"],"default":"512p"},"duration":{"type":"integer","minimum":5,"maximum":10,"default":5,"enum":[5,10]},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":2,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. 1080p requires 5 seconds. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."},{"type":"object","additionalProperties":false,"required":["model","prompt"],"properties":{"model":{"const":"pixverse-v6"},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"prompt":{"type":"string","minLength":1,"maxLength":7000},"resolution":{"type":"string","enum":["360p","540p","720p","1080p"],"default":"720p"},"duration":{"type":"integer","minimum":1,"maximum":15,"default":5},"aspect_ratio":{"type":"string","enum":["16:9","9:16","4:3","3:4","3:2","2:3","2:1","21:9","1:1","adaptive"]},"max_credits":{"type":"integer","minimum":1,"maximum":9007199254740991},"watermark":{"type":"boolean","default":false},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean"},"image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"end_image_url":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":7,"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":2048}}},"allOf":[{"if":{"required":["mode"],"properties":{"mode":{"const":"image-to-video"}}},"then":{"required":["image_url"]}}],"description":"Same model rules and prices as the Studio. Paired frames require 5 or 8 seconds. Frame and reference fields are mutually exclusive. See GET /models for media limits and conditional combinations. Maximum combined input size: 256 MiB."}]},"VideoTask":{"type":"object","required":["id","status","model","mode","credits_used","credits_refunded","output","error","created_at","updated_at"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["processing","completed","failed"]},"model":{"type":"string","enum":["minimax-h3","minimax-h3-fast","minimax-h3-max","seedance-2.5","seedance-2.0","seedance-2.0-fast","seedance-2.0-mini","seedance-1.5-pro","seedance-1.0-pro","seedance-1.0-lite","veo-3.1-fast","kling-3.0","kling-3.0-turbo","kling-v3-omni","kling-video-o1","grok-imagine-1.5","flux-3-video","wan-3.0","gemini-omni-1.1-flash","vidu-q3-turbo","wan-2.7","kling-motion-control","wan-2.6","wan-2.5","kling-2.6","hailuo-2.3","hailuo-2.3-fast","hailuo-02","pixverse-v6"]},"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"]},"credits_used":{"type":"integer","minimum":0},"credits_refunded":{"type":"integer","minimum":0},"output":{"oneOf":[{"type":"null"},{"type":"object","required":["video_url"],"properties":{"video_url":{"type":"string","format":"uri","description":"A MiniMax H3-managed delivery URL. A task is not marked completed until the provider output has been copied to managed storage."}}}]},"error":{"oneOf":[{"type":"null"},{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}]},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"billing_status":{"type":"string","enum":["reserved","settled","refunded","refund_pending","review"]}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}},"LegacyVideoGenerationRequest":{"type":"object","additionalProperties":false,"required":["prompt"],"description":"All input media combined must not exceed 256 MB. The API atomically reserves paid credits before downloading remote media. Failures confirmed before provider acceptance refund the reservation and delete inputs uploaded during that attempt. If provider acceptance is uncertain, the task, credits, and managed inputs are held for reconciliation; retry only with the same Idempotency-Key and never create a new key for that request. Reference videos are fully decoded so the server can verify their duration and dimensions; billing uses the measured duration and requested output resolution.","dependentRequired":{"reference_video_urls":["reference_video_durations"]},"properties":{"mode":{"type":"string","enum":["text-to-video","image-to-video","media-to-video"],"default":"text-to-video"},"model":{"type":"string","enum":["seedance-2.0","seedance-2.0-fast","seedance-2.0-mini"],"default":"seedance-2.0-fast"},"prompt":{"type":"string","minLength":3,"maxLength":4000},"aspect_ratio":{"type":"string","enum":["1:1","21:9","4:3","3:4","16:9","9:16","adaptive"],"default":"16:9"},"duration":{"type":"integer","minimum":4,"maximum":15,"default":5},"resolution":{"type":"string","enum":["480p","720p","1080p","4k"],"default":"720p"},"image_url":{"type":"string","format":"uri","maxLength":2048},"end_image_url":{"type":"string","format":"uri","maxLength":2048},"reference_image_urls":{"type":"array","maxItems":8,"items":{"type":"string","format":"uri","maxLength":2048}},"reference_video_urls":{"type":"array","maxItems":3,"description":"Up to 3 public HTTPS videos. Each video must be 2-15 seconds, use a 480p-720p short side, and all reference videos combined must be no longer than 15 seconds.","items":{"type":"string","format":"uri","maxLength":2048}},"reference_video_durations":{"type":"array","minItems":1,"maxItems":3,"description":"Required when reference_video_urls is present. Supply one whole-second duration for each URL so paid credits can be reserved before download. The server fully decodes every video, requires each value to match its measured duration, and bills using the measured duration.","items":{"type":"integer","minimum":2,"maximum":15}},"generate_audio":{"type":"boolean","default":true},"seed":{"type":"integer","minimum":-1,"maximum":4294967295}}}}}}