OpenAI 视频任务

接口行为

创建后 GET /v1/videos/{id}，完成后 GET /v1/videos/{id}/content 下载。使用相同调用身份退避查询，不提供通用取消接口。

接口与认证

POST /v1/videos

使用 XHub API 密钥：Authorization: Bearer 。不要把供应商密钥当作网关密钥。

Base URL 使用调试台显示的网关根地址，不额外追加 /v1；实际请求使用上面的完整接口路径。

请求示例

curl "$XHUB_BASE_URL/v1/videos" \
  -H "Authorization: Bearer $XHUB_API_KEY" \
  -F "model=YOUR_MODEL_NAME" -F "prompt=A lighthouse at sunrise." -F "seconds=8"

请求参数

字段	类型	说明
model	string · required	公开模型名，部署必须支持此协议。
prompt	string · required	视频描述。
seconds / size / input_reference	string / file	支持时长、分辨率和可选参考素材。

成功响应

{
  "id": "video-example",
  "status": "queued"
}

字段	类型
id	string
status	string

错误与排查

HTTP	说明
400	请求无效，请检查 JSON、参数和查询。
401	XHub 凭据缺失或无效。
403	权限拒绝，请检查模型范围或策略。
429	超过限制，请检查响应详情与 Retry-After。