跳转到主要内容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7",
    "prompt": "夕阳下的海边公路，慢镜头推进，电影感画面",
    "resolution": "1080P",
    "duration": 8,
    "size": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7",
    "prompt": "夕阳下的海边公路，慢镜头推进，电影感画面",
    "resolution": "1080P",
    "duration": 8,
    "size": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
认证

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
模式路由

wan2.7 是文生视频和图生视频的统一入口，后端根据传入参数自动判断模式，两种模式计费完全一致：
条件路由到模式说明
image_urls / image_with_roles / video_urls 任一有值图生视频首帧生视频 / 首尾帧 / 视频续写
以上参数均不传文生视频纯文字描述生成视频

​
请求参数

​
model
string
必填
视频生成模型名称，固定为 wan2.7
​
prompt
string
视频内容描述，最多 5000 字符
  • 文生模式（无图/视频时）：必填
  • 图生模式：可选，但建议填写以指导运镜和动作
示例："一只猫咪在草地上追逐蝴蝶，阳光明媚，慢动作"
​
image_urls
array<string>
图片 URL 数组。传入后自动进入图生模式
  • 1 张：首帧生视频
  • 2 张：首尾帧生视频（第 1 张首帧，第 2 张尾帧）
与 image_with_roles 二选一
不可与 video_urls 同时传入
​
image_with_roles
array<object>
带角色的图片数组，与 image_urls 二选一，用于精确指定每张图片的角色每个对象字段：
  • url (string)：图片 URL（支持 http/https）
  • role (string)：图片角色，first_frame（首帧）/ last_frame（尾帧），默认 first_frame
示例：
[
  { "url": "https://cdn.example.com/start.jpg", "role": "first_frame" },
  { "url": "https://cdn.example.com/end.jpg", "role": "last_frame" }
]
含 first_frame 时不可与 video_urls 同时传入；仅含 last_frame 时可与 video_urls 搭配使用
​
video_urls
array<string>
视频 URL 数组。传入后进入视频续写模式（仅取第 1 个视频）
不可与 image_urls、first_frame、audio_url 同时传入；可与 last_frame 搭配使用
视频限制：
  • 格式：mp4、mov
  • 时长：2～10s
  • 分辨率：宽和高的范围为 [240, 4096] 像素
  • 宽高比：1:8 ~ 8:1
  • 文件大小：不超过 100MB
​
negative_prompt
string
反向提示词，描述不希望出现的内容，最多 500 字符示例："模糊、变形、低质量"
​
resolution
string
默认值:"1080P"
视频分辨率可选值：
  • 720P - 标清
  • 1080P - 高清（默认）
​
duration
integer
默认值:"5"
视频时长（秒）支持范围：2 ~ 15 秒默认值：5
​
size
string
默认值:"16:9"
画面宽高比，仅文生模式生效（无图/视频时）支持的格式：
  • 16:9 - 横版宽屏（默认）
  • 9:16 - 竖版长屏
  • 1:1 - 正方形
  • 4:3 - 横版
  • 3:4 - 竖版
图生模式下此参数会被忽略，宽高比由输入图片自动决定
​
audio_url
string
自定义音频 URL
  • 文生模式：作为视频背景音乐
  • 图生模式：作为驱动音频，同步画面动作
格式：wav / mp3，时长 2-30 秒，文件大小 ≤ 15MB
不可与 video_urls 同时传入
​
prompt_extend
boolean
默认值:"true"
是否开启 prompt 智能改写对较短提示词效果提升明显，但会增加耗时默认值：true
​
watermark
boolean
默认值:"false"
是否在生成的视频上添加 “AI生成” 水印
  • true：添加水印
  • false：不添加水印（默认）
​
seed
integer
种子整数，用于控制生成内容的随机性取值范围：≥0 的整数
  • 相同的请求下，模型收到不同的 seed 值（如：不指定 seed 值），将生成不同的结果
  • 相同的请求下，模型收到相同的 seed 值，会生成类似的结果，但不保证完全一致

​
响应

​
code
integer
响应状态码，成功时为 200
​
data
array
返回数据数组

​
使用场景

​
场景 1：文生视频（最简请求）

{
  "model": "wan2.7",
  "prompt": "夕阳下的海边公路，慢镜头推进，电影感画面"
}

​
场景 2：文生视频（完整参数）

{
  "model": "wan2.7",
  "prompt": "一只猫咪在草地上追逐蝴蝶，阳光明媚，慢动作",
  "negative_prompt": "模糊、变形、低质量",
  "resolution": "1080P",
  "duration": 8,
  "size": "16:9",
  "audio_url": "https://cdn.example.com/bgm.mp3",
  "prompt_extend": true,
  "watermark": false,
  "seed": 42
}

​
场景 3：首帧生视频

{
  "model": "wan2.7",
  "prompt": "人物缓缓站起身，向镜头走来",
  "image_urls": ["https://cdn.example.com/person.jpg"],
  "resolution": "1080P",
  "duration": 8
}

​
场景 4：首尾帧生视频

{
  "model": "wan2.7",
  "prompt": "镜头从海边缓慢移向山顶",
  "image_urls": [
    "https://cdn.example.com/beach.jpg",
    "https://cdn.example.com/mountain.jpg"
  ],
  "resolution": "1080P",
  "duration": 10
}
传 2 张时：第 1 张为首帧，第 2 张为尾帧。也可用 image_with_roles 精确指定。

​
场景 5：视频续写

{
  "model": "wan2.7",
  "prompt": "继续向前走，镜头跟随",
  "video_urls": ["https://cdn.example.com/clip.mp4"],
  "resolution": "1080P",
  "duration": 8
}

​
场景 6：图片 + 驱动音频

{
  "model": "wan2.7",
  "prompt": "人物随音乐节奏运动",
  "image_urls": ["https://cdn.example.com/dancer.jpg"],
  "audio_url": "https://cdn.example.com/beat.mp3",
  "resolution": "1080P",
  "duration": 8
}

​
模式选择建议

需求推荐方式
纯文字描述生成视频仅传 prompt（不传图片/视频）
让图片”动起来”传 1 张图到 image_urls
控制视频的开始和结束画面传 2 张图到 image_urls（首帧 + 尾帧）
在已有视频基础上延伸传视频到 video_urls
让图片跟随音乐律动传图片 + audio_url
查询任务结果视频生成为异步任务，提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。