AgentPivot 海外 API 使用手册

Base URL（海外统一）：https://api.agentpivot.ai 鉴权方式：x-api-key: your-api-key 或 Authorization: Bearer your-api-key Content-Type：application/json

第一部分：Seedance 2.0 视频生成 API（海外版 · seedance-global）

一、接口列表

方法	接口路径	说明
`POST`	`/api/v3/seedance-global/contents/generations/tasks`	创建视频生成任务
`GET`	`/api/v3/seedance-global/contents/generations/tasks`	查询视频生成任务列表
`GET`	`/api/v3/seedance-global/contents/generations/tasks/{taskId}`	查询视频生成任务
`POST`	`/api/v3/seedance-global/contents/generations/tasks/{taskId}/reconcile-billing/admin`	查询任务并补全计费
`POST`	`/api/v3/seedance-global/contents/generations/tasks/{taskId}/cancel`	取消 / 删除视频生成任务

二、基础信息

项目	值
Base URL（海外）	`https://api.agentpivot.ai`
路径前缀	`/api/v3/seedance-global/...`
鉴权（二选一）	`x-api-key: your-api-key` `Authorization: Bearer your-api-key`
Content-Type	`application/json`
余额建议	≥ ¥10

三、支持的模型

模型名称
`dreamina-seedance-2-0-260128`
`dreamina-seedance-2-0-fast-260128`
`dreamina-seedance-2-0-mini-260615`

⚠️ 使用完整模型名，不要用 doubao-seedance-2.0 简写。

四、创建视频生成任务

请求

POST https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks
Content-Type: application/json
x-api-key: your-api-key

请求体参数

参数	类型	必填	说明
`model`	string	是	模型名称
`content`	array	是	输入内容数组
`content[].type`	string	是	`text` 或 `image_url`
`content[].text`	string	条件必填	`type=text` 时的提示词
`content[].image_url.url`	string	条件必填	`type=image_url` 时的图片 URL
`ratio`	string	否	`16:9` / `9:16` / `1:1` / `adaptive`
`resolution`	string	否	如 `720p`
`duration`	integer	否	时长（秒），如 `5`、`10`
`generate_audio`	boolean	否	是否生成音频
`watermark`	boolean	否	是否加水印

示例 1：图生视频

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "女孩抱着狐狸，温柔地看向镜头，镜头缓缓拉出，头发被风吹动，可以听到风声"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
        }
      }
    ],
    "generate_audio": true,
    "ratio": "adaptive",
    "duration": 5,
    "watermark": false
  }'

示例 2：文生视频

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "content": [
      { "type": "text", "text": "女孩抱着狐狸，镜头缓慢拉远，头发随风飘动" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'

创建成功响应

json

{
  "id": "cgt-20260512160924-r56z5",
  "object": "video",
  "model": "dreamina-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1778573371
}

五、查询视频生成任务

bash

curl "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks/cgt-20260512160924-r56z5" \
  -H "x-api-key: your-api-key"

响应字段

字段	说明
`id`	任务 ID
`status`	`queued` / `generating` / `succeeded` / `failed`
`content.video_url`	视频下载地址（成功时返回）
`error`	错误信息（失败时返回）

⚠️ 成功状态实际返回 succeeded，轮询请兼容 success / succeeded。

六、查询任务列表

bash

curl "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks" \
  -H "x-api-key: your-api-key"

七、查询任务并补全计费（Admin）

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks/cgt-20260512160924-r56z5/reconcile-billing/admin" \
  -H "x-api-key: your-api-key"

八、取消 / 删除任务

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/contents/generations/tasks/cgt-20260512160924-r56z5/cancel" \
  -H "x-api-key: your-api-key"

Seedance 接口速查表

操作	方法	路径（省略 Base URL）
创建任务	POST	`/api/v3/seedance-global/contents/generations/tasks`
任务列表	GET	`/api/v3/seedance-global/contents/generations/tasks`
查询任务	GET	`/api/v3/seedance-global/contents/generations/tasks/{taskId}`
补全计费	POST	`/api/v3/seedance-global/contents/generations/tasks/{taskId}/reconcile-billing/admin`
取消任务	POST	`/api/v3/seedance-global/contents/generations/tasks/{taskId}/cancel`

第二部分：素材（Assets）API（海外版）

路径前缀：/api/v3/seedance-global/assets 鉴权：x-api-key: your-api-key 或 Authorization: Bearer your-api-key

一、接口列表

方法	接口路径	说明
`POST`	`/api/v3/seedance-global/asset-groups`	创建素材组
`POST`	`/api/v3/seedance-global/assets`	URL 导入素材
`POST`	`/api/v3/seedance-global/assets/sync`	同步 URL 导入
`POST`	`/api/v3/seedance-global/assets/upload`	本地上传素材
`POST`	`/api/v3/seedance-global/assets/sync-upload`	同步本地上传
`GET`	`/api/v3/seedance-global/assets/importable`	可导入素材列表
`POST`	`/api/v3/seedance-global/assets/import`	批量导入素材
`GET`	`/api/v3/seedance-global/assets/{id}`	查询素材状态
`DELETE`	`/api/v3/seedance-global/assets/{id}`	删除素材

二、基础信息

项目	值
Base URL（海外）	`https://api.agentpivot.ai`
路径前缀	`/api/v3/seedance-global/assets`
鉴权	`x-api-key: your-api-key`
Content-Type	`application/json`（上传接口为 `multipart/form-data`）

创建素材组

bash

curl -i -X POST "https://api.agentpivot.ai/api/v3/seedance-global/asset-groups" \
  -H "Authorization: Bearer sk-xxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "name":"xxx",
          "channel_id": 33
      }' |jq

"channel_id": 33 为不可缺少字段，不可随意改动

三、URL 导入素材

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/assets" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
        "group_id": xxxx,
        "asset_type": "image",
        "name": "参考图",
        "url": "https://example.com/image.png"
  }' | jq

通过远程 URL 异步导入素材，返回素材 ID，可用「查询素材状态」轮询。

四、同步 URL 导入

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/assets/sync" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
      "group_id": xxxx,
      "asset_type": "image",
      "name": "参考图",
    "url": "https://example.com/image.png"
  }' | jq

同步方式导入，请求返回时即完成导入（适合小文件）。

五、本地上传素材

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/assets/upload" \
  -H "x-api-key: your-api-key" \
  -F 'group_id=xxx' \
  -F 'asset_type=image' \
  -F 'name=参考图' \
  -F "file=@/path/to/local/image.png" | jq

使用 multipart/form-data 上传本地文件，异步处理。

六、同步本地上传

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/assets/sync-upload" \
  -H "x-api-key: your-api-key" \
  -F 'group_id=xxxx' \
  -F 'asset_type=image' \
  -F 'name=参考图' \
  -F "file=@/path/to/local/image.png" | jq

同步上传，返回时即完成处理。

七、可导入素材列表

bash

curl "https://api.agentpivot.ai/api/v3/seedance-global/assets/importable" \
  -H "x-api-key: your-api-key" | jq

获取当前可批量导入的素材列表。

八、批量导入素材

bash

curl -X POST "https://api.agentpivot.ai/api/v3/seedance-global/assets/import" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "ids": [
      "asset-20260630192320-v8tv6",
      "asset-20260630192321-a1b2c"
    ]
  }' | jq

批量导入多个素材。

九、查询素材状态

bash

curl "https://api.agentpivot.ai/api/v3/seedance-global/assets/asset-20260630192320-v8tv6" \
  -H "x-api-key: your-api-key" | jq

路径参数

参数	说明
`id`	素材 ID

十、删除素材

bash

curl -X DELETE "https://api.agentpivot.ai/api/v3/seedance-global/assets/asset-20260630192320-v8tv6" \
  -H "x-api-key: your-api-key" | jq

路径参数

参数	说明
`id`	素材 ID

素材接口速查表

操作	方法	路径（省略 Base URL）
URL 导入素材	POST	`/api/v3/seedance-global/assets`
同步 URL 导入	POST	`/api/v3/seedance-global/assets/sync`
本地上传素材	POST	`/api/v3/seedance-global/assets/upload`
同步本地上传	POST	`/api/v3/seedance-global/assets/sync-upload`
可导入素材列表	GET	`/api/v3/seedance-global/assets/importable`
批量导入素材	POST	`/api/v3/seedance-global/assets/import`
查询素材状态	GET	`/api/v3/seedance-global/assets/{id}`
删除素材	DELETE	`/api/v3/seedance-global/assets/{id}`

AgentPivot 海外 API 使用手册 ​

目录 ​

第一部分：Seedance 2.0 视频生成 API（海外版 · seedance-global） ​

一、接口列表 ​

二、基础信息 ​

三、支持的模型 ​

四、创建视频生成任务 ​

请求 ​

请求体参数 ​

示例 1：图生视频 ​

示例 2：文生视频 ​

创建成功响应 ​

五、查询视频生成任务 ​

响应字段 ​

六、查询任务列表 ​

七、查询任务并补全计费（Admin） ​

八、取消 / 删除任务 ​

Seedance 接口速查表 ​

第二部分：素材（Assets）API（海外版） ​

一、接口列表 ​

二、基础信息 ​

创建素材组 ​

三、URL 导入素材 ​

四、同步 URL 导入 ​

五、本地上传素材 ​

六、同步本地上传 ​

七、可导入素材列表 ​

八、批量导入素材 ​

九、查询素材状态 ​

十、删除素材 ​

素材接口速查表 ​

AgentPivot 海外 API 使用手册

目录

第一部分：Seedance 2.0 视频生成 API（海外版 · seedance-global）

一、接口列表

二、基础信息

三、支持的模型

四、创建视频生成任务

请求

请求体参数

示例 1：图生视频

示例 2：文生视频

创建成功响应

五、查询视频生成任务

响应字段

六、查询任务列表

七、查询任务并补全计费（Admin）

八、取消 / 删除任务

Seedance 接口速查表

第二部分：素材（Assets）API（海外版）

一、接口列表

二、基础信息

创建素材组

三、URL 导入素材

四、同步 URL 导入

五、本地上传素材

六、同步本地上传

七、可导入素材列表

八、批量导入素材

九、查询素材状态

十、删除素材

素材接口速查表