FocalAPI Docs
API 参考视频创作

创建视频生成任务

POST
/v1/video/generations

通过当前 Seedance、Gemini Omni、Kling、Vidu、LTX、FLUX 与 Grok Imagine 视频模型提交文生视频、图生视频或参考媒体任务。返回任务 ID 后通过 GET 接口查询状态;各模型的时长、分辨率、比例和 content 约束以模型详情为准。

Authorization

BearerAuth
AuthorizationBearer <token>

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

In: header

Header Parameters

Idempotency-Key?string

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

Lengthlength <= 128

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

视频生成请求

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2-5-260628",    "prompt": "镜头缓慢推进雨中的城市霓虹街道",    "duration": 5,    "metadata": {      "resolution": "720p",      "ratio": "16:9",      "generate_audio": true    }  }'
{  "task_id": "abcd1234efgh",  "status": "queued"}