> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yingtu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT Image 2 Web API

> 使用 gpt-image-2-web 完成低固定价格的文生图、单图或多图生图、三档尺寸、quality 转发和异步任务。

`gpt-image-2-web` 是低固定价格的逆向图片路线，适合文生图和参考图生图。当前固定价格为 USD 0.03/次；生产接入前请重新查看[模型广场](https://api.yingtu.ai/pricing)。

这是本 API 在 GPT Image 2 家族中的模型 ID。OpenAI [官方模型页](https://developers.openai.com/api/docs/models/gpt-image-2)使用 `gpt-image-2`，并列出日期快照 `gpt-image-2-2026-04-21`；如果改为直连 OpenAI，需要同时调整模型名和 API 地址。

## 可以完成什么

* 同步文生图
* 单张来源图片编辑
* 返回 task\_id 的统一异步生图，以及 1～16 张参考图编辑
* 1024×1024、2048×2048、3840×2160
* 单张 Base64 PNG

产品图换背景、文章配图、社交媒体素材和队列式生图都可以从该模型开始。

## quality 会怎样处理

Web 会转发 `low`、`medium`、`high`、`auto`，实际效果取决于所选上游。参数被接受不等于不同档位在所有上游都会产生固定差异。

如果业务需要四档 quality 已覆盖完整调用流程的路线，改用 [`gpt-image-2-vip`](/cn/models/image/gpt-image/gpt-image-2-vip/overview)。

## 同步还是异步

服务端或代理允许等待完整图片时，直接调用 Generate 或单图 Edit。异步或多图任务使用 `/v1/images/tasks`，通过 `action=generate|edit` 提交，设置 `Idempotency-Key`，立即保存 `task_id`，再按截止时间轮询。

<CardGroup cols={2}>
  <Card title="核对 Web 参数" icon="sliders-horizontal" href="/cn/models/image/gpt-image/gpt-image-2-web/parameters">
    查看尺寸、表单字段和返回结构。
  </Card>

  <Card title="复制完整示例" icon="braces" href="/cn/models/image/gpt-image/gpt-image-2-web/examples">
    运行同步、异步和编辑请求。
  </Card>
</CardGroup>