图片生成

图片生成为同步接口：一次请求直接返回生成结果 data[]。支持文生图与图生图（带参考图）。

POST https://api.smartapi.cc/api/openapi/v1/generate/image/generations

鉴权#

Authorization: Bearer sk-your-key-here
Content-Type: application/json

请求体#

字段	类型	必填	说明
`model`	string	是	模型标识，例如 `wan2.5-image`、`gpt-image-2`。
`prompt`	string	是	文本提示词。
`files`	array	否	参考图（图生图）；每项含 `file_uri`（图片 URL）与 `mime_type`。
供应商配置	object	否	按模型所属供应商传对应配置块，见下表。

不同供应商的图片模型接收不同的配置块（与模型所属供应商一致，仅传其一）：

供应商	配置字段	可选项
QWEN	`qwenConfig`	`size`、`n`、`prompt_extend`
DOUBAO	`doubaoConfig`	`size`、`seed`、`guidance_scale`、`n`
GEMINI	`geminiConfig`	`aspect_ratio`、`resolution`
AZURE	`azureConfig`	`size`、`quality`（low/medium/high）、`n`

各模型该传哪个配置块、字段可选值（尺寸、张数、质量等），可在模型广场的「生图/视频调用规则」标签页中以列表一目了然地查看；也可在操练场选中模型，打开「自定义请求体 / 调试」查看实际请求体。

文生图示例#

curl https://api.smartapi.cc/api/openapi/v1/generate/image/generations \
  -H "Authorization: Bearer $SMARTAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-image",
    "prompt": "一只在雪地里奔跑的柴犬，电影感光线",
    "qwenConfig": { "size": "1328*1328", "n": 1 }
  }'

图生图示例#

在 files 中传入参考图 URL 即可进入图生图模式：

curl https://api.smartapi.cc/api/openapi/v1/generate/image/generations \
  -H "Authorization: Bearer $SMARTAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-image",
    "prompt": "把背景换成樱花盛开的春天",
    "files": [
      { "file_uri": "https://example.com/input.png", "mime_type": "image/png" }
    ],
    "qwenConfig": { "size": "1664*928", "n": 1 }
  }'

QWEN / Wan 系列（qwen-image、wan2.5/2.6/2.7-image、wan2.7-image-pro）图生图对尺寸有更严格的像素上限：总像素需在 768×768（589,824）至 1280×1280（1,638,400）之间。1328*1328、1472*1140、1140*1472 超过上限，图生图时会报错，请改用 1664*928、928*1664 或更小尺寸；文生图不受此限制。

响应#

{
  "data": [{ "url": "https://.../result.png" }],
  "model": "wan2.5-image"
}

部分模型可能返回 b64_json（base64 图片）而非 url，请兼容两种形态解析。若上游校验失败，接口会返回上游的原始错误信息（如尺寸超限），便于排查。

计费#

图片模型按积分计费（不是 token）。FLAT 类型为每张图固定积分，最终消耗 = 基础积分 × 张数 n。 gpt-image-2 另按质量倍率：low ×1、medium ×2.5、high ×5。各模型单价见模型广场，计费口径详见计费。