跳转到主要内容
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
  }'

{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
  }'

{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "task_01HX...",
      "status": "processing"
    }
  ]
}

​
Authorizations

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

​
可用模型

模型名称简介文生图最高分辨率图像编辑/组图最高分辨率单价
wan2.7-image-pro专业版，细节更好，支持 4K4K2K￥0.50 / 张
wan2.7-image标准版，速度更快2K2K￥0.20 / 张
计费按成功生成的图片张数 × 单价计算，输入不计费，与分辨率和宽高比无关。失败请求不扣费。

​
Body

​
model
string
必填
图像生成模型名称可选值：
  • wan2.7-image-pro — 专业版，文生图最高 4K
  • wan2.7-image — 标准版，速度更快，最高 2K
​
prompt
string
图像内容的文字描述，最长 5000 字符
  • 文生图模式（不传 image_urls）：必填
  • 图像编辑模式（传入 image_urls）：可选，建议填写以指导编辑效果
示例："一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
​
image_urls
array<string>
输入图片 URL 数组，用于图像编辑、多图参考等场景传入后自动进入图像编辑模式。支持格式： HTTP / HTTPS 图片链接；data:image/...;base64,... Base64 格式限制： 最多 9 张；格式 JPEG / PNG / WEBP / BMP；尺寸 240–8000 px，宽高比 1:8 ~ 8:1；单张 ≤ 20MB
传入图片后，输出宽高比自动与最后一张输入图片保持一致。图像编辑模式最高支持 2K，不支持 4K。
​
n
integer
默认值:"1"
生成图像数量
  • 非组图模式：1–4（默认 1）
  • 组图模式（enable_sequential: true）：1–12（默认 1）
按成功生成的张数计费，会根据 n 进行预扣费。
​
size
string
输出分辨率或宽高比，支持三种格式：① 档位关键字（推荐）： 1K / 2K（默认）/ 4K（仅 wan2.7-image-pro 文生图）② 宽高比： 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3（默认按 2K 换算）③ 像素值： 1024x1024 或 1024*1024
​
resolution
string
分辨率档位关键字：1K / 2K / 4K，可与 size（宽高比）配合使用。
模型场景支持档位像素范围
wan2.7-image-pro文生图（非组图）1K / 2K / 4K768×768 ~ 4096×4096
wan2.7-image-pro图像编辑 / 组图1K / 2K768×768 ~ 2048×2048
wan2.7-image所有场景1K / 2K768×768 ~ 2048×2048
​
negative_prompt
string
反向提示词，描述不希望出现在图片中的内容示例："模糊、变形、低质量"
​
watermark
boolean
默认值:"false"
是否在图片右下角添加 “AI 生成” 水印
​
seed
integer
随机种子，范围 0–2147483647。相同种子在相同参数下可生成风格近似稳定的结果。
​
thinking_mode
boolean
默认值:"true"
是否开启思考模式。开启后模型增强推理能力，提升画面质量，但耗时增加。
仅在非组图模式且无图片输入时生效。
​
enable_sequential
boolean
默认值:"false"
是否启用组图模式，一次生成多张内容连贯、风格一致的图片，适合连环画、分镜等场景。
  • 开启后 n 上限为 12
  • 组图模式下 thinking_mode 与 color_palette 不生效
  • wan2.7-image-pro 组图模式最高 2K，不支持 4K
​
bbox_list
array
交互式编辑框选区域，用于精确指定编辑或插入位置结构： [[[x1, y1, x2, y2], ...], ...]
  • 外层数组长度必须等于 image_urls 长度
  • 无需框选的图片传 [] 占位
  • 单张图片最多 2 个框；坐标为原图绝对像素值，左上角为 (0, 0)
示例：[[], [[989, 515, 1138, 681]]]
​
color_palette
array<object>
自定义颜色主题，仅非组图模式可用
  • 3–10 项，建议 8 项；每项包含 hex（颜色值）和 ratio（占比）
  • 所有 ratio 之和必须等于 100.00%
[
  { "hex": "#C2D1E6", "ratio": "23.51%" },
  { "hex": "#636574", "ratio": "76.49%" }
]

​
Response

​
code
string
响应状态，成功时为 "success"
​
data
array

​
示例

​
文生图（最简请求）

{
  "model": "wan2.7-image-pro",
  "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
}

​
文生图（指定分辨率）

{
  "model": "wan2.7-image-pro",
  "prompt": "夏日海滩，蓝天白云，4K 高清",
  "size": "4K",
  "thinking_mode": true
}

​
文生图（自定义颜色主题）

{
  "model": "wan2.7-image-pro",
  "prompt": "极简风格的现代客厅",
  "size": "2K",
  "color_palette": [
    { "hex": "#C2D1E6", "ratio": "23.51%" },
    { "hex": "#CDD8E9", "ratio": "20.13%" },
    { "hex": "#B5C8DB", "ratio": "15.88%" },
    { "hex": "#C0B5B4", "ratio": "13.27%" },
    { "hex": "#DAE0EC", "ratio": "10.11%" },
    { "hex": "#636574", "ratio": "8.93%" },
    { "hex": "#CACAD2", "ratio": "5.55%" },
    { "hex": "#CBD4E4", "ratio": "2.62%" }
  ]
}

​
组图生成

{
  "model": "wan2.7-image-pro",
  "prompt": "电影感组图：同一只流浪橘猫，前后特征必须一致。第一张春天樱花树下，第二张夏天老街树荫，第三张秋天落叶满地，第四张冬天雪地脚印。",
  "enable_sequential": true,
  "n": 4,
  "size": "2K"
}

​
单图编辑

{
  "model": "wan2.7-image",
  "prompt": "把背景换成日落场景，整体偏暖色调",
  "image_urls": ["https://example.com/portrait.jpg"],
  "size": "2K"
}

​
多图参考 / 元素融合

{
  "model": "wan2.7-image-pro",
  "prompt": "把图2的涂鸦喷绘在图1的汽车上",
  "image_urls": [
    "https://example.com/car.webp",
    "https://example.com/paint.webp"
  ],
  "size": "2K"
}

​
交互式编辑（框选区域）

通过 bbox_list 精确指定编辑位置，与 image_urls 一一对应，无需框选的图片传 []。 
{
  "model": "wan2.7-image-pro",
  "prompt": "把图1的闹钟放在图2的框选位置，保持场景和光线融合自然",
  "image_urls": [
    "https://example.com/clock.webp",
    "https://example.com/desk.webp"
  ],
  "bbox_list": [
    [],
    [[989, 515, 1138, 681]]
  ],
  "size": "2K"
}
查询任务结果图像生成为异步任务，提交后返回 task_id，请使用 获取任务状态 接口轮询直到 status == completed。