gpt-image-2 图像生成 API 指南：参数、提示词与计费

gpt-image-2 是网页版旗舰画图模型的 API 形态：支持文生图、多参考图编辑，中文提示词理解好， 出图自带排版能力（海报、带字卡片可用性高）。本文覆盖参数选择、费用构成与工程实践。

基础调用

curl https://你的域名/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张扁平插画风格的咖啡店海报，暖色调，包含店铺名与营业时间",
    "size": "1024x1024"
  }'

返回结构与 OpenAI 官方一致（data[0].url 或 b64_json）， 现有官方 SDK 代码无需改动。多参考图编辑走 /v1/images/edits，支持同时传多张图。

尺寸与质量：直接影响费用

图像按 token 计费，输出 token 由「像素块数量 × 质量系数」决定：

• 1024×1024：低 272 / 中 1056 / 高 4160 tokens
• 1536×1024：低 408 / 中 1584 / 高 6240 tokens
• 2048×2048：中 4224 / 高 16640 tokens

实践建议：草稿迭代用 low/medium，定稿再出一版 high——同样的提示词， 成本可以差 15 倍。具体单价见定价页。

提示词写法

• 先说主体与构图，再说风格（扁平插画/水彩/3D 渲染），最后是文字内容（模型对引号内文字的还原较可靠）
• 中文提示词直接写即可，不需要翻译成英文
• 编辑类需求（改背景、换元素）用 edits 端点传原图，比纯文字描述更可控

工程实践：用异步任务防超时

高分辨率批量出图时同步请求可能遇到网关超时。请求体加 "async": true 会立即返回 task_id，再用 GET /v1/images/tasks/{task_id} 轮询取结果—— 生产环境建议一律走异步。

费用只对成功结果计收；失败调用不扣费，可放心重试。想先试效果，控制台的Playground 注册后即可免密钥试玩。