图片能力总览

187API 支持文本生成图片、参考图编辑和异步任务三类图片能力。

:::info 以模型广场实时显示为准下表是撰写时的快照，模型与分组会动态调整。使用前请到模型广场确认当前可用模型。 :::

能力矩阵

能力	接口	协议	说明
文生图	`POST /v1/images/generations`	OpenAI Images	一次请求直接出图
参考图编辑	`POST /v1/images/edits`	OpenAI Images	基于已有图片修改
Gemini 生图/改图	`POST /v1beta/models/{model}:generateContent`	Gemini 原生	支持宽高比与分辨率控制
异步任务	`POST /v1/tasks/{key}`	通用任务	提交后按任务 ID 查询进度

选哪种调用方式

两种图片协议

OpenAI Images 协议

适合绝大多数场景，SDK 直接支持：

from openai import OpenAI

client = OpenAI(api_key="***", base_url="https://187api.com/v1")
result = client.images.generate(
    model="<图片模型名>",
    prompt="一只猫坐在窗边",
    size="1024x1024",
)
print(result.data[0].url)

详见 OpenAI Images 接口。

Gemini 原生协议

需要精确控制 aspectRatio（宽高比）和 imageSize（分辨率）时使用：

curl https://187api.com/v1beta/models/<图片模型>:generateContent \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "一只猫坐在窗边"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}
    }
  }'

图片数据在 candidates[0].content.parts[].inlineData 中（base64），需自行解码落盘。

通用参数

参数	类型	必填	说明
`model`	string	是	图片模型名，以模型广场为准
`prompt`	string	是	提示词
`size`	string	否	尺寸，如 `1024x1024`
`quality`	string	否	质量，如 `high` / `medium`
`response_format`	string	否	`url`（默认）或 `b64_json`

分组怎么选

:::danger 不要凭名字猜分组图片模型通常按分组开通，不同分组对应不同模型。在模型广场确认目标模型支持的分组，再创建对应分组的令牌。填错分组会返回 403。 :::

创建令牌

控制台 → 令牌管理 → 添加令牌
令牌分组 选择目标图片模型对应的分组
模型可用列表留空（不额外限制）
提交后回列表直接复制完整 key

排错

现象	原因	处理
403	分组不含该模型 / 可用列表限制了模型	检查分组，或把可用列表留空
`model_not_found`	模型名不在该分组	到模型广场确认模型名与分组
404	路径写错	OpenAI 用 `/v1/images/`，Gemini 用 `/v1beta/models/:generateContent`
拿不到图片	用了 `b64_json` 但按 url 解析	读 `data[0].url` 或读 `inlineData`

相关：OpenAI Images 接口 · 异步任务接口 · 模型广场 · [常见问题]../reference/faq/overview

能力矩阵​

选哪种调用方式​

两种图片协议​

OpenAI Images 协议​

Gemini 原生协议​

通用参数​

分组怎么选​

创建令牌​

排错​