1. 视频(Videos)
168Token
  • 快速开始
    • 指南
    • BaseUrl
    • 通过 AI 快速生成调用代码
    • 各类插件配置指南
  • 接口说明
    • 模型(Models)
      • 列出模型
        • 原生OpenAI格式
        • 原生Gemini格式
    • 聊天(Chat)
      • 原生OpenAI格式
        • ChatCompletions格式
        • Responses格式
      • 原生Gemini格式
        • Gemini文本聊天
        • Gemini媒体识别
      • 原生Claude格式
    • 图像(Images)
      • 原生OpenAI格式
        • 生成图像
        • 编辑图像
      • 通义千问格式
        • 生成图像
        • 编辑图像
      • Nano Banana
        • Gemini原生格式
        • OpenAI聊天格式
    • 视频(Videos)
      • SeeDance2.0
      • Sora格式
        • 创建视频
        • 获取视频任务状态
        • 获取视频内容
      • 可灵格式
        • Kling 文生视频
        • 获取 Kling 文生视频任务状态
        • Kling 图生视频
        • 获取 Kling 图生视频任务状态
      • 即梦格式
        • 即梦视频生成
      • 创建视频生成任务
        POST
      • 获取视频生成任务状态
        GET
    • 嵌入(Embeddings)
      • 原生OpenAI格式
      • 原生Gemini格式
    • 补全(Completions)
      • 原生OpenAI格式
    • 音频(Audio)
      • 原生OpenAI格式
        • 音频转录
        • 音频翻译
        • 文本转语音
      • 原生Gemini格式
    • 实时语音(Realtime)
      • 原生OpenAI格式
    • 重排序(Rerank)
      • 文档重排序
    • 审查(Moderations)
      • 原生OpenAI格式
    • 未实现(Unimplemented)
      • 微调(Fine-tuning)
        • 列出微调任务 (未实现)
        • 创建微调任务 (未实现)
        • 获取微调任务详情 (未实现)
        • 取消微调任务 (未实现)
        • 获取微调任务事件 (未实现)
      • 文件(Files)
        • 列出文件 (未实现)
        • 上传文件 (未实现)
        • 获取文件信息 (未实现)
        • 删除文件 (未实现)
        • 获取文件内容 (未实现)
    • 数据模型
      • Schemas
        • Model
        • Usage
        • ModelsResponse
        • ErrorResponse
        • Message
        • MessageContent
        • Tool
        • ToolCall
        • GeminiModelsResponse
        • ChatCompletionResponse
        • ChatCompletionRequest
        • CompletionRequest
        • CompletionResponse
        • ResponseFormat
        • ResponsesRequest
        • ResponsesResponse
        • ClaudeRequest
        • ClaudeMessage
        • ClaudeResponse
        • EmbeddingRequest
        • EmbeddingResponse
        • ImageResponse
        • AudioTranscriptionResponse
        • SpeechRequest
        • RerankRequest
        • RerankResponse
        • VideoRequest
        • ModerationRequest
        • VideoResponse
        • ModerationResponse
        • VideoTaskResponse
        • GeminiRequest
        • VideoTaskMetadata
        • VideoTaskError
        • GeminiResponse
        • OpenAIVideoError
  1. 视频(Videos)

SeeDance2.0

概述#

当前文档主要提供 seedance2.0 的对接调用案例,建议可以从案例开始逐个尝试。
方式输入组合说明
案例 A(推荐起步)图 + 文先稳定调通,最容易定位问题
案例 B图 + 视频 + 文把视频当“运动参考”,保持画面风格由图控制
案例 C图 + 音频 + 文用于节奏感/氛围感增强,注意音频不能单独输入
案例 D(完整版)图 + 视频 + 音频 + 文商业成片场景,建议在 A/B/C 验证后再使用
如接口鉴权对接上有问题,可参考接口文档:
接口文档:创建视频生成任务

API 接口#

1. 提交视频生成任务#

POST /v1/video/generations

认证#

请求头包含 API 密钥:
Authorization: Bearer sk-Your-API-Key
curl 示例:

案例说明#

案例 A:图 + 文#

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪,冲向悉尼歌剧院",
  "images": [
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2F8548d314j00tcvcze002pd000u000k0g.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2Fde89a202j00tcvcze001md000u000gwg.jpg&thumbnail=660x2147483647&quality=80&type=jpg"
  ],
  "duration": 4,
  "resolution": "480p"
}

案例 B:图 + 视频 + 文#

{
  "model": "bytedance/seedance-2.0",
  "prompt": "变身成龙之后,飞到一片雪山和溪流的上空",
  "images": [
    "https://gips3.baidu.com/it/u=1039279337,1441343044&fm=3028&app=3028&f=JPEG&fmt=auto&q=100&size=f1024_1024"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceVideoUrls": [
      "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/07/task_dFOdVscFv6UTM5dHIJWMqOx8GyB0I2aR.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260407%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260407T061837Z&x-oss-expires=604800&x-oss-signature=31c2e1becff32ef95712ea025b1e146aebb7dd316901178924b5fccd916acdb2&x-oss-signature-version=OSS4-HMAC-SHA256"
    ]
  }
}

案例 C:图 + 音频 + 文#

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪,冲向悉尼歌剧院,并且化身为龙,祥云满天",
  "images": [
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2F8548d314j00tcvcze002pd000u000k0g.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
    "https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2026%2F0402%2Fde89a202j00tcvcze001md000u000gwg.jpg&thumbnail=660x2147483647&quality=80&type=jpg"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceAudioUrls": [
      "https://cdn.pixabay.com/audio/2025/04/15/audio_981caf755e.mp3"
    ]
  }
}

案例 D:图 + 视频 + 音频 + 文#

{
  "model": "bytedance/seedance-2.0",
  "prompt": "一辆汽车乘风破浪,飞快开过湖面",
  "images": [
    "https://gips3.baidu.com/it/u=1039279337,1441343044&fm=3028&app=3028&f=JPEG&fmt=auto&q=100&size=f1024_1024"
  ],
  "duration": 4,
  "resolution": "480p",
  "metadata": {
    "generate_audio": true,
    "referenceAudioUrls": [
      "https://m704.music.126.net/20260403152936/0c5c6b4d74b62e8e07b59a6afd2a859b/jdyyaac/obj/w5rDlsOJwrLDjj7CmsOj/12203537925/19e4/d4a5/9bca/fb0b1bba558830f1784d5be84cd06d0c.m4a?vuutv=Bi266B79ZekVeTaQslMd38H0MXDXrRMbIKA8uNzy6v/vgxlr/hJTaDng/ucIisQxUsGFD/pgw8FscqnFEL9khw6+7B7K8ejly4zDBODON3M=&authSecret=0000019d52287574050f0aaf7e9e0007"
    ],
    "referenceVideoUrls": [
      "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/03/task_pUsPrPyNoRCZjYNEeck1Rxzoq447zkf1.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260403%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260403T065307Z&x-oss-expires=604800&x-oss-signature=00f3c1b8c0aaf47f98eeef951a179e214a51032f47c7c7e670cc059cbf852130&x-oss-signature-version=OSS4-HMAC-SHA256"
    ]
  }
}

请求参数详解#

model(模型)#

类型:string
是否必填:是
描述:模型标识符(例如:bytedance/seedance-2.0)

prompt(提示词)#

类型:string
是否必填:是
描述:要生成的视频内容描述文本

images(参考图)#

类型:array
是否必填:否
描述:用于参考的图片 URL 数组(字符串数组)

duration(时长)#

类型:number
是否必填:否
默认值:4
范围:1-10(因模型而异)

resolution(分辨率)#

类型:string
是否必填:否
可选值:720p、480p(因模型而异)
默认值:720p

metadata(元数据)#

类型:object
是否必填:否
描述:用于高级功能的额外元数据
字段:
referenceVideoUrls: 参考视频 URL 数组
referenceAudioUrls: 参考音频 URL 数组
generate_audio: 是否自动生成音频(boolean,默认 false)

响应示例#

提交任务响应示例#

{
  "id": "task_90EKfyW3j6661gcwGKu3MH6KiWa1apxF",
  "task_id": "task_90EKfyW3j6661gcwGKu3MH6KiWa1apxF",
  "object": "video",
  "model": "bytedance/seedance-2.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1775540697
}

2. 查询视频生成任务状态#

GET /v1/video/generations/{task_id}
查询 curl 示例:

查询任务响应示例#

{
  "code": "success",
  "message": "",
  "data": {
    "id": 70,
    "created_at": 1775536340,
    "updated_at": 1775536502,
    "task_id": "task_VRjTVeqdHPbdjKxeCah9zDgHL7I88xca",
    "platform": "59",
    "user_id": 1,
    "group": "default",
    "channel_id": 4,
    "quota": 2000,
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "result_url": "https://test-fshows-public.oss-cn-hangzhou.aliyuncs.com/tasks/files/2026/04/07/task_VRjTVeqdHPbdjKxeCah9zDgHL7I88xca.mp4?x-oss-credential=LTAI5t7i5hp8ySNLqncEfobz%2F20260407%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20260407T043502Z&x-oss-expires=604800&x-oss-signature=72531281a62c20e480ad5095776d10cd8f5c3bc6a0496ad52b0624b544980a44&x-oss-signature-version=OSS4-HMAC-SHA256",
    "submit_time": 1775536340,
    "start_time": 1775536352,
    "finish_time": 1775536449,
    "progress": "100%",
    "properties": {
      "input": "",
      "upstream_model_name": "bytedance/seedance-2.0",
      "origin_model_name": "bytedance/seedance-2.0"
    },
    "data": {
      "id": "cgt-20260407123217-d6h4q",
      "seed": 39555,
      "draft": false,
      "model": "dreamina-seedance-2-0-260128",
      "ratio": "16:9",
      "usage": {
        "total_tokens": 40594,
        "completion_tokens": 40594
      },
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-acg-ap-southeast-1.tos-ap-southeast-1.volces.com/dreamina-seedance-2-0/02177553634005600000000000000000000ffffc0a88f20b19e47.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260407%2Fap-southeast-1%2Ftos%2Frequest&X-Tos-Date=20260407T043404Z&X-Tos-Expires=86400&X-Tos-Signature=18f6dbd4a725effa7c062b7e709f4b81a88e9cc7d10564f5620eee16219dd0ee&X-Tos-SignedHeaders=host"
      },
      "duration": 4,
      "created_at": 1775536339,
      "resolution": "480p",
      "updated_at": 1775536448,
      "service_tier": "default",
      "generate_audio": false,
      "framespersecond": 24,
      "execution_expires_after": 172800
    }
  }
}
修改于 2026-05-07 11:20:11
上一页
OpenAI聊天格式
下一页
创建视频
Built with