SiliEvo wan2.7-image-pro 模型接入指南#

1. 接口概览#

2. 认证方式#

Content-Type: application/json
Authorization: Bearer sk-silievo-xxxxxxxxxxxxxxxxxxxx

注意: sk-silievo- 开头的 API Key 需要通过平台官网 https://numspirit.com 申请。

3. 图片生成接口（/v1/images/generations）#

3.1 请求参数#

请求体结构#

参数说明#

模型路由: 生产环境请使用带渠道前缀的完整模型 ID aliyun/wan2.7-image-pro（固定路由到阿里云渠道）。不带渠道前缀的纯模型 ID 仅在模型唯一注册时自动路由，多渠道并存时建议用前缀形式固定渠道。

重要限制（纯文生图）: 该模型定位为文生图（t2i）为主。传 images 数组接口不会拒绝（HTTP 200，参考图会经网关上传 OSS 并发往上游），但响应 image_tokens=0，模型是否真正参考图片需目测输出确认。多图编辑的确定支持方是 aliyun/qwen-image-3.0-pro（图片确实进上游），用法与图片编号规则参见《nano banana生图模型.md》3.3 节——注意 DashScope 渠道图片顺序与 Gemini 相反：图片在前、文本在后。

支持的图片尺寸#

网关只做 x→* 字符替换，不做数值映射。1024x1024 会被上游原生接受，因此 OpenAI 格式可直接用。

比例格式（1:1、16:9 等）当前不支持: 传 size=1:1 会被网关原样透传给上游 → 上游返回 400 → 网关 502。这是平台代码缺口（尚无「比例→阿里云尺寸」映射表），请改用具体的 宽*高 像素格式（阿里云或 OpenAI 格式）。

提示: 阿里云官方文档中提到的 2K、4K 等尺寸参数在部分模型版本中可能不支持，建议使用具体的像素尺寸（如 1280*1280）以确保兼容性。

3.2 返回值格式#

成功响应#

{
  "created": 1784686812,
  "data": [
    {
      "url": "https://dashscope-xxx.oss-xxx.aliyuncs.com/xxx.png?Expires=xxx"
    }
  ],
  "usage": {
    "total_tokens": 36,
    "input_tokens": 34,
    "output_tokens": 2,
    "input_tokens_details": {
      "text_tokens": 34,
      "image_tokens": 0
    }
  }
}

实测响应结构：顶层仅 created/data/usage，data[0] 仅含 url（OSS 临时链接，无 b64_json、无 revised_prompt）。

响应字段说明#

错误响应#

{
  "request_id": "a4d78a5f-655f-9639-8437-xxxxxx",
  "error": {
    "code": "InvalidParameter",
    "message": "num_images_per_prompt must be 1"
  }
}

4. 错误处理#

4.1 HTTP 状态码#

4.2 常见错误#

尺寸格式错误#

{
  "error": {
    "code": "invalid_request",
    "message": "图片尺寸取值非法，支持的格式：OpenAI尺寸(如1024x1024)、阿里云尺寸(如1280*1280)"
  }
}

额度不足#

{
  "error": {
    "code": "insufficient_quota",
    "message": "用户额度不足"
  }
}

阿里云 API 错误#

{
  "error": {
    "code": "internal_error",
    "message": "阿里云生图调用失败: 阿里云API错误: {...}"
  }
}

5. 常见问题#

Q1: aliyun/wan2.7-image-pro 支持图生图（图片编辑）吗？#

Q2: 生成的图片 URL 有效期是多久？#

Q3: 为什么最大生成数量是 4 张？#

6. 相关文档#