Skip to Content

Seedance 2.5

Seedance 2.5, a video generation model by ByteDance.

bytedance/seedance-2.5ByteDancevideo

Overview

Seedance 2.5, a video generation model by ByteDance.

  • Model ID: bytedance/seedance-2.5
  • Maker: ByteDance
  • Type: video
  • Timeout: 3600 s
  • Unified format: Supported
  • Endpoint: POST https://api.kerox.ai/v1/tasks

Pricing

Billed by tokens. The approx. per-second prices below are converted at 16:9: 720p without a reference video is approx. $0.2196 / s.

ResolutionWithout reference videoWith reference video
Approx. / sOfficial / 1M tokensKerox / 1M tokensApprox. / sOfficial / 1M tokensKerox / 1M tokens
480p$0.0977$10.7000$10.1650$0.0584$6.4000$6.0800
720p$0.2196$10.7000$10.1650$0.1313$6.4000$6.0800
1080p$0.5402$11.7000$11.1150$0.3232$7.0000$6.6500
  • Token formula: tokens = (output seconds + reference video seconds) × width × height × 24 / 1024. With a reference video, the lower rate applies to the combined duration (output plus reference video).
  • Aspect ratio and audio: approx. per-second prices are converted at 16:9 without a reference video. Other aspect ratios at the same resolution differ by under 5%, and audio does not change the price.
  • Estimate before you submit: call POST /v1/estimate, or check Studio, for the estimated cost of your exact parameters.

Request example

Submit a task with the model's native parameters.

curl -X POST https://api.kerox.ai/v1/tasks \
  -H "Authorization: Bearer $KEROX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.5",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "a red fox running through fresh snow, cinematic lighting"
      }
    ],
    "resolution": "720p",
    "duration": 5
  }
}'

Parameters

ParameterTypeDefaultValuesDescription
ratiostring"adaptive"adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16Aspect ratio
contentarray——Content
durationinteger5-1, 4–30Duration
priorityinteger—0–9Queue priority
watermarkbooleanfalse—Watermark
resolutionstring"720p"480p, 720p, 1080pResolution
service_tierstring"default"defaultService tier
output_formatstring"mp4"mp4, movContainer
generate_audiobooleantrue—Generate audio
return_last_framebooleanfalse—Return last frame
safety_identifierstring——End-user ID
omni_reference_task_typestring"auto"auto, reference, edit, extendReference task

Polling and output

Poll GET /v1/tasks/{id} or receive a webhook when the task finishes. Output files expire at expires_at (7 days after completion), so download anything you want to keep. The other fields of the task object are in the tasks guide and the API reference.

curl https://api.kerox.ai/v1/tasks/task_01JD8X9B4Q2M7T8N3K5P6R1S0V \
  -H "Authorization: Bearer $KEROX_API_KEY"

Input schema (JSON)

The full JSON Schema, nested parameters included
{
  "type": "object",
  "allOf": [
    {
      "if": {
        "required": [
          "omni_reference_task_type"
        ],
        "properties": {
          "omni_reference_task_type": {
            "const": "edit"
          }
        }
      },
      "then": {
        "required": [
          "duration"
        ],
        "x-message": "duration must be -1 when omni_reference_task_type is edit.",
        "properties": {
          "ratio": {
            "const": "adaptive",
            "x-message": "ratio must be adaptive when omni_reference_task_type is edit."
          },
          "content": {
            "contains": {
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                }
              }
            },
            "x-message": "content must have exactly one reference video when omni_reference_task_type is edit.",
            "maxContains": 1,
            "minContains": 1
          },
          "duration": {
            "const": -1,
            "x-message": "duration must be -1 when omni_reference_task_type is edit."
          }
        }
      }
    },
    {
      "if": {
        "required": [
          "omni_reference_task_type"
        ],
        "properties": {
          "omni_reference_task_type": {
            "const": "extend"
          }
        }
      },
      "then": {
        "properties": {
          "ratio": {
            "const": "adaptive",
            "x-message": "ratio must be adaptive when omni_reference_task_type is extend."
          },
          "content": {
            "contains": {
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                }
              }
            },
            "x-message": "content must have at least one reference video when omni_reference_task_type is extend.",
            "minContains": 1
          }
        }
      }
    },
    {
      "if": {
        "required": [
          "content"
        ],
        "properties": {
          "content": {
            "contains": {
              "anyOf": [
                {
                  "not": {
                    "required": [
                      "role"
                    ],
                    "properties": {
                      "role": true
                    }
                  }
                },
                {
                  "required": [
                    "role"
                  ],
                  "properties": {
                    "role": {
                      "const": "first_frame"
                    }
                  }
                }
              ],
              "required": [
                "type"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                }
              }
            }
          }
        }
      },
      "then": {
        "properties": {
          "ratio": {
            "const": "adaptive",
            "x-message": "ratio must be adaptive for first-frame image-to-video."
          }
        }
      }
    }
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "content"
  ],
  "properties": {
    "ratio": {
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "x-tier": "common",
      "default": "adaptive",
      "x-label-en": "Aspect ratio",
      "x-label-zh": "画面比例"
    },
    "content": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "title": "Text",
            "required": [
              "type",
              "text"
            ],
            "properties": {
              "text": {
                "type": "string",
                "maxLength": 10000,
                "minLength": 1
              },
              "type": {
                "const": "text"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "title": "Image",
            "required": [
              "type",
              "image_url"
            ],
            "properties": {
              "role": {
                "enum": [
                  "first_frame",
                  "last_frame",
                  "reference_image"
                ],
                "type": "string"
              },
              "type": {
                "const": "image_url"
              },
              "image_url": {
                "type": "object",
                "required": [
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "pattern": "^(https://|data:image/)"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "title": "Video",
            "required": [
              "type",
              "video_url",
              "role"
            ],
            "properties": {
              "role": {
                "const": "reference_video"
              },
              "type": {
                "const": "video_url"
              },
              "video_url": {
                "type": "object",
                "required": [
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "pattern": "^https://"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "title": "Audio",
            "required": [
              "type",
              "audio_url",
              "role"
            ],
            "properties": {
              "role": {
                "const": "reference_audio"
              },
              "type": {
                "const": "audio_url"
              },
              "audio_url": {
                "type": "object",
                "required": [
                  "url"
                ],
                "properties": {
                  "url": {
                    "type": "string",
                    "pattern": "^(https://|data:audio/)"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "x-tier": "common",
      "minItems": 1,
      "x-label-en": "Content",
      "x-label-zh": "输入内容",
      "x-constraints": {
        "max_text_items": 1,
        "audio_only_allowed": true,
        "max_reference_audios": 10,
        "max_reference_images": 30,
        "max_reference_videos": 10,
        "first_last_frame_exclusive_with_references": true
      }
    },
    "duration": {
      "type": "integer",
      "anyOf": [
        {
          "const": -1
        },
        {
          "maximum": 30,
          "minimum": 4
        }
      ],
      "x-tier": "common",
      "default": 5,
      "x-label-en": "Duration",
      "x-label-zh": "时长"
    },
    "priority": {
      "type": "integer",
      "x-tier": "advanced",
      "maximum": 9,
      "minimum": 0,
      "x-label-en": "Queue priority",
      "x-label-zh": "排队优先级"
    },
    "watermark": {
      "type": "boolean",
      "x-tier": "advanced",
      "default": false,
      "x-label-en": "Watermark",
      "x-label-zh": "水印"
    },
    "resolution": {
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-tier": "common",
      "default": "720p",
      "x-label-en": "Resolution",
      "x-label-zh": "分辨率"
    },
    "service_tier": {
      "enum": [
        "default"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "default",
      "x-label-en": "Service tier",
      "x-label-zh": "服务档位"
    },
    "output_format": {
      "enum": [
        "mp4",
        "mov"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "mp4",
      "x-label-en": "Container",
      "x-label-zh": "封装格式"
    },
    "generate_audio": {
      "type": "boolean",
      "x-tier": "common",
      "default": true,
      "x-label-en": "Generate audio",
      "x-label-zh": "生成声音"
    },
    "return_last_frame": {
      "type": "boolean",
      "x-tier": "advanced",
      "default": false,
      "x-label-en": "Return last frame",
      "x-label-zh": "返回尾帧"
    },
    "safety_identifier": {
      "type": "string",
      "x-tier": "advanced",
      "maxLength": 64,
      "x-label-en": "End-user ID",
      "x-label-zh": "终端用户标识"
    },
    "omni_reference_task_type": {
      "enum": [
        "auto",
        "reference",
        "edit",
        "extend"
      ],
      "type": "string",
      "x-tier": "advanced",
      "default": "auto",
      "x-label-en": "Reference task",
      "x-label-zh": "参考任务类型"
    }
  },
  "additionalProperties": false
}