Corvus AI

# Seedance 2.0 视频生成 API 对接文档（用户版） 更新时间：2026-10-16。 本服务提供异步视频生成 API。提交提示词和可选参考图片后，保存任务 ID，再轮询查询结果。可以从自己的后端程序、网站服务或支持自定义视频接口的第三方软件调用，无需安装 Corvas 画布或保持网页登录。 - 服务地址：`https://ai.ravenhash.org` - Base URL：`https://ai.ravenhash.org/v1` - 模型名：`b_seedance_v2.0` - 编码：UTF-8；请求及任务响应格式：JSON。 - 当前型号：固定 **15 秒**，支持 **9:16 / 16:9**，最多 **9 张参考图片**。 - 标准售价：**2 元/次**。账号分组和优惠以本站实际账单为准。 本文按本站 New API 已开放的协议编写。模型广场出现的 OpenAI 标签不代表本模型支持聊天接口；不要通过 `/v1/chat/completions` 或图片接口提交视频任务。 ## 1. 鉴权 模型查询、任务提交和任务查询统一使用： ```http Authorization: Bearer YOUR_API_KEY ``` 在本站“令牌”页面创建或选择 Key，分组选 **Seedance 2.0**，或使用包含此分组的 **auto** 配置。如果开启模型限制，需要允许 `b_seedance_v2.0`。先调用 `GET /v1/models` 确认当前 Key 可以看到这个模型。 Key 的有效期、额度及 IP 限制以令牌设置为准，不是所有 Key 都永久有效。API Key 保存在自己的服务端环境变量中，网页前端通过自己的后端调用。 本文约定 Bearer Header，不使用 URL 参数传递 Key，也不依赖网页登录 Cookie。视频签名下载链接的鉴权方式见第 5 节。 ## 2. 参考图处理 ### 2.1 公网图片链接 将参考图片上传到自己的对象存储或其他允许访问的文件服务，再传入图片直链： ```json { "reference_images": [ "https://example.com/subject.png", "https://example.com/scene.jpg" ] } ``` `example.com` 仅作示例，调用前替换为真实可访问的图片地址。图片链接在任务处理期间应持续有效，不应要求登录或额外认证头。 图片按数组顺序提交。提示词可写“第 1 张参考图是主体，第 2 张参考图是场景”。本地文件名或提示词里的 `@文件名` 不会自动上传文件。 ### 2.2 已处理的图片 如需裁剪、压缩或打码，调用方先完成处理，再将处理后的公网图片 URL 放入 `reference_images`。本站接口不提供图片上传或人脸打码服务，不需要向本站提交第三方图片处理服务的 Key。 本型号只支持图片参考，不支持视频或音频参考；不接收本地路径、图片 Base64、`mediakit://` 引用或 multipart 文件上传。 ## 3. 视频生成接口 端点：**POST `/v1/videos`**。 ```http Content-Type: application/json Authorization: Bearer YOUR_API_KEY ``` 请求参数： - `model`：必填字符串，固定为 `b_seedance_v2.0`。 - `prompt`：必填非空字符串，描述主体、动作、场景、镜头和参考图用途。 - `seconds`：整数，当前型号只能为 `15`；省略也按 15 秒处理。 - `aspect_ratio`：字符串，只支持 `9:16`、`16:9`，默认 `9:16`。 - `reference_images`：可选字符串数组，最多 9 个公网图片 URL；文生视频可省略。 兼容字段：`duration` 等价于 `seconds`，`ratio` 等价于 `aspect_ratio`，`image_urls` 或 `images` 可代替 `reference_images`。图片数组也支持 `{ "url": "https://..." }` 元素。单图可用 `input_reference`。每类参数建议只用一种写法；多个别名同时出现时内容必须一致，`input_reference` 不可与非空图片数组混用。 当前没有可选择的输出分辨率，不使用 `resolution`、`size` 指定 720p、1080p 或 4K。不要填写 5/10/30 秒或 1:1，也不要提交视频、音频参考字段。 ### 纯文本示例 以下 shell 示例中的 `$API_KEY` 从调用方环境变量读取： ```bash curl -sS "https://ai.ravenhash.org/v1/videos" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ --data-binary '{ "model": "b_seedance_v2.0", "prompt": "海浪拍打礁石，固定镜头，柔和自然光，动作连贯，无字幕。", "seconds": 15, "aspect_ratio": "16:9" }' ``` ### 带参考图示例 ```bash curl -sS "https://ai.ravenhash.org/v1/videos" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ --data-binary '{ "model": "b_seedance_v2.0", "prompt": "第1张参考图是主体，第2张参考图是场景。主体缓慢走入场景，保持外观一致，固定镜头，无字幕。", "seconds": 15, "aspect_ratio": "9:16", "reference_images": [ "https://example.com/subject.png", "https://example.com/scene.jpg" ] }' ``` 提交成功后读取响应的 **`id` 字段**。任务 ID 是本站生成的字符串，例如 `task_example`；把它完整保存，不要转为数字，也不要使用其他系统的任务编号替换。 响应结构示意，具体值以实际返回为准： ```json { "id": "task_example", "object": "video", "model": "b_seedance_v2.0", "status": "

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。

原站公开的站内额度标价；充值折扣、规格附加费及最终扣费以原站为准。