创建视频生成任务
创建视频生成任务。该通用接口覆盖 HappyHorse、Seedance、Veo、万相等 /v1/video/generations 提供商。
Vidu Q2/Q3 使用字符串 seconds、size: 720p 和 metadata.vidu_operation,显式选择 text2video、img2video、start-end2video 或 reference2video。图片传入 images,audio、is_rec、aspect_ratio 等选项放在 metadata;当前 Q3 的 is_rec 仅可为 false,off_peak 仅可为 false。Vidu 创建后统一使用 GET /v1/videos/{task_id} 查询,成功读取 video_url。模型与操作限制见 Vidu 统一视频格式。
MiniMax H3 系列支持 minimax-h3、minimax-h3-max、minimax-h3-max-turbo。H3 使用 size: 768P / 2K 和 4–15 秒;Max 使用 480P / 768P 和 5–15 秒,Turbo 使用当前模型支持的参数。metadata.content 非空时完整替换快捷素材映射,但顶层 prompt 仍必须非空。minimax-h3-context-ir 与 minimax-h3-regeneration 使用专用 /v2 接口,不能在此创建。
使用 Seedance 2.0 / 2.5 时,通用字段会转换为官方 content[] 格式:prompt 转为文本内容,image 或 images 转为参考图片,metadata.video_url 转为参考视频,metadata.audio_url 转为参考音频,size 转为 resolution,metadata.ratio 转为 ratio。创建成功后保存返回的任务 ID,并通过 GET /v1/video/generations/{task_id} 轮询结果。
Seedance 2.0 / 2.5 素材支持自动上传:在图片、视频或音频素材字段中直接传入公网可访问的 https:// 链接,系统会自动识别并上传素材,无需提前调用 /api/assets/upload。
使用 Wan 3.0 时,image 或 images[] 的前两张图片会转换为 first_frame 和 last_frame,reference_images[].url 转换为 reference_image,video.url 转换为 reference_video。需要参考音频、文件、网页或完整控制原生字段时,通过 metadata.input.media 和 metadata.parameters 传入;非空的 metadata.input.media 会替换所有快捷媒体字段。
Seedance 2.5 任务类型放在顶层 omni_reference_task_type,兼容 metadata.omni_reference_task_type(顶层优先);metadata.content 非空时完整替换快捷媒体映射。编辑使用 duration: -1 和 metadata.ratio: adaptive;延长也要求 metadata.ratio: adaptive。seconds 与 duration 不要传冲突值。Seedance 的 watermark、return_last_frame、seed、camera_fixed、draft、service_tier、execution_expires_after、priority、safety_identifier、callback_url、output_format、tools、frames 放在 metadata 下;所有内置 Seedance 路径保留显式 false/0,多视频和多音频数组不会截为第一项。
网关已部署草稿模式支持,实际可用性取决于所选渠道、上游账号和模型。先以 metadata.draft: true、size: 480p 创建 Seedance 2.5 样片;成功后,使用本用户的 goldflow.cc task_… ID 创建正式片,metadata.content 只包含一个 draft_task,size 为 1080p(或省略),metadata.draft 省略或为 false。正式片不得再次传提示词、媒体、duration / seconds、ratio、seed、generate_audio 或 omni_reference_task_type;这些参数自动复用样片。样片 ID 从创建起 7 天有效,两步独立计费。尚未完成真实付费样片及正式片生成验证。
bearerAuthAuthorizationBearer <API key>使用 Authorization Bearer API Key 进行鉴权。
application/json- body
model*string要调用的模型 ID。
prompt*string视频生成提示词,描述希望生成的视频内容。
image?string单张参考图片 URL,用于图生视频。
uriimages?array<>多张参考图片 URL,用于支持多图输入的模型。
duration?|生成视频时长,单位通常为秒,具体取值以模型为准。
seconds?|时长别名;Seedance 2.5 可用 -1 或 4–30 秒,2.0 可用 -1 或 4–15 秒。不要与 duration 传冲突值。
omni_reference_task_type?SeedanceOmniReferenceTaskType仅 Seedance 2.5 的全模态参考任务。auto 由模型判定;reference 生成新视频;edit 编辑原视频;extend 延长原视频。 edit 要求至少一个 reference_video(待编辑视频实际 4–30 秒)、ratio=adaptive、duration=-1;extend 要求 reference_video 和 ratio=adaptive。 reference 无额外任务类型限制,但仍受模型基本范围约束。显式值会提前校验;实际类型不一致仍可异步失败。 auto 是普通请求的默认值;引用 draft_task 生成正式片时自动继承任务类型,不得填写本字段。 官方未列出该返回字段,不能依赖回传。
"auto""auto""reference""edit""extend"size?string视频尺寸或分辨率;Seedance 使用 480p、720p、1080p 等分辨率,比例放在 metadata.ratio。
aspect_ratio?string视频画面比例。
resolution?string部分提供商的顶层分辨率;Seedance 使用 size,兼容 metadata.resolution。
seed?integer部分提供商的顶层随机种子;Seedance 必须使用 metadata.seed。
fps?integer输出视频帧率。
negative_prompt?string负向提示词,用于描述不希望出现在视频中的内容。
metadata?供应商扩展参数。Seedance 高级选项放在 metadata 下;未传或 null 时不发送,显式 false 和 0 保留,具体能力由上游模型决定。
视频任务响应。
application/json- response
id?string视频任务 ID。
task_id?string视频任务 ID,兼容部分供应商返回结构。
object?string对象类型。
status?string通用状态为 queued、in_progress、completed、failed。
model?string实际使用的视频模型 ID。
created_at?integer任务创建时间,Unix 秒级时间戳。
updated_at?integer任务更新时间,Unix 秒级时间戳。
completed_at?integer任务完成时间,Unix 秒级时间戳。
expires_at?integer结果过期时间,Unix 秒级时间戳。
seconds?string视频时长。
size?string视频尺寸或分辨率。
progress?integer任务进度百分比。
url?string生成视频的访问 URL。
urivideo_url?string视频地址。
uricontent_url?string可用于下载视频内容的 URL。
uriremixed_from_video_id?string源视频 ID(如果是基于其他视频生成)。
output?array<>供应商返回的扩展输出结果。
metadata?Seedance 规范化结果;仅返回上游实际提供的尾帧、用量和输出参数,保留 false/0,不复制任意上游私有字段。
error?任务失败时的错误信息。
curl -X POST 'https://goldflow.cc/v1/video/generations' \ -H 'Content-Type: application/json' \ -d '{ "model": "viduq2-pro", "prompt": "保持茶壶外观一致,镜头平稳推进。", "images": [ "https://example.com/first-frame.png" ], "seconds": "5", "size": "720p", "metadata": { "vidu_operation": "img2video", "is_rec": false, "audio": false, "seed": 0, "watermark": false }}'{ "id": "string", "task_id": "string", "object": "string", "status": "string", "model": "string", "created_at": 0, "updated_at": 0, "completed_at": 0, "expires_at": 0, "seconds": "string", "size": "string", "progress": 0, "url": "http://example.com", "video_url": "http://example.com", "content_url": "http://example.com", "remixed_from_video_id": "string", "output": [ {} ], "metadata": { "url": "string", "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "last_frame_url": "http://example.com", "output_format": "string", "duration": 0, "duration_seconds": 0, "resolution": "string", "ratio": "string", "seed": 0, "generate_audio": true, "draft": true, "draft_task_id": "string" }, "error": {}}