Skip to Content
goldflow.cc 文档
视频系列OpenAI 兼容

查询视频任务

GET
/v1/videos/{task_id}

查询 OpenAI 兼容 /v1/videos 任务状态与结果。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Path Parameters

task_id*string

视频生成任务 ID。

Response Body

OpenAI 兼容视频任务响应。

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?

任务失败时的错误信息。

Example Request
curl -X GET 'https://goldflow.cc/v1/videos/task_123456'
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": {}}

视频生成

通过 OpenAI 兼容的 `/v1/videos` 接口创建视频生成任务,适用于 PixVerse、Veo、Seedance、Wan 3.0 等兼容提供商。 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 统一视频格式](/docs/api-reference/vidu/generic-video)。 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` 接口,不能在此创建。 Grok 视频生成也使用该接口,模型可选 `grok-imagine-video` 或 `grok-imagine-video-1.5-preview`。Grok 请求使用 `application/json`,可通过 `reference_images` 传参考图片 URL,并通过 `video.url` 传参考视频 URL。 Wan 3.0 可使用与 `/v1/video/generations` 相同的通用请求字段。需要完整原生媒体和参数时,通过 `metadata.input.media` 和 `metadata.parameters` 传入。 Seedance 2.0 / 2.5 素材支持自动上传:在图片、视频或音频素材字段中直接传入公网可访问的 `https://` 链接,系统会自动识别并上传素材,无需提前调用 `/api/assets/upload`。 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 天有效,两步独立计费。尚未完成真实付费样片及正式片生成验证。

下载视频内容

下载已生成的视频内容,适用于提供 content 端点的视频模型。