文生视频/图生视频

接口
https://ai-api.mandao.com/v1/video/generations

2.1 部分模型列表

模型名 说明
wan2.7-t2v Wan2.7 文生视频模型
wan2.7-i2v Wan2.7 图生视频模型

2.2 请求头

参数名 是否必填 说明
Authorization 是 认证令牌，格式 Bearer sk-xxxx 或 Access-Token: sk-xxxx
Content-Type 是 application/json

2.3 请求参数

参数名 类型 是否必填 默认值 功能说明
model string 否 - 模型/风格 ID，如 kling-v1、kling-v2-master
prompt string 否 - 文本提示词，描述要生成的视频内容
image string 否 - 图片输入（URL 或 Base64），用于图生视频场景
duration float64 是 - 视频时长（秒），如 5.0
width int 是 - 视频宽度（像素），如 512、1024
height int 是 - 视频高度（像素），如 512、1024
fps int 否 - 视频帧率，如 30
seed int 否 - 随机种子，固定种子可复现结果，如 20231234
n int 否 1 生成视频数量
response_format string 否 url 响应格式，如 url
user string 否 - 用户标识，用于请求追踪
metadata object 否 - 厂商特定/自定义参数对象，可包含：
• negative_prompt：负向提示词
• style：风格
• quality_level：质量等级
• camera_control：镜头控制参数
• 其他渠道自定义字段

特殊说明：

  • metadata 为透传字段，不同上游渠道（可灵、即梦、Gemini 等）支持的子字段不同，请参考对应厂商文档。

2.4 请求示例（文生视频）

{
  "model": "wan2.7-t2v",
  "prompt": "宇航员站起身走了",
  "duration": 5.0,
  "width": 512,
  "height": 512,
  "fps": 30,
  "seed": 20231234,
  "n": 1,
  "response_format": "url",
  "user": "user-1234",
  "metadata": {
    "negative_prompt": "模糊, 低质量",
    "style": "cinematic"
  }
}

2.5 请求示例（图生视频）

{
  "model": "wan2.7-i2v",
  "image": "https://example.com/image.jpg",
  "prompt": "A cat playing piano in the garden",
  "duration": 5.0,
  "width": 1024,
  "height": 1024,
  "fps": 30,
  "n": 1,
  "metadata": {
    "camera_control": {
      "type": "simple",
      "config": {
        "horizontal": 2.5,
        "vertical": 0,
        "zoom": 0
      }
    }
  }
}

2.6 提交成功响应参数

任务提交成功后，系统会返回任务基本信息。

2.6.1 标准响应

参数名 类型 说明
task_id string 任务唯一标识
status string 任务初始状态，通常为 queued 或 submitted

2.6.2 提交响应示例

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

2.7 CURL 调用示例

提交视频生成任务：

curl -X POST "https://ai-api.mandao.com/v1/video/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "prompt": "宇航员站起身走了",
    "duration": 5.0,
    "width": 512,
    "height": 512,
    "n": 1
  }'

2.8 查询任务状态

接口
https://ai-api.mandao.com/v1/video/generations/{taskId}

请求示例

curl -X GET "https://ai-api.mandao.com/v1/video/generations/vid_abc123def456" \
  -H "Authorization: Bearer sk-your-api-key"

2.9 响应参数

参数名 类型 说明
code string 状态码，success 表示成功
message string 消息说明
data object 任务详情对象（TaskDto）
data.task_id string 任务 ID
data.status string 任务状态：queued（排队中）、processing（处理中）、succeeded（成功）、failed（失败）
data.result_url string 生成结果的 URL（成功时返回）
data.fail_reason string 失败原因（失败时返回）
data.progress string 任务进度百分比或描述
data.platform string 上游平台标识
data.quota int 消耗额度
data.created_at int64 创建时间戳
data.updated_at int64 更新时间戳
data.submit_time int64 提交时间戳
data.start_time int64 开始处理时间戳
data.finish_time int64 完成时间戳
data.action string 任务动作类型
data.properties any 任务属性扩展字段

响应示例（成功）

{
  "code": "success",
  "message": "",
  "data": {
    "id": 12345,
    "task_id": "vid_abc123def456",
    "status": "succeeded",
    "result_url": "https://cdn.example.com/videos/result_xxx.mp4",
    "progress": "100%",
    "platform": "kling",
    "quota": 5000,
    "created_at": 1716883200,
    "updated_at": 1716883500,
    "submit_time": 1716883200,
    "start_time": 1716883210,
    "finish_time": 1716883500,
    "action": "generate",
    "properties": {},
    "fail_reason": ""
  }
}