豆包 Seedream 生图参考 - SocialVision AI Gateway

取消任务

DELETE /volc/v1/contents/generations/tasks/{task_id} 取消尚未完成的视频生成任务。

请求参数 (Query / Path)

string

required

异步任务 ID

请求示例 (cURL)

curl -X DELETE "https://socialvision.tisyk.xyz/volc/v1/contents/generations/tasks/{task_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "status": "succeed"
  },
  "message": "success"
}

doubao-2.0 查询视频生成任务 API

GET /api/v3/contents/generations/tasks/{id} https://www.volcengine.com/docs/82379/1521309?lang=zh

请求参数 (Query / Path)

string

required

路径中的资源 / 任务 ID

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/api/v3/contents/generations/tasks/{id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177831701906400000000000000000000ffffac1778adc6a32f.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260509%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260509T090109Z&X-Tos-Expires=86400&X-Tos-Signature=699d4a345c3573c9b86f2f145db21c00bfd32d7f8d1fe0bbe499ce54d92a0af5&X-Tos-SignedHeaders=host"
  },
  "created_at": 1778317019,
  "draft": false,
  "duration": 10,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "cgt-20260509165650-6rxbv",
  "model": "doubao-seedance-2-0-260128",
  "ratio": "1:1",
  "resolution": "720p",
  "seed": 70882,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1778317294,
  "usage": {
    "completion_tokens": 216900,
    "total_tokens": 216900
  }
}

doubao-2.0 查询视频生成任务列表

GET /api/v3/contents/generations/tasks https://www.volcengine.com/docs/82379/1521675?lang=zh

请求参数 (Query / Path)

string

每页条数

string

按状态过滤

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "status": "succeed"
  },
  "message": "success"
}

查询单个任务

GET /volc/v1/contents/generations/tasks/{task_id} 根据 task_id 查询单个视频生成任务的状态与结果。

请求参数 (Query / Path)

string

required

异步任务 ID

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/volc/v1/contents/generations/tasks/{task_id}" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "status": "succeed"
  },
  "message": "success"
}

查询任务列表

GET /volc/v1/contents/generations/tasks 分页查询任务列表。

请求参数 (Query / Path)

integer

每页条数

请求示例 (cURL)

curl "https://socialvision.tisyk.xyz/volc/v1/contents/generations/tasks" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "status": "succeed"
  },
  "message": "success"
}

创建视频生成任务 API（doubao-2.0)

POST /api/v3/contents/generations/tasks Seedance 2.0 官方视频生成协议（/api/v3/contents/generations/tasks）。本路径亦在 seedance router 注册；与旧版 /volc/v1/* 豆包路由并存。content 数组项按 type 区分：text 仅需 text 字段，image_url/video_url/audio_url 需对应 URL 对象与 role。 https://www.volcengine.com/docs/82379/1520757?lang=zh

请求体参数 (Body)

array

required

内容数组；按 type 区分：text 仅需 text，image_url/video_url/audio_url 需对应 URL 与 role。

integer

时长（秒或平台约定单位）

boolean

是否生成音频

string

required

模型名称 / 型号 ID

string

宽高比或分辨率比例

boolean

是否添加水印

请求示例 (JSON)

{
  "content": [
    {
      "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "role": "reference_video",
      "type": "video_url",
      "video_url": {
        "url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
      }
    },
    {
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio",
      "type": "audio_url"
    }
  ],
  "duration": 11,
  "generate_audio": true,
  "model": "doubao-seedance-2-0-260128",
  "ratio": "21:9",
  "watermark": false
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": [
    {
      "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      },
      "role": "reference_image",
      "type": "image_url"
    },
    {
      "role": "reference_video",
      "type": "video_url",
      "video_url": {
        "url": "https://pro.filesystem.site/cdn/20260403/0e80a635b859e7716671a40d836135.mp4"
      }
    },
    {
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio",
      "type": "audio_url"
    }
  ],
  "duration": 11,
  "generate_audio": true,
  "model": "doubao-seedance-2-0-260128",
  "ratio": "21:9",
  "watermark": false
}'

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}

Seedream 5.0 Pro

POST /api/v3/images/generations

请求体参数 (Body)

number

与 prompt 的一致程度，范围 [1, 10]

any

参考图（官方字段）。单张 URL 字符串，或多张 URL 数组（交互编辑/图生图，最多约 10 张）

any

兼容字段；网关会归一到 image。与 image 二选一即可

string

required

模型名称

integer

生成张数，Pro 通常为 1

object

提示词优化配置

string

图片文件格式

string

required

生成/编辑提示词

string

返回形态

integer

随机种子，范围 [-1, 2147483647]，默认 -1

string

分辨率档或像素尺寸。常用 1K/2K；也支持如 1024x1024、2048x2048、2816x1584 等。空值按高档计费

boolean

是否添加水印

请求示例 (JSON)

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "一只猫",
  "response_format": "url",
  "size": "2K",
  "watermark": false
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/api/v3/images/generations" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "一只猫",
  "response_format": "url",
  "size": "2K",
  "watermark": false
}'

响应示例 (200 OK)

{
  "code": 0,
  "data": {
    "task_id": "task_example_001"
  },
  "message": "success"
}

创建视频生成任务

POST /volc/v1/contents/generations/tasks 提交 Seedance/豆包视频生成任务。

请求体参数 (Body)

string

任务完成回调 URL

array

required

文本/图片内容数组

string

required

模型名称

请求示例 (JSON)

{
  "content": [
    {
      "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}

请求示例 (cURL)

curl -X POST "https://socialvision.tisyk.xyz/volc/v1/contents/generations/tasks" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": [
    {
      "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      },
      "type": "image_url"
    }
  ],
  "duration": 4,
  "model": "doubao-seedance-1-5-pro-251215",
  "ratio": "adaptive",
  "watermark": false
}'

响应示例 (200 OK)

{
  "id": "cgt-20250918170228-dw9rb",
  "status": "submitted"
}

​取消任务

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​doubao-2.0 查询视频生成任务 API

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​doubao-2.0 查询视频生成任务列表

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​查询单个任务

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​查询任务列表

​请求参数 (Query / Path)

​请求示例 (cURL)

​响应示例 (200 OK)

​创建视频生成任务 API（doubao-2.0)

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​Seedream 5.0 Pro

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

​创建视频生成任务

​请求体参数 (Body)

​请求示例 (JSON)

​请求示例 (cURL)

​响应示例 (200 OK)

取消任务

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

doubao-2.0 查询视频生成任务 API

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

doubao-2.0 查询视频生成任务列表

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

查询单个任务

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

查询任务列表

请求参数 (Query / Path)

请求示例 (cURL)

响应示例 (200 OK)

创建视频生成任务 API（doubao-2.0)

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

Seedream 5.0 Pro

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)

创建视频生成任务

请求体参数 (Body)

请求示例 (JSON)

请求示例 (cURL)

响应示例 (200 OK)