> ## Documentation Index > Fetch the complete documentation index at: https://docs.poyo.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.5 Fixed > 使用 GPT Image 2.5 Flare 或 Sunburst 生成或编辑图像，按分辨率以固定的单张价格计费。 > [!TIP] > > 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。 > 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.poyo.ai/zh/api-manual/task-management/status.md)接口获取结果。 GPT Image 2.5 Fixed 运行 GPT Image 2.5 Flare 或 Sunburst，按 `resolution` 以单张图像计价，而不是按 token 计价。通过 `version` 选择版本。添加参考图可编辑或引导输出。 ## 模型 * **gpt-image-2.5-fixed** — 按单张计价的 GPT Image 2.5 Flare 或 Sunburst ## 必填参数 * `prompt` (string)：图像描述，1–32000 个字符。 ## 可选参数 * `version` (string)：`flare` 或 `sunburst`。默认为 `flare`。 * `resolution` (string)：`1K`、`2K` 或 `4K`。默认为 `1K`。 * `size` (string)：`auto`、`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5` 或 `21:9`。默认为 `1:1`。 * `image_urls` (array of strings)：最多 16 个参考图 URL。 ## 输出 任务完成后，生成的图像在 `files` 中返回，`file_type: image`。 ## 示例 * **使用 Flare 以 2K 进行文生图** — 设置 `prompt`、`version`、`resolution`、`size`。 * **使用 Sunburst 基于参考图编辑** — 设置 `prompt`、`version`、`image_urls`。 ## 注意事项 * 不支持 `n` 和 `num_images`。每个任务返回一张图像。 * `image_urls` 必须是数组，即使只有一张图像。 * 如需按 token 计价，请使用 [GPT Image 2.5 Flare](https://docs.poyo.ai/zh/api-manual/image-series/gpt-image-2-5-flare.md) 或 [GPT Image 2.5 Sunburst](https://docs.poyo.ai/zh/api-manual/image-series/gpt-image-2-5-sunburst.md)。 ## OpenAPI ````yaml zh/api-manual/image-series/gpt-image-2-5-fixed.json POST /api/generate/submit openapi: 3.0.0 info: title: GPT Image 2.5 Fixed description: GPT Image 2.5 Flare 或 Sunburst，按分辨率逐张计费。 version: 1.0.0 servers: - url: https://api.poyo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: summary: 提交 GPT Image 2.5 Fixed 任务 operationId: submit_gpt_image_2_5_fixed requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SubmitRequest' examples: text: summary: 使用 Flare 以 2K 文生图 value: model: gpt-image-2.5-fixed input: prompt: A paper-cut illustration of a city at sunrise version: flare resolution: 2K size: '16:9' edit: summary: 使用 Sunburst 基于参考图编辑 value: model: gpt-image-2.5-fixed input: prompt: Turn this product photo into a clean studio shot on white version: sunburst image_urls: - https://example.com/product.jpg responses: '200': description: 任务提交成功 content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' '400': description: 请求参数无效 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: 未授权：API Key 无效 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: SubmitRequest: type: object additionalProperties: false required: - model - input properties: model: type: string enum: - gpt-image-2.5-fixed description: 公开的模型标识。 callback_url: type: string format: uri description: 可选的 Webhook URL，用于接收任务完成或失败通知。 input: type: object additionalProperties: false required: - prompt properties: prompt: type: string minLength: 1 maxLength: 32000 description: 图像的文字描述。必须包含非空白文本。 version: type: string enum: - flare - sunburst default: flare description: 模型变体。 resolution: type: string enum: - 1K - 2K - 4K default: 1K description: 输出分辨率档位。 size: type: string enum: - auto - '1:1' - '16:9' - '9:16' - '4:3' - '3:4' - '3:2' - '2:3' - '5:4' - '4:5' - '21:9' default: '1:1' description: 宽高比。不接受自定义像素尺寸。 image_urls: type: array items: type: string format: uri maxItems: 16 description: 可选的参考图，最多 16 张。每一项都必须是可公开访问的 HTTP 或 HTTPS URL。 SubmitResponse: type: object required: - code - data properties: code: type: integer example: 200 enum: - 200 - 400 - 401 - 402 - 403 - 404 - 408 - 429 - 500 - 502 - 503 description: >- 业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的 `code` 为 `400`。 - `200`：成功 - `400`：请求参数无效 - `401`：API Key 缺失或无效 - `402`：积分不足 - `403`：没有权限 - `404`：资源不存在 - `408`：请求超时 - `429`：请求频率超限 - `500`：服务器内部错误 - `502`：上游服务错误 - `503`：服务暂不可用 详见[错误码](/zh/api-manual/error-codes)。 data: type: object required: - task_id - status - created_time properties: task_id: type: string example: task-unified-1793176000-example status: type: string enum: - not_started - running - finished - failed example: not_started description: >- 任务状态。提交后立即返回时始终为 `not_started`。后续状态请通过[查询任务状态](/zh/api-manual/task-management/status)接口或 `callback_url` 获取。 - `not_started`：排队中，等待处理 - `running`：生成中 - `finished`：已完成，结果在 `files` 或 `output` 中 - `failed`：失败，详情见 `error_message` created_time: type: string format: date-time example: '2026-10-28T10:30:00' ErrorResponse: type: object required: - code - error properties: code: type: integer example: 400 enum: - 200 - 400 - 401 - 402 - 403 - 404 - 408 - 429 - 500 - 502 - 503 description: >- 业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的 `code` 为 `400`。 - `200`：成功 - `400`：请求参数无效 - `401`：API Key 缺失或无效 - `402`：积分不足 - `403`：没有权限 - `404`：资源不存在 - `408`：请求超时 - `429`：请求频率超限 - `500`：服务器内部错误 - `502`：上游服务错误 - `503`：服务暂不可用 详见[错误码](/zh/api-manual/error-codes)。 error: type: object required: - message - type properties: message: type: string example: Invalid request parameters type: type: string example: validation_error securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- 所有 API 接口都需要 Bearer Token 认证。 创建 API Key：登录 PoYo，进入 **仪表盘 → API 密钥**（[poyo.ai/zh/dashboard/api-key](https://poyo.ai/zh/dashboard/api-key)），点击创建 Key。 在请求头中添加： ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.