跳到主要内容

视频生成

视频生成通常是异步任务：提交请求后先返回任务 ID，再通过查询接口获取进度和结果。具体模型可能支持文生视频、图生视频或视频编辑，字段和时长限制以模型能力为准。

创建任务​

POST /v1/video/generations
Content-Type: application/json
Authorization: Bearer sk-your-api-key
curl -X POST "https://www.walmind.cn/v1/video/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "your-video-model",
    "prompt": "一座城市在海边日落时亮起灯光",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

创建成功后返回：

{"task_id": "abcd1234efgh", "status": "queued"}

查询任务​

GET /v1/video/generations/{task_id}
Authorization: Bearer sk-your-api-key
curl "https://www.walmind.cn/v1/video/generations/abcd1234efgh" \
  -H "Authorization: Bearer $API_KEY"

任务状态通常包括：

状态含义
queued已进入队列，等待处理
in_progress正在生成
completed已完成，可读取结果
failed生成失败，应查看错误信息

请求字段​

字段类型说明
modelstring模型或风格 ID
promptstring文本描述提示词
imagestring图像 URL 或 Base64，用于图生视频
durationnumber视频时长（秒）
width / heightinteger输出尺寸
fpsinteger视频帧率
seedinteger随机种子
ninteger生成数量
metadataobject扩展参数，例如负面提示词、风格或质量等级

OpenAI 视频路径​

部分部署还提供 OpenAI 兼容的视频路径：

POST /v1/videos
GET  /v1/videos/{video_id}
GET  /v1/videos/{video_id}/content

这组接口同样是异步任务。任务完成后，使用 /content 读取视频二进制内容；不要在任务仍处于 queued 或 in_progress 时下载内容。不同视频渠道的协议不能仅通过替换路径混用，请以模型分组提供的格式为准。

其他视频协议​

部分部署还会暴露供应商原生路径：

协议创建任务查询任务
可灵（Kling）文生视频POST /kling/v1/videos/text2videoGET /kling/v1/videos/text2video/{task_id}
可灵（Kling）图生视频POST /kling/v1/videos/image2videoGET /kling/v1/videos/image2video/{task_id}
即梦（Jimeng）POST /jimeng/，通过 Action 参数区分操作由请求中的操作类型决定

可灵图生视频通常接收图片 URL 或 Base64 数据；即梦接口需要同时传递版本和操作类型。供应商原生接口的签名、字段和模型 ID 不同于 OpenAI 兼容接口，只有在模型说明明确要求时才使用这些路径。