Seedance 2.x Video API

{
  "allOf": [
    {
      "type": "object",
      "required": [
        "prompt"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "mode": {
          "type": "string",
          "enum": [
            "text-to-video",
            "image-to-video",
            "first-last-frames",
            "reference"
          ],
          "default": "text-to-video",
          "description": "image-to-video uses image_url (+ optional last_frame_url); first-last-frames uses first_frame_url + last_frame_url; reference accepts any combination of reference_urls (image) / video_urls / audio_urls. On Seedance 2.0 audio cannot be used alone and must accompany at least one image or video reference; on Seedance 2.5 audio-only references are supported."
        },
        "model_version": {
          "type": "string",
          "enum": [
            "standard",
            "mini",
            "fast",
            "2.5"
          ],
          "default": "standard",
          "description": "standard / mini / fast select a Seedance 2.0 tier. \"2.5\" selects Seedance 2.5, which currently has a single tier and higher input limits (see duration / reference_urls / video_urls / audio_urls)."
        },
        "omni_reference_task_type": {
          "type": "string",
          "enum": [
            "reference",
            "edit",
            "extend"
          ],
          "description": "Seedance 2.5 reference-mode task hint. edit uses ratio=adaptive and duration=-1; extend uses ratio=adaptive; reference keeps the requested ratio and duration. edit currently accepts exactly one video_url. auto is intentionally not exposed because its output duration is unknown before billing."
        },
        "prompt": {
          "type": "string"
        },
        "image_url": {
          "type": "string",
          "description": "First frame for image-to-video mode."
        },
        "first_frame_url": {
          "type": "string",
          "description": "Required for first-last-frames mode."
        },
        "last_frame_url": {
          "type": "string",
          "description": "Optional last frame for image-to-video; required for first-last-frames."
        },
        "reference_urls": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 30,
          "description": "Reference images for reference mode. Max 9 on Seedance 2.0, max 30 on Seedance 2.5."
        },
        "video_urls": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Reference videos (mp4/mov). Seedance 2.0: max 3 clips, each 2-15s, total <= 15 × number_of_videos seconds. Seedance 2.5: max 10 clips with a combined cap of 30s; omni_reference_task_type=edit currently requires exactly one clip. The server always probes video_urls (public hosts only, with separate connection/download/parse limits) as the authoritative duration for billing."
        },
        "audio_urls": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Reference audios (mp3/wav). Seedance 2.0: max 3 clips, each 2-15s, total <=15s, and audio cannot be used standalone (at least one image or video reference is required). Seedance 2.5: max 10 clips and audio-only references are allowed."
        },
        "input_video_duration": {
          "type": "number",
          "minimum": 2,
          "maximum": 45.5,
          "description": "Optional client estimate of the total reference-video duration in seconds. This value is never trusted for final billing: the server always probes video_urls and bills on max(measured, this value), so passing a smaller number does not lower the price. Must be within [2, 15 × number_of_videos] on Seedance 2.0 and within [2, 30] on Seedance 2.5."
        },
        "duration": {
          "type": "integer",
          "oneOf": [
            {
              "enum": [
                -1
              ]
            },
            {
              "minimum": 4,
              "maximum": 30
            }
          ],
          "default": 5,
          "description": "Output length in seconds. Max 15 on Seedance 2.0; max 30 on Seedance 2.5. Seedance 2.5 edit tasks require -1."
        },
        "aspect_ratio": {
          "type": "string",
          "enum": [
            "adaptive",
            "21:9",
            "16:9",
            "4:3",
            "1:1",
            "3:4",
            "9:16"
          ],
          "default": "16:9"
        },
        "resolution": {
          "type": "string",
          "enum": [
            "480p",
            "720p",
            "1080p",
            "4k"
          ],
          "default": "720p",
          "description": "Only the standard tier of Seedance 2.0 supports 4k. Seedance 2.5 supports 480p / 720p / 1080p. The fast / mini tiers of Seedance 2.0 are limited to 480p / 720p."
        },
        "generate_audio": {
          "type": "boolean",
          "default": true,
          "description": "Defaults to true to match billing (audio is included); pass false explicitly to disable."
        },
        "minor_suspected_skip": {
          "type": "boolean",
          "default": false,
          "description": "Skip soft minor-suspect block (code 1004); hard CSAM block (code 1003) is always enforced."
        }
      }
    },
    {
      "$ref": "#/components/schemas/WebhookInput"
    }
  ]
}