# Seedance 2.0

> Seedance 2.0，ByteDance 的视频生成模型。

- **模型 ID**: `bytedance/seedance-2.0`
- **厂商**: ByteDance
- **类型**: video
- **状态**: live
- **超时上限**: 3600 s
- **统一格式**: 支持
- **接口**: `POST https://api.kerox.ai/v1/tasks`
- **模型页**: https://kerox.ai/models/bytedance/seedance-2.0

## 价格

**按 token 计费**。下表的约每秒价按 16:9 折算，720p 不带参考视频约 $0.1436 / 秒。

| 分辨率 | 不带参考视频（约每秒） | 带参考视频（约每秒） | 官方价 / 百万 token | Kerox / 百万 token | 带参考视频：官方价 / 百万 token | 带参考视频：Kerox / 百万 token |
| --- | --- | --- | --- | --- | --- | --- |
| 4k | $0.7387 | $0.4432 | $4.0000 | $3.8000 | $2.4000 | $2.2800 |
| 480p | $0.0668 | $0.0410 | $7.0000 | $6.6500 | $4.3000 | $4.0850 |
| 720p | $0.1436 | $0.0882 | $7.0000 | $6.6500 | $4.3000 | $4.0850 |
| 1080p | $0.3555 | $0.2170 | $7.7000 | $7.3150 | $4.7000 | $4.4650 |

- **计算公式**：`token =（输出秒数 + 参考视频秒数）× 宽 × 高 × 24 / 1024`。带参考视频时，较低的单价按「输出秒数 + 参考视频秒数」的合计时长计。
- **画面比例与声音**：约每秒价按 16:9、不带参考视频折算；同一分辨率下其他画面比例的差异在 5% 以内，开不开声音不影响价格。
- **提交前预估**：用 `POST /v1/estimate` 或在 Studio 里查看这次参数的预估费用。

## 请求示例

用原厂参数提交任务。

### cURL

```bash
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.0",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "a red fox running through fresh snow, cinematic lighting"
      }
    ],
    "resolution": "720p",
    "duration": 5
  }
}'
```

### Python

```python
import os
import requests

resp = requests.post(
    "https://api.kerox.ai/v1/tasks",
    headers={
        "Authorization": f"Bearer {os.environ['KEROX_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "bytedance/seedance-2.0",
        "input": {
            "content": [
                {
                    "type": "text",
                    "text": "a red fox running through fresh snow, cinematic lighting",
                },
            ],
            "resolution": "720p",
            "duration": 5,
        },
    },
    timeout=60,
)
resp.raise_for_status()
task = resp.json()
print(task["id"], task["status"], task["output"])
```

### Node.js

```javascript
const res = await fetch('https://api.kerox.ai/v1/tasks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.KEROX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "model": "bytedance/seedance-2.0",
    "input": {
      "content": [
        {
          "type": "text",
          "text": "a red fox running through fresh snow, cinematic lighting"
        }
      ],
      "resolution": "720p",
      "duration": 5
    }
  }),
});
const task = await res.json();
console.log(task.id, task.status, task.output);
```

### Go

```go
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
  "model": "bytedance/seedance-2.0",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "a red fox running through fresh snow, cinematic lighting"
      }
    ],
    "resolution": "720p",
    "duration": 5
  }
}`)
	req, _ := http.NewRequest("POST", "https://api.kerox.ai/v1/tasks", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("KEROX_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}
```

## 参数（原厂格式）

| 参数 | 类型 | 默认值 | 可选值 | 说明 |
| --- | --- | --- | --- | --- |
| `ratio` | string | `"adaptive"` | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 画面比例 |
| `content` | array | — | — | 输入内容 |
| `duration` | integer | `5` | -1, 4–15 | 时长 |
| `priority` | integer | — | 0–9 | 排队优先级 |
| `watermark` | boolean | `false` | — | 水印 |
| `resolution` | string | `"720p"` | 480p, 720p, 1080p, 4k | 分辨率 |
| `service_tier` | string | `"default"` | default | 服务档位 |
| `generate_audio` | boolean | `true` | — | 生成声音 |
| `return_last_frame` | boolean | `false` | — | 返回尾帧 |
| `safety_identifier` | string | — | — | 终端用户标识 |

## 参数（统一格式，`format: "unified"`）

| 参数 | 类型 | 默认值 | 可选值 | 说明 |
| --- | --- | --- | --- | --- |
| `n` | integer | `1` | 1 | 生成数量 |
| `audios` | string \| string[] | — | — | 参考音频 |
| `images` | string \| string[] | — | — | 参考图 |
| `prompt` | string | — | — | 提示词 |
| `videos` | string \| string[] | — | — | 参考视频 |
| `duration` | integer | `5` | -1, 4–15 | 时长 |
| `last_frame` | string | — | — | 尾帧 |
| `resolution` | string | `"720p"` | 480p, 720p, 1080p, 4k | 分辨率 |
| `first_frame` | string | — | — | 首帧 |
| `aspect_ratio` | string | `"adaptive"` | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 画面比例 |
| `priority` | integer | — | 0–9 | 排队优先级 |
| `watermark` | boolean | `false` | — | 水印 |
| `service_tier` | string | `"default"` | default | 服务档位 |
| `generate_audio` | boolean | `true` | — | 生成声音 |
| `return_last_frame` | boolean | `false` | — | 返回尾帧 |
| `safety_identifier` | string | — | — | 终端用户标识 |

## 轮询与输出

轮询 `GET /v1/tasks/{id}`，或用 Webhook 接收完成通知。结果文件在 `expires_at` 之后过期（完成后 7 天），想留的请下载。任务对象的其余字段见任务指南和 API 参考。

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

```json
{
  "id": "task_01JD8X9B4Q2M7T8N3K5P6R1S0V",
  "object": "task",
  "model": "bytedance/seedance-2.0",
  "status": "succeeded",
  "output": {
    "videos": [
      {
        "url": "https://cdn.kerox.ai/t/task_01JD8X9B4Q2M7T8N3K5P6R1S0V/5f2b8c1e9d3a4f6b8a7c0d1e2f3a4b5c/0.mp4",
        "content_type": "video/mp4",
        "width": 1280,
        "height": 720,
        "duration": 5
      }
    ]
  },
  "error": null,
  "expires_at": "2026-11-27T08:01:10Z"
}
```

## 输入 schema（JSON）

```json
{
  "type": "object",
  "$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",
                "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": false,
        "max_reference_audios": 3,
        "max_reference_images": 9,
        "max_reference_videos": 3,
        "first_last_frame_exclusive_with_references": true
      }
    },
    "duration": {
      "type": "integer",
      "anyOf": [
        {
          "const": -1
        },
        {
          "maximum": 15,
          "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",
        "4k"
      ],
      "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": "服务档位"
    },
    "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": "终端用户标识"
    }
  },
  "additionalProperties": false
}
```
