快速上手

图片生成 API

GPT Image 与 Wan 图片模型共用一个 OpenAI 兼容端点。本页说明鉴权、文生图请求、Wan 专用参数、临时图片 URL、按张计费与当前接口边界。

端点与鉴权支持的图片模型Wan 请求参数请求示例响应格式计费与结算常见错误当前 Wan 兼容范围

端点与鉴权

图片生成使用与其他 OpenAI 兼容请求相同的 LingCoreX API Key。

接口：POST https://api.lingcorex.ai/v1/images/generations
鉴权：Authorization: Bearer YOUR_API_KEY
内容类型：application/json
API Key 所属模型分组必须包含所请求的图片模型及 Provider。
调用 Wan 时不需要直接访问阿里端点，也不需要构造 DashScope 原生请求。LingCoreX 会把 OpenAI 兼容请求转换给 Wan，并返回统一的 Images API 响应。

支持的图片模型

不同模型共用同一接口，但能力范围和计费方式仍由具体模型决定。

模型适用场景输出与计费
gpt-image-2OpenAI 兼容图片生成与 GPT Image 工作流。支持上游 GPT Image 参数，按当前配置的图片 Token 价格结算。
wan2.7-image速度更快的 Wan 文生图，最高 2K。返回带签名的图片 URL，单次支持 1～4 张，按成功返回的图片张数计费。
wan2.7-image-pro更高质量的 Wan 图片生成，文生图最高支持 4K。返回带签名的图片 URL，单次支持 1～4 张，按成功返回的图片张数计费。
实际可用模型取决于 API Key 被分配的模型分组。请求时请使用控制台显示的准确模型 ID。

Wan 请求参数

Wan 使用精简的 OpenAI 兼容请求；未填写的可选字段采用下表所示默认值。

字段必填说明
model是wan2.7-image 或 wan2.7-image-pro。
prompt是图片描述，支持中文和英文。
n否生成张数，范围 1～4，默认 1。最终费用随成功图片数量增加。
size否两个 Wan 模型都支持 1K、2K；只有 wan2.7-image-pro 文生图支持 4K。也可使用 1024x1024 等像素尺寸。默认 2K。
response_format否当前 Wan 仅支持 url。可以不传，或显式设置为 url。
watermark否布尔值。为 true 时添加上游的“AI 生成”水印，默认 false。
thinking_mode否布尔值。为文生图启用增强推理，默认 true。
seed否0～2147483647 的整数。相同种子可以生成相似结果，但不能保证完全一致。
color_palette否可选的 Wan 色板数组，包含 3～10 个 HEX 颜色，所有颜色比例之和必须为 100.00%。

请求示例

下面三个示例都调用同一个 LingCoreX 公共端点。

curl — wan2.7-image
curl https://api.lingcorex.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "prompt": "日出时安静的高山湖泊，电影感摄影，无文字",
    "n": 1,
    "size": "1K"
  }'
Python — wan2.7-image-pro
import requests

response = requests.post(
    "https://api.lingcorex.ai/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "wan2.7-image-pro",
        "prompt": "白色大理石上的蓝色玻璃香水瓶，高级棚拍质感",
        "n": 1,
        "size": "2K",
        "watermark": False,
    },
    timeout=600,
)
response.raise_for_status()

payload = response.json()
print(payload["data"][0]["url"])
JavaScript — fetch
const response = await fetch(
  "https://api.lingcorex.ai/v1/images/generations",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "wan2.7-image",
      prompt: "绿色能源实验室的等距插画",
      n: 1,
      size: "1024x1024",
    }),
  },
)

if (!response.ok) {
  throw new Error(await response.text())
}

const result = await response.json()
console.log(result.data[0].url)
图片生成通常比聊天请求耗时更长。生产客户端建议把 HTTP 超时时间配置到 600 秒。

响应格式

Wan 响应会被转换为 OpenAI Images API 结构，并返回成功图片数量。

Wan 成功响应
{
  "created": 1784962566,
  "data": [
    {
      "url": "https://example-oss.aliyuncs.com/generated-image.png?SIGNED_QUERY"
    }
  ],
  "usage": {
    "image_count": 1
  }
}
Wan 返回的是带签名的临时 URL，有效期为 24 小时。请尽快下载图片或复制到自己的持久化存储，并避免在应用日志中记录完整的签名查询参数。

计费与结算

Wan 按成功返回的图片数量计费，而不是按 Token 数量计费。

Gateway 根据 n 和配置的单张价格计算预扣金额。
最终结算以 data 中实际成功返回的图片条目数为准。
如果成功图片少于请求数量，只结算成功返回的图片。
账户等级折扣、模型折扣或固定折扣可能改变用量记录中的最终售价。
GPT Image 模型可以使用图片 Token 计费，具体以当前定价页和模型配置为准。
上游请求失败会退回预扣金额；成功响应会在异步结算完成后出现在控制台用量记录中。

常见错误

排查问题时应同时查看 HTTP 状态码和 OpenAI 风格的 error 响应。

状态码含义检查项
400请求参数无效或当前不支持。检查 model、prompt、n、size、response_format、stream 和 partial_images。
401API Key 缺失或无效。检查 Authorization 请求头以及 Key 是否启用。
402余额不足，无法完成预扣。充值余额，或检查当前消费限额。
403当前 Key 无权使用该模型或 Provider。把图片模型加入 API Key 所属的模型分组。
429超过 QPM 或其他速率限制。使用退避重试，或调整 API Key 的 QPM 限额。
502上游图片 Provider 失败，或没有返回成功图片。查看具体错误信息，再判断是否适合重试。

当前 Wan 兼容范围

还需要看定价页或产品首页？

定价页适合看公开商业信息，首页适合快速理解产品定位。