Video字节跳动 (ByteDance)1 家上游

doubao-seedance-2.0-face

字节跳动 (ByteDance) doubao-seedance-2.0-face · VIDEO 模型

在 gpt88.cc 获取 API Key 快速开始

模型概览

这是一个视频生成模型，适合把文本或素材生成短视频片段。
它是一个可通过 gpt88.cc 统一接口接入的模型，具体能力边界建议结合控制台实时配置确认。

适用场景

需要根据文本生成短视频片段时
做广告概念、镜头预演或产品演示素材时
先验证异步作业链路，再扩展到更复杂的视频工作流时

接入说明

图片与视频模型统一使用图片与多媒体 Base URL https://img.gpt88.cc。
第一次接入时，建议先用 /v1/videos/generations 验证 API Key、模型名 doubao-seedance-2.0-face 和当前线路是否匹配。
媒体类模型通常先验证上传 / 返回结构，再扩展到正式的素材或媒体管线。

使用提醒

价格、限速、SLA、上下文长度、是否开放多模态等动态值以 gpt88.cc 控制台为准。
如果请求延迟偏高或连接不稳定，请先检查 API Key、模型、endpoint 和请求格式。

能力标签

该模型的能力标签以 gpt88.cc 控制台为准。本页只展示协议字段与请求示例，具体能力 / 推荐场景 / 上下文长度等信息会随上游版本变更，请在 gpt88.cc 控制台查看实时清单。

接口路径

POSThttps://img.gpt88.cc/v1/videos/generations

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。完整字段说明见当前模型页的 Video API 文档。

API 文档

Endpoint

POST /v1/videos/generations

Model ID

doubao-seedance-2.0-face

Content-Type

application/json

接口类型

视频生成接口，通常为异步任务

Base URL

媒体类接口使用 https://img.gpt88.cc，并按对应 endpoint 提交请求。

Headers / 鉴权

字段	类型	必填	说明
`Authorization`	string	必填	使用 `Bearer <GPT88_API_KEY>`。API Key 在 gpt88.cc 控制台创建。
`Content-Type`	string	必填	请求体格式。音频转写上传文件时使用 `multipart/form-data`。默认值：`application/json`
`Accept`	string	可选	非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。默认值：`application/json`

Authorizationstring必填
使用 Bearer <GPT88_API_KEY>。API Key 在 gpt88.cc 控制台创建。
Content-Typestring必填
请求体格式。音频转写上传文件时使用 multipart/form-data。
默认值：application/json
Acceptstring
非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。
默认值：application/json

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 gpt88.cc 控制台为准。

字段	类型	必填	说明
`model`	string	必填	当前模型 ID：`doubao-seedance-2.0-face`。复制时请保持大小写一致。
`prompt`	string	必填	视频画面、镜头运动、主体、风格和节奏描述。
`image_url`	string	可选	可选参考图，用于图生视频或首帧约束；是否支持取决于具体模型。
`duration`	integer	可选	目标视频时长，单位秒。可用范围以模型和控制台配置为准。默认值：`6`
`aspect_ratio`	string	可选	画幅比例，例如 `16:9`、`9:16`、`1:1`。默认值：`16:9`

modelstring必填
当前模型 ID：doubao-seedance-2.0-face。复制时请保持大小写一致。
promptstring必填
视频画面、镜头运动、主体、风格和节奏描述。
image_urlstring
可选参考图，用于图生视频或首帧约束；是否支持取决于具体模型。
durationinteger
目标视频时长，单位秒。可用范围以模型和控制台配置为准。
默认值：6
aspect_ratiostring
画幅比例，例如 16:9、9:16、1:1。
默认值：16:9

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

字段	类型	必填	说明
`id`	string	必填	视频生成任务 ID，用于后续查询任务状态。
`status`	string	必填	任务状态，例如 `queued`、`processing`、`succeeded`。
`model`	string	必填	本次使用的模型 ID。
`url`	string	可选	任务完成后的视频文件 URL；异步任务未完成时可能为空。

idstring必填
视频生成任务 ID，用于后续查询任务状态。
statusstring必填
任务状态，例如 queued、processing、succeeded。
modelstring必填
本次使用的模型 ID。
urlstring
任务完成后的视频文件 URL；异步任务未完成时可能为空。

状态码

字段	类型	必填	说明
`200`	OK	必填	请求已被接受或任务创建成功，响应中包含任务状态和任务 ID。
`400`	Bad Request	可选	请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
`401`	Unauthorized	可选	API Key 缺失、无效或格式错误。
`404`	Not Found	可选	Endpoint 或模型不存在。请确认路径为 `/v1/videos/generations`，模型 ID 为 `doubao-seedance-2.0-face`。
`429`	Rate Limited	可选	触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
`5xx`	Upstream Error	可选	上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

200OK必填
请求已被接受或任务创建成功，响应中包含任务状态和任务 ID。
400Bad Request
请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
401Unauthorized
API Key 缺失、无效或格式错误。
404Not Found
Endpoint 或模型不存在。请确认路径为 /v1/videos/generations，模型 ID 为 doubao-seedance-2.0-face。
429Rate Limited
触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
5xxUpstream Error
上游或请求异常。保持统一 Base URL 重试，并保留请求 ID 便于排查。

错误与排查

401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
404：检查 endpoint 是否为 /v1/videos/generations，以及模型名 doubao-seedance-2.0-face 是否在控制台可见。
429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
5xx：保持统一 Base URL 重试，并记录请求 ID 方便排障。

请求示例

curl https://img.gpt88.cc/v1/videos/generations \
  -H "Authorization: Bearer $GPT88_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-face",
    "prompt": "镜头从城市夜景缓缓推近一栋发光的摩天楼",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

期望响应（精简示例）：

200 OKjson

{
  "id": "video_doubao-s",
  "status": "queued",
  "model": "doubao-seedance-2.0-face",
  "created": 1730000000
}