FocalAPI 文档
API 参考视频创作

创建视频生成任务(ark 原生端点)

POST
/api/v3/contents/generations/tasks

ark/BytePlus 官方路径 /api/v3/contents/generations/tasks——ark 用户仅需更换 base URL 与 key 即可无缝迁移。请求体与响应结构与官方一致,返回任务 ID,轮询见 GET 同路径。

授权

BearerAuth
授权Bearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

位置: header

标头参数

Idempotency-Key?string

可选幂等键(8-128 个可打印 ASCII 字符)。同一 Key 的重复创建请求会返回原任务(idempotent_replay: true)而不重复计费;调用方在结果不确定的重试中应复用同一 Key。

长度length <= 128

请求主体

application/json

TypeScript 定义

在 TypeScript 中使用 request body 类型。

响应主体

application/json

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "dola-seedance-2-0-260628",    "content": [      {        "type": "text",        "text": "一只猫在窗台晒太阳 --ratio 16:9 --dur 5"      }    ]  }'
{  "id": "task_abc123"}