野生流动开发者文档
图片生成调用

GPT Image 2

使用现有 API Key 提交图片任务、查询进度并下载结果。

使用现有野生流动 API Key,向统一接口提交图片任务。当前首选来源为 APIMart; 直接使用原模型名称。更换供应商时由管理员在后台切换渠道;只有上游命名不同才配置模型映射。

公开模型名版本单次图片数量
gpt-image-2标准版1
gpt-image-2-official官方版1–4

可用状态和实际价格以模型广场为准。

价格与结算

标准版 gpt-image-2 按成功生成的图片计费:1K 每张 $0.009、2K 每张 $0.015、 4K 每张 $0.022。未指定分辨率时使用 1K。

官方版 gpt-image-2-official 按 APIMart 返回的实际费用加 10%: 每个 APIMart Credit 收取 $0.11。提交时按每张 1 Credit 预估占用余额, 完成后根据实际 credits_cost 多退少补;失败任务按任务状态退回。 官方版费用与输入图片、提示词、尺寸和质量有关,不是固定每张价格。

以上为 default 组美元基准价(2026-09-07);账户显示币种和分组倍率以控制台为准。 上游参考:APIMart 公开价格。

提交图片任务

设置 WILDFLOW_API_KEY 为已有 Key。每次新创作生成一个新的 Idempotency-Key, 并保存它;同一次请求重试时使用原来的键和请求内容。

curl https://api.wildflow.cn/v1/responses \
  -H "Authorization: Bearer $WILDFLOW_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-unique-request-id' \
  -d '{
    "model": "gpt-image-2",
    "background": true,
    "input": "绘制一张简洁的春日书店海报,绿色植物、暖色阳光,不要文字",
    "image": {"size": "1:1", "resolution": "1k"}
  }'

保存返回的 id(形如 resp_...)。提交响应表示任务已接受,不代表图片已经完成。 background: true 表示异步生成;图片自身的背景参数应放在 image.background 内。

查询与下载

curl https://api.wildflow.cn/v1/responses/resp_REPLACE_WITH_YOUR_ID \
  -H "Authorization: Bearer $WILDFLOW_API_KEY"

每隔约 3 秒查询一次,直到 status 为 completed 或 failed。 完成响应的 output 中,output_text 内容是一段 JSON 文本:

{"images":[{"id":"image-0","url":"https://api.wildflow.cn/…"}]}

解析文本中的 images,使用每项的 url 下载图片。图片文件保存到北京 OSS,下载通过 野生流动提供的地址完成。下载地址过期时重新查询同一任务获取地址,无需重新生图。 请把带签名的下载地址视为临时访问凭据,不要公开分享。

重试与切换来源

  • 网络中断后,使用同一个 Idempotency-Key 和同样的请求内容重试,查询原任务。
  • 同一键换了内容会返回 409;新的创作使用新键。
  • recovery_required 表示上游结果尚未确定,保留任务 ID 等待处理,避免换键重复下单。
  • 后续更换供应商时,在后台调整渠道和模型映射;已提交任务继续查询原来源。 切换前需要确认新来源支持相同图片参数。