# Seedance 2.0 Fast > Seedance 2.0 Fast,ByteDance 的视频生成模型。 - **模型 ID**: `bytedance/seedance-2.0-fast` - **厂商**: ByteDance - **类型**: video - **状态**: live - **超时上限**: 3600 s - **统一格式**: 支持 - **接口**: `POST https://api.kerox.ai/v1/tasks` - **模型页**: https://kerox.ai/models/bytedance/seedance-2.0-fast ## 价格 **按 token 计费**。下表的约每秒价按 16:9 折算,720p 不带参考视频约 $0.0968 / 秒。 | 分辨率 | 不带参考视频(约每秒) | 带参考视频(约每秒) | 官方价 / 百万 token | Kerox / 百万 token | 带参考视频:官方价 / 百万 token | 带参考视频:Kerox / 百万 token | | --- | --- | --- | --- | --- | --- | --- | | 480p | $0.0450 | $0.0265 | $5.6000 | $4.4800 | $3.3000 | $2.6400 | | 720p | $0.0968 | $0.0570 | $5.6000 | $4.4800 | $3.3000 | $2.6400 | - **计算公式**:`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-fast", "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-fast", "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-fast", "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-fast", "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 | 分辨率 | | `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 | 分辨率 | | `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-fast", "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" ], "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 } ```