Skip to Content
goldflow.cc Docs
VideosGeneric Video

创建视频生成任务

POST
/v1/video/generations

创建视频生成任务。该通用接口覆盖 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 天有效,两步独立计费。尚未完成真实付费样片及正式片生成验证。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Request Body

application/json
  1. body
model*string

要调用的模型 ID。

prompt*string

视频生成提示词,描述希望生成的视频内容。

image?string

单张参考图片 URL,用于图生视频。

Formaturi
images?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 生成正式片时自动继承任务类型,不得填写本字段。 官方未列出该返回字段,不能依赖回传。

Default"auto"
Value in"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 保留,具体能力由上游模型决定。

Response Body

视频任务响应。

application/json
  1. 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。

Formaturi
video_url?string

视频地址。

Formaturi
content_url?string

可用于下载视频内容的 URL。

Formaturi
remixed_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  }}'
Example Response
{  "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": {}}