{"openapi":"3.1.0","info":{"title":"Seedance 2.5 Flash API","version":"1.0.0","description":"Use publicly readable HTTP(S) URLs without credentials. Images: JPEG, PNG or WebP, up to 30 MB. Images and videos: 300–6000 pixels per edge, aspect ratio 0.4–2.5.\nVideos: MP4 or MOV, up to 200 MB, 24–60 fps, 409600–8295044 pixels. References last 2–30 seconds, or 4–30 seconds for the edit source. Combined video duration is at most 30 seconds.\nAudio: MP3 or WAV, up to 15 MB and 2–30 seconds per clip, at most 30 seconds combined."},"servers":[{"url":"https://api.wanapi.app"}],"security":[{"bearerAuth":[]}],"paths":{"/v1/videos":{"post":{"summary":"Create a video","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","const":"bytedance/seedance-2.5-flash"},"draftTaskId":{"not":{}},"prompt":{"type":"string","minLength":1},"image":{"anyOf":[{"type":"string","maxLength":4096},{"type":"object","properties":{"type":{"type":"string","const":"url"},"url":{"type":"string","maxLength":4096},"mediaType":{"type":"string","enum":["image/jpeg","image/png","image/webp"]}},"required":["type","url"],"additionalProperties":false}]},"frameImages":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"object","properties":{"image":{"anyOf":[{"type":"string","maxLength":4096},{"type":"object","properties":{"type":{"type":"string","const":"url"},"url":{"type":"string","maxLength":4096},"mediaType":{"type":"string","enum":["image/jpeg","image/png","image/webp"]}},"required":["type","url"],"additionalProperties":false}]},"frameType":{"type":"string","enum":["first_frame","last_frame"]}},"required":["image","frameType"],"additionalProperties":false}},"inputReferences":{"maxItems":15,"type":"array","items":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"url"},"url":{"type":"string","maxLength":4096},"mediaType":{"type":"string","enum":["image/jpeg","image/png","image/webp","video/mp4","video/quicktime"]}},"required":["type","url","mediaType"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"string","maxLength":4096},"mediaType":{"type":"string","enum":["image/jpeg","image/png","image/webp","video/mp4","video/quicktime"]}},"required":["data","mediaType"],"additionalProperties":false}]}},"aspectRatio":{"type":"string","enum":["adaptive","16:9","4:3","1:1","3:4","9:16","21:9"]},"resolution":{"type":"string","enum":["480p","854x480","720p","1280x720"]},"duration":{"anyOf":[{"type":"number","const":-1},{"type":"integer","minimum":4,"maximum":30}],"description":"Generation: 4–30 seconds (default 5). Edit: omit or pass -1."},"fps":{"type":"number","const":24},"generateAudio":{"type":"boolean"},"n":{"type":"number","const":1},"providerOptions":{"type":"object","properties":{"bytedance":{"type":"object","properties":{"draft":{"not":{}},"output_format":{"not":{}},"omni_reference_task_type":{"type":"string","enum":["generate","edit"]},"watermark":{"not":{}},"return_last_frame":{"not":{}},"execution_expires_after":{"not":{}},"priority":{"not":{}},"safety_identifier":{"not":{}},"service_tier":{"not":{}},"content_filter":{"type":"boolean"},"referenceAudio":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":4096}}},"additionalProperties":false}},"additionalProperties":false}},"required":["model","prompt"],"additionalProperties":false,"allOf":[{"properties":{"prompt":{"pattern":"\\S"},"frameImages":{"contains":{"properties":{"frameType":{"const":"first_frame"}}},"minContains":1,"maxContains":1},"inputReferences":{"allOf":[{"contains":{"properties":{"mediaType":{"enum":["video/mp4","video/quicktime"]}}},"minContains":0,"maxContains":5},{"contains":{"not":{"properties":{"mediaType":{"enum":["video/mp4","video/quicktime"]}}}},"minContains":0,"maxContains":10}]}}}],"oneOf":[{"title":"Text or reference generation","not":{"anyOf":[{"required":["image"]},{"required":["frameImages"]},{"required":["providerOptions"],"properties":{"providerOptions":{"required":["bytedance"],"properties":{"bytedance":{"required":["omni_reference_task_type"],"properties":{"omni_reference_task_type":{"const":"edit"}}}}}}}]},"properties":{"duration":{"type":"integer","minimum":4,"maximum":30},"aspectRatio":{"enum":["16:9","4:3","1:1","3:4","9:16","21:9"]}}},{"title":"Frame generation","oneOf":[{"required":["image"]},{"required":["frameImages"]}],"not":{"required":["providerOptions"],"properties":{"providerOptions":{"required":["bytedance"],"properties":{"bytedance":{"required":["omni_reference_task_type"],"properties":{"omni_reference_task_type":{"const":"edit"}}}}}}},"properties":{"duration":{"type":"integer","minimum":4,"maximum":30},"aspectRatio":{"const":"adaptive"},"inputReferences":{"maxItems":0},"providerOptions":{"properties":{"bytedance":{"properties":{"referenceAudio":{"maxItems":0}}}}}}},{"title":"Source video editing","allOf":[{"required":["providerOptions"],"properties":{"providerOptions":{"required":["bytedance"],"properties":{"bytedance":{"required":["omni_reference_task_type"],"properties":{"omni_reference_task_type":{"const":"edit"}}}}}}}],"not":{"anyOf":[{"required":["image"]},{"required":["frameImages"]}]},"required":["inputReferences"],"properties":{"aspectRatio":{"const":"adaptive"},"duration":{"const":-1},"inputReferences":{"contains":{"properties":{"mediaType":{"enum":["video/mp4","video/quicktime"]}}},"minContains":1,"maxContains":1}}}]},"example":{"model":"bytedance/seedance-2.5-flash","prompt":"A paper boat floats through a sunlit stream. Slow tracking shot.","resolution":"720p","aspectRatio":"16:9","duration":4,"generateAudio":true}}}},"responses":{"200":{"description":"Video task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"400":{"description":"Invalid parameters"},"401":{"description":"Authentication required"},"402":{"description":"Insufficient balance"}}}},"/v1/videos/{task_id}":{"get":{"summary":"Get a video task","parameters":[{"in":"path","name":"task_id","required":true,"schema":{"type":"string","pattern":"^task_[A-Za-z0-9]+$"}}],"responses":{"200":{"description":"Current task state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"404":{"description":"Task not found"},"410":{"description":"Video expired"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Task":{"type":"object","required":["id","model","status"],"properties":{"id":{"type":"string"},"model":{"type":"string"},"status":{"enum":["queued","in_progress","completed","failed"]},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"videos":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"mediaType":{"const":"video/mp4"}}}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}