Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
生数科技 Vidu 视频生成接口
/ent/v2/... 原生路径。
POST /v1/videosPOST /v1/video/generationsGET /v1/videos/{task_id}GET /v1/videos/{task_id}/content| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 平台开放给你的 Vidu 模型名，例如 vidu q3、vidu q3-pro、vidu q3-turbo |
prompt | string | 是 | 提示词 |
duration | integer | 否 | 常见时长，如 4、8 |
seed | integer | 否 | 随机种子 |
aspect_ratio | string | 否 | 16:9、9:16、1:1 |
resolution | string | 否 | 360p、720p、1080p |
movement_amplitude | string | 否 | auto、small、medium、large |
images | array | 否 | 图生视频或参考图场景时使用 |
metadata | object | 否 | 透传扩展参数 |
curl https://your-domain.com/v1/videos \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "vidu q3",
"prompt": "海边日落，海鸥飞过",
"duration": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'
| 参数 | 必填 | 说明 |
|---|---|---|
images | 是 | 图片 URL 数组，常见为 1 张 |
prompt | 否 | 提示词 |
duration | 否 | 时长 |
curl https://your-domain.com/v1/videos \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "vidu q3",
"prompt": "镜头缓慢推进，人物转头微笑",
"images": ["https://example.com/first-frame.png"],
"duration": 4
}'
{
"task_id": "task_xxxxxxxx",
"status": "queued"
}
/v1/videos/{task_id}
典型查询结果：
{
"id": "task_xxxxxxxx",
"task_id": "task_xxxxxxxx",
"object": "video",
"status": "completed",
"progress": 100,
"created_at": 1712000000,
"completed_at": 1712000028,
"metadata": {
"url": "https://.../output.mp4"
}
}
curl -L https://your-domain.com/v1/videos/task_xxxxxxxx/content \
-H "Authorization: Bearer sk-xxxx" \
-o output.mp4
| 状态 | 说明 |
|---|---|
queued | 排队中 |
in_progress | 生成中 |
completed | 已完成 |
failed | 失败 |
images、movement_amplitude 这类扩展字段。