OneKeyModel LogoOneKeyModel

Seedance 视频生成

Seedance 2.0 视频生成与素材库接口说明。

基础地址与鉴权

所有请求使用统一 Base URL，并在请求头中携带 API 密钥。

Base URL
https://api.onekeymodel.com/v1
鉴权请求头格式
Authorization: Bearer YOUR_API_KEY

支持的模型

以下 Seedance 2.0 模型可通过视频生成接口调用：

seedance2_0seedance2_0_fastseedance2_0_mini

视频生成接口

视频生成分为两步：提交任务并轮询结果。通过网关调用时，Seedance 参数放在 metadata 中，prompt 会自动转为 content 文本项。

步骤 1：创建视频任务POST /v1/video/generations
提交生成参数，立即返回包含 id 的任务记录。

文生视频

bash
curl -X POST https://api.onekeymodel.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "seedance2_0",
    "prompt": "一只猫在海边奔跑，电影感镜头，阳光，慢动作",
    "metadata": {
      "ratio": "16:9",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true,
      "bitrate_mode": "standard",
      "watermark": false
    }
  }'

图生视频

bash
curl -X POST https://api.onekeymodel.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "seedance2_0",
    "prompt": "让图片中的人物向镜头微笑并挥手",
    "metadata": {
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/input.png" },
          "role": "first_frame"
        }
      ],
      "ratio": "adaptive",
      "duration": 5,
      "resolution": "720p",
      "watermark": false
    }
  }'

使用素材库 asset://

bash
curl -X POST https://api.onekeymodel.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "seedance2_0",
    "prompt": "基于参考素材生成一段产品展示视频",
    "metadata": {
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "asset://Asset-2026xxxx" },
          "role": "reference_image"
        }
      ],
      "ratio": "16:9",
      "duration": 5,
      "resolution": "720p"
    }
  }'

响应示例

json
{ "id": "task_xxx" }
步骤 2：查询视频任务GET /v1/video/generations/:task_id
使用返回的 id 每隔几秒查询一次。状态变为 SUCCESS 后，可从 result_url 获取视频链接。
bash
curl -X GET "https://api.onekeymodel.com/v1/video/generations/task_xxx" \
  -H "Authorization: Bearer $YOUR_API_KEY"

响应示例

json
{
  "code": "success",
  "data": {
    "task_id": "task_xxx",
    "status": "SUCCESS",
    "result_url": "https://example.com/video.mp4"
  }
}

请求参数

通过 OneKeyModel 网关调用时，除 model 和 prompt 外，其余参数放在 metadata 对象中。

网关会将 prompt 自动追加为 content 中的 type=text 项。若已传入 metadata.content，prompt 仍会追加为文本项。

请求参数

参数类型必填说明
modelstring是模型名。当前支持 seedance2_0、seedance2_0_fast、seedance2_0_mini
promptstring是文本提示词。网关会自动转为 content 中的 type=text 项
metadata.contentarray否输入内容数组，可包含图片、视频、音频素材
metadata.generate_audioboolean否是否生成音频
metadata.bitrate_modestring否码率模式，例如 standard、high
metadata.resolutionstring否输出分辨率，例如 480p、720p、1080p、4k。不同模型支持范围不同
metadata.ratiostring否视频比例。常见值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive
metadata.durationinteger否视频时长，常见范围 4 到 15 秒
metadata.watermarkboolean否是否带水印

content 数组元素

content 为数组，用于传入图片、视频、音频等素材。素材库引用使用 asset:// 地址。

json
// Image
{ "type": "image_url", "image_url": { "url": "https://example.com/image.png" }, "role": "reference_image" }

// Video
{ "type": "video_url", "video_url": { "url": "https://example.com/video.mp4" }, "role": "reference_video" }

// Audio
{ "type": "audio_url", "audio_url": { "url": "https://example.com/audio.mp3" }, "role": "reference_audio" }

// Asset library
{ "type": "image_url", "image_url": { "url": "asset://Asset-2026xxxx" }, "role": "reference_image" }

常见 role 值

role说明
first_frame首帧图片
last_frame尾帧图片
reference_image参考图片
reference_video参考视频
reference_audio参考音频

任务状态

status说明
QUEUED排队中或已提交
IN_PROGRESS处理中
SUCCESS成功
FAILURE失败

素材库接口

统一入口，通过 Action 参数调用不同操作。Version 可省略，默认 2024-01-01。

统一端点POST /v1/seedance_asset
https://api.onekeymodel.com/v1/seedance_asset?Action={Action}&Version=2024-01-01

通用参数

参数类型必填说明
Actionquery是素材库操作名称（query），也兼容小写 action
Versionquery否OpenAPI 版本，默认 2024-01-01，也兼容小写 version
ProjectNamebody否Ark 项目名，可按需传入（body）

支持的 Action

CreateAssetGroupCreateAssetListAssetGroupsListAssetsGetAssetGetAssetGroupUpdateAssetGroupUpdateAssetDeleteAssetDeleteAssetGroup
CreateAssetGroup — 创建素材分组
创建素材分组，用于组织上传的素材。
bash
curl -X POST "https://api.onekeymodel.com/v1/seedance_asset?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "Name": "seedance-demo-group",
    "Description": "Seedance demo assets",
    "GroupType": "AIGC"
  }'
CreateAsset — 创建素材
通过 URL 创建素材。创建后通常进入 Processing 状态，处理完成后才可用于视频生成。
bash
curl -X POST "https://api.onekeymodel.com/v1/seedance_asset?Action=CreateAsset&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "GroupId": "group-2026xxxx",
    "URL": "https://example.com/input.png",
    "Name": "demo-image",
    "AssetType": "Image",
    "Moderation": { "Strategy": "Skip" }
  }'
json
{ "Result": { "Id": "Asset-2026xxxx" } }
ListAssetGroups — 查询素材分组列表
分页查询素材分组列表。
bash
curl -X POST "https://api.onekeymodel.com/v1/seedance_asset?Action=ListAssetGroups&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "Filter": { "GroupType": "AIGC" },
    "PageNumber": 1,
    "PageSize": 10,
    "SortBy": "CreateTime",
    "SortOrder": "Desc"
  }'
ListAssets — 查询素材列表
分页查询素材列表，可按分组和状态过滤。
bash
curl -X POST "https://api.onekeymodel.com/v1/seedance_asset?Action=ListAssets&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "Filter": {
      "GroupType": "AIGC",
      "GroupIds": ["group-2026xxxx"],
      "Statuses": ["Active"]
    },
    "PageNumber": 1,
    "PageSize": 10,
    "SortBy": "CreateTime",
    "SortOrder": "Desc"
  }'
GetAsset — 查询单个素材
根据 Asset ID 获取素材详情。
bash
curl -X POST "https://api.onekeymodel.com/v1/seedance_asset?Action=GetAsset&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{ "Id": "Asset-2026xxxx" }'

素材状态

Status说明
Active已处理完成，可用于视频生成
Processing正在预处理，暂不可用
Failed处理失败

还支持 GetAssetGroup、UpdateAssetGroup、UpdateAsset、DeleteAsset、DeleteAssetGroup 等 Action。

推荐工作流

结合素材库与视频生成的典型使用流程：

  • 1. 创建素材分组（CreateAssetGroup）
  • 2. 上传素材（CreateAsset），等待状态变为 Active，获取 Asset ID
  • 3. 提交视频任务并轮询，获取最终视频链接