创建视频生成任务

POST /v1/video/generations

提交视频生成任务,支持文生视频和图生视频

请求参数

请求头

Authorization

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

请求体

请求体参数(12 个)
参数类型默认值说明是否必填
modelstring—模型或风格 ID,例如 kling-v1。否
promptstring—文本描述提示词。文生视频通常使用此字段。否
imagestring—图片 URL 或 Base64 编码。图生视频时使用。否
durationnumber—视频时长,单位为秒。否
widthinteger—视频宽度。否
heightinteger—视频高度。否
fpsinteger—视频帧率。否
seedinteger—随机种子。否
ninteger—生成视频数量。否
response_formatstring—响应格式,例如 url。否
userstring—最终用户标识。否
metadataobject—扩展参数,例如 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_idstring任务 ID,用于查询任务状态。
statusstring初始任务状态,通常为 queued。

results matching ""

    No results matching ""