GPT Image 2.5 Sunburst Economy

OpenAI 的 GPT Image 2.5 Sunburst Economy 生图模型可根据自然语言提示词生成高质量图像。它提供开箱即用的 REST 推理 API，性能出色、无冷启动，并且价格实惠。

基础 URL

https://api.icreat.ai

身份验证

所有 API 请求都必须使用 API Key 进行身份验证。你可以从控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护你的 API Key

切勿在客户端代码或公共代码仓库中暴露 API Key。请使用环境变量或后端代理。

代码示例

图像和视频生成采用三步异步工作流：提交任务获取 task_id、轮询任务状态，并在状态变为 SUCCEEDED 后获取生成结果。以下三个步骤均使用同一个 task_id。

1. 提交任务

向任务提交接口发送生成请求。请求成功后会返回 task_id，请保存该 ID，以便后续查询任务状态和获取结果。

POST/v1/task/submit/openai/gpt-image-2-5-sunburst-economy

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/submit/openai/gpt-image-2-5-sunburst-economy" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "将背景替换为夜晚霓虹灯照亮的城市街道。",
  "image": ["https://cdn.example.com/source/dog.png"],
  "size": "1024x1024",
  "quality": "high"
}'

2. 轮询任务状态

使用提交任务时返回的 task_id 查询任务进度。响应体仅包含 status 字段，其值可能为 SUBMITTED、SUCCEEDED 或 FAILED。

当状态为 SUCCEEDED 时，可以获取生成结果；状态为 FAILED 表示任务执行失败。

POST/v1/task/query-status

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/query-status" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task-xxx"}'

3. 获取结果

任务执行成功后，使用同一个 task_id 获取最终输出。

响应体是一个资源数组，每个资源对象包含 type、url 和 download_url：

使用 url 预览或在线访问文件。
使用 download_url 下载文件。

POST/v1/task/get-result

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/get-result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task-xxx"}'

输入参数

提交任务——输入参数

提交任务请求体支持以下参数。

总计：4 个｜必填：3 个｜可选：1 个

promptstring必填

文本提示词，最大长度为 32,000 个字符。

sizestring必填

生成图像的尺寸。支持多种预设尺寸，包括 1024x1024、2048x2048、1280x720 和 2560x1440。

qualitystring必填

控制生成结果对原始输入图像的保留程度。

highmediumlow

imagearray[string]

参考图像 URL 列表，支持 1～10 张图像。列表不为空时使用图生图模式。

查询状态——输入参数

总计：1 个｜必填：1 个｜可选：0 个

task_idstring必填

提交任务接口返回的任务 ID。

获取结果——输入参数

总计：1 个｜必填：1 个｜可选：0 个

task_idstring必填

提交任务接口返回的任务 ID。

输出参数

提交任务——输出参数

总计：1 个

task_idstring

异步任务的唯一标识符。使用该 ID 查询任务状态并获取任务结果。

查询状态——输出参数

总计：1 个

statusstring

当前任务状态。当状态为 SUCCEEDED 时，可以获取生成结果。

SUBMITTEDSUCCEEDEDFAILED

获取结果——输出参数

响应体是一个资源对象数组（array[object]）。

总计：3 个

typestring

资源类型。对于图像模型，该值为 Image。

urlstring

生成图像的预览或在线访问 URL。

download_urlstring

生成图像的下载 URL，该 URL 的响应头中包含 attachment。

适用于 LLM 的提示词

以下是一个适用于 LLM 的 Markdown 提示词，可以复制到 Cursor、ChatGPT 或其他 AI 助手中，帮助它们理解该模型的 API 集成方式、请求流程和关键参数。

点击“复制 LLM 提示词”按钮，或复制下方完整代码块。

# openai/gpt-image-2-5-sunburst-economy

> OpenAI 的 GPT Image 2 文生图模型可根据自然语言提示词生成高质量图像。

## 概述

使用 iCreat 的三步异步任务 API 提交生成请求、轮询任务状态，并在任务成功后获取图像资源 URL。

## API 信息

- **基础 URL**：`https://api.icreat.ai`
- **提交接口（POST）**：`/v1/task/submit/openai/gpt-image-2-5-sunburst-economy`
- **状态查询接口（POST）**：`/v1/task/query-status`
- **结果获取接口（POST）**：`/v1/task/get-result`
- **模型 ID**：`openai/gpt-image-2-5-sunburst-economy`
- **身份验证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 工作流程

1. **提交任务**：向任务提交接口发送 POST 请求，请求体格式见下文。响应格式为 `{ "task_id": "..." }`。
2. **轮询状态**：向 `/v1/task/query-status` 发送 POST 请求，请求体为 `{ "task_id": "..." }`。响应仅包含 `{ "status": "SUBMITTED|SUCCEEDED|FAILED" }`。
3. **获取结果**：当 `status` 为 `SUCCEEDED` 时，向 `/v1/task/get-result` 发送 POST 请求。响应是一个顶层数组。对于 `type` 为 `Image` 的资源，可以读取其 `url` 或 `download_url`。

### 输入要求

- 请求体使用扁平化的顶层字段。
- 必填参数：`prompt`、`size`、`quality`
- 可选参数：`image`
- `prompt`（必填）：文本提示词，最大长度为 32,000 个字符。
- `size`（必填）：生成图像的尺寸。支持多种预设尺寸，包括 `1024x1024`、`2048x2048`、`1280x720` 和 `2560x1440`。
- `quality`（必填）：控制生成结果对原始输入图像的保留程度。
- `image`（可选）：参考图像 URL 列表，支持 1～10 张图像。列表不为空时使用图生图模式。

### 输出详情

- 状态轮询：只需检查 `status` 字段。
- 任务结果：返回以下格式的顶层数组：
  `[{ "type": "Image", "url": "...", "download_url": "..." }]`

## 注意事项

- 三个步骤必须使用同一个 `task_id`，不要跳过状态轮询步骤。
- `FAILED` 是终止状态。出现该状态时，请检查请求参数或参考内容是否存在问题。