Skip to main content

​
简介

Seedance 官方镜像 API 与 BytePlus Ark Seedance 官方接口 请求体、响应体完全一致，只有 Base URL 和鉴权方式不同。已有官方 SDK 调用代码只需改 base_url 与 Authorization 即可接入。 Base URL：https://api.gravitex.ai
这与平台通用接口（/v1/video/generations、/v1/assets 等）是另一套独立接口：素材库数据互通，视频任务路由互不干扰。

​
认证

所有接口：Authorization: Bearer sk-{your_token_key}，Content-Type: application/json。

​
素材库类型

推荐流程：创建素材组 → CreateAsset → 轮询至 Status: Active → 创建任务 → 查询任务。

​
接口目录

​
视频生成任务

创建任务

POST /api/v3/contents/generations/tasks

查询任务

GET /api/v3/contents/generations/tasks/

取消/删除任务

DELETE /api/v3/contents/generations/tasks/

​
素材库（统一信封 Action）

所有素材库操作走同一端点，用 Action 查询参数区分：
响应为 { ResponseMetadata, Result } 信封（真人核验两个 Action 除外，为扁平结构）。

CreateAssetGroup

创建素材组（强制 AIGC）

CreateAsset

创建素材

ListAssetGroups

查询素材组列表

ListAssets

查询素材列表

GetAsset

查询单个素材

GetAssetGroup

查询单个素材组

UpdateAsset

更新素材（Name）

UpdateAssetGroup

更新素材组（Name/Description）

DeleteAsset

删除素材

DeleteAssetGroup

删除素材组（级联）

​
真人素材库（LivenessFace）

CreateVisualValidateSession

发起真人核验会话

GetVisualValidateResult

查询核验结果并创建素材组

​
推荐流程

  1. （可选）CreateAssetGroup → CreateAsset → 轮询至 Status: Active
  2. POST /api/v3/contents/generations/tasks 提交任务
  3. GET /api/v3/contents/generations/tasks/{id} 轮询至 succeeded
  4. 需要时可 DELETE 取消排队中任务或清理已完成记录

​
错误处理

素材库错误走信封 ResponseMetadata.Error.{Code,Message}： 视频生成任务 API 错误会返回相应的上游状态码和错误体。