文生图 API

本文介绍 wan2.7-image、wan2.7-image-pro 模型调用 API 的输入输出参数，供您使用接口时查阅字段含义。

1.1部分模型列表

模型名 说明
wan2.7-image Wan2.7 图片生成模型
wan2.7-image-pro Wan2.7 图片生成 Pro 模型

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

1.2 请求头

参数名 是否必填 说明
Authorization 是 认证令牌，格式 Bearer sk-xxxx 或 Access-Token: sk-xxxx
Content-Type 是 application/json；图片编辑接口支持 multipart/form-data

1.3 请求参数（ImageRequest）

参数名 类型 是否必填 默认值 功能说明
model string 是 - 模型名称。常用：wan2.7-image、wan2.7-image-pro、gpt-image-1
prompt string 是 - 图像生成提示词（结构体绑定 required）
n uint 否 1 生成图片数量
size string 条件必填 见说明 图片尺寸。
• dall-e-2 支持：256x256、512x512、1024x1024（默认 1024x1024）
• dall-e-3 支持：1024x1024、1024x1792、1792x1024（默认 1024x1024）
• 不可使用中文乘号 ×，必须使用英文 x
quality string 否 见说明 图片质量。
• dall-e-3 默认 standard，可选 hd
• gpt-image-1 默认 auto
response_format string 否 - 响应格式，如 url、b64_json
style json 否 - 风格参数（dall-e-3 支持 vivid、natural）
user json 否 - 终端用户标识，用于追踪
watermark bool 否 - 是否添加水印
background json 否 - 背景参数（部分模型如 gpt-image-1 支持）
moderation json 否 - 内容审核参数
output_format json 否 - 输出格式参数
output_compression json 否 - 输出压缩参数
partial_images json 否 - 局部重绘相关图片数据
extra_fields json 否 - 额外字段透传
image json 否 - 图片数据（主要用于 /images/edits 图生图/编辑）
watermark_enabled json 否 - 智谱 4V 水印开关
user_id json 否 - 智谱用户 ID

特殊说明：

  • images/edits 接口支持 multipart/form-data 提交，字段与 JSON 格式一致。

1.4 请求示例

{
  "model": "wan2.7-image",
  "prompt": "一只穿着宇航服的猫在月球上弹吉他",
  "n": 1,
  "size": "1024x1024",
  "quality": "standard",
  "response_format": "url",
  "style": "vivid"
}

1.5 响应参数

参数名 类型 说明
created int64 创建时间 Unix 时间戳
data array 生成的图片数据列表
data[].url string 图片访问 URL（response_format=url 时返回）
data[].b64_json string Base64 编码的图片数据（response_format=b64_json 时返回）
data[].revised_prompt string 系统基于安全策略修订后的实际提示词
metadata json 扩展元数据（可选，部分渠道返回）

1.6 响应示例

{
  "created": 1716883200,
  "data": [
    {
      "url": "https://cdn.example.com/images/gen_xxx.png",
      "b64_json": "",
      "revised_prompt": "A cat in an astronaut suit playing guitar on the moon, digital art"
    }
  ],
  "metadata": {}
}

1.7 CURL 调用示例

curl -X POST "https://ai-api.mandao.com/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "prompt": "一只穿着宇航服的猫在月球上弹吉他",
    "n": 1,
    "size": "1024x1024",
    "quality": "hd"
  }'