Create Video Generation Task
Submit a video generation task, supporting text-to-video and image-to-video.
Returns the task ID, which can be queried via the GET interface.
General Video Tasks
This entry supports most text-to-video and image-to-video channels. After creation, use GET /v1/video/generations/{task_id} to query; general fields prioritize using model, prompt, image/images, input_reference, seconds, size, with channel-specific parameters placed in metadata.
| Channel | Model |
|---|---|
| Sora OpenAI | sora-2, sora-2-pro |
| Seedance | doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-lite-t2v, doubao-seedance-1-0-lite-i2v, doubao-seedance-1-5-pro-251215, doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128 |
| Wan / Happyhorse | wan2.7-i2v-2026-04-25, wan2.7-i2v, wan2.5-i2v-preview, wan2.2-i2v-flash, wan2.2-i2v-plus, wanx2.1-i2v-plus, wanx2.1-i2v-turbo, happyhorse-1.0-t2v, happyhorse-1.0-r2v |
| Veo | veo-3.0-generate-001, veo-3.0-fast-generate-001, veo-3.1-generate-preview, veo-3.1-fast-generate-preview |
| Hailuo | MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, T2V-01, T2V-01-Director, I2V-01, I2V-01-live, I2V-01-Director, S2V-01 |
| Vidu | viduq2, viduq1, vidu2.0, vidu1.5 |
| Non-standard Keling | kling-v1, kling-v1-6, kling-v2-master |
| Non-standard Jimeng | jimeng_vgfm_t2v_l20 |
curl "$BASE_URL/v1/video/generations" \
-H "Authorization: Bearer $NODEKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedance-2-0-260128",
"prompt": "A handheld camera moves through a coffee shop in the morning, sunlight sweeping across the table from the window",
"seconds": "5",
"size": "1280x720",
"metadata": {"ratio": "16:9", "resolution": "720p", "generate_audio": false}
}'
curl "$BASE_URL/v1/video/generations/task_xxx" \
-H "Authorization: Bearer $NODEKEY_API_KEY"Non-standard interfaces retain channel formats: Keling uses /kling/v1/videos/text2video, /kling/v1/videos/image2video; Jimeng uses /jimeng/?Action=.... Seedance's metadata.content can pass image_url, video_url, audio_url as reference content.
Authorization
BearerAuth
使用 Bearer Token 认证。
格式: Authorization: Bearer sk-xxxxxx
In: header
Request Body
application/json
模型/风格 ID
文本描述提示词
图片输入 (URL 或 Base64)
视频时长(秒)
视频宽度
视频高度
视频帧率
随机种子
生成视频数量
响应格式
用户标识
扩展参数 (如 negative_prompt, style, quality_level 等)
Response Body
application/json
application/json
curl -X POST "https://nodekey.xinghanyun.cn/v1/video/generations" \ -H "Content-Type: application/json" \ -d '{ "model": "kling-v1", "prompt": "宇航员站起身走了", "image": "https://example.com/image.jpg", "duration": 5, "width": 1280, "height": 720, "fps": 30, "seed": 20231234, "n": 1, "response_format": "url", "user": "user-1234", "metadata": {} }'{
"task_id": "abcd1234efgh",
"status": "queued"
}{
"error": {
"message": "string",
"type": "string",
"param": "string",
"code": "string"
}
}Last updated on