创建视频生成任务
POST
/v1/video/generations
提交视频生成任务,支持文生视频和图生视频
请求参数
请求头
Authorization
使用 Bearer Token 认证。格式:Authorization: Bearer sk-xxxxxx
请求体
请求体参数(12 个)
| 参数 | 类型 | 默认值 | 说明 | 是否必填 |
|---|---|---|---|---|
model | string | — | 模型或风格 ID,例如 kling-v1。 | 否 |
prompt | string | — | 文本描述提示词。文生视频通常使用此字段。 | 否 |
image | string | — | 图片 URL 或 Base64 编码。图生视频时使用。 | 否 |
duration | number | — | 视频时长,单位为秒。 | 否 |
width | integer | — | 视频宽度。 | 否 |
height | integer | — | 视频高度。 | 否 |
fps | integer | — | 视频帧率。 | 否 |
seed | integer | — | 随机种子。 | 否 |
n | integer | — | 生成视频数量。 | 否 |
response_format | string | — | 响应格式,例如 url。 | 否 |
user | string | — | 最终用户标识。 | 否 |
metadata | object | — | 扩展参数,例如 negative_prompt、style 或 quality_level。 | 否 |
提示词和图片输入是否必需取决于所选模型;请至少提供模型支持的一种输入方式。
请求示例代码
curl -X POST "https://10000router.com/v1/video/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-v1",
"prompt": "宇航员站起身走了",
"duration": 5,
"width": 1280,
"height": 720
}'const payload = {
model: "kling-v1",
prompt: "宇航员站起身走了",
duration: 5,
width: 1280,
height: 720
};
const response = await fetch("https://10000router.com/v1/video/generations", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" },
body: JSON.stringify(payload)
});
console.log(await response.json());payload := strings.NewReader(`{"model":"kling-v1","prompt":"宇航员站起身走了","duration":5,"width":1280,"height":720}`)
req, _ := http.NewRequest("POST", "https://10000router.com/v1/video/generations", payload)
req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer res.Body.Close()import os
import requests
payload = {"model": "kling-v1", "prompt": "宇航员站起身走了", "duration": 5, "width": 1280, "height": 720}
response = requests.post(
"https://10000router.com/v1/video/generations",
headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
json=payload,
)
response.raise_for_status()
print(response.json())var payload = "{\"model\":\"kling-v1\",\"prompt\":\"宇航员站起身走了\",\"duration\":5,\"width\":1280,\"height\":720}";
var request = java.net.http.HttpRequest.newBuilder(java.net.URI.create("https://10000router.com/v1/video/generations"))
.header("Authorization", "Bearer " + System.getenv("API_KEY"))
.header("Content-Type", "application/json")
.POST(java.net.http.HttpRequest.BodyPublishers.ofString(payload)).build();
var response = java.net.http.HttpClient.newHttpClient().send(request, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new("Bearer", Environment.GetEnvironmentVariable("API_KEY"));
var payload = new { model = "kling-v1", prompt = "宇航员站起身走了", duration = 5, width = 1280, height = 720 };
var response = await client.PostAsJsonAsync("https://10000router.com/v1/video/generations", payload);
Console.WriteLine(await response.Content.ReadAsStringAsync());返回响应
响应示例
{
"task_id": "abcd1234efgh",
"status": "queued"
}{
"error": {
"message": "Invalid video generation parameters",
"type": "invalid_request_error",
"param": "prompt",
"code": null
}
}返回任务 ID,可通过查询通用视频生成任务查询任务状态
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务 ID,用于查询任务状态。 |
status | string | 初始任务状态,通常为 queued。 |