GPT Image 2.5 Sunburst 经济版

GPT Images 2.5 Sunburst 是 OpenAI 推出的旗舰级高精视觉生成与编辑大模型。作为 GPT Images 2.5 系列中专注于极致画质与精准控图的专业版本，Sunburst 专为高端商业广告、影视概念设计与复杂视觉重构打造。模型支持最多 16 张参考图进行多轮无损编辑与多主体一致性锁定，具备出色的自然光影重建、强风格跟随与复杂版式文字渲染能力，并原生支持 PNG/WebP 透明背景通道与最高 4K (3840px) 极清分辨率输出。凭借顶级的细节还原与严谨的控制力，全面赋能高端品牌营销、跨境电商视觉包装与专业设计工作流。

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，再通过查询任务结果接口轮询进度；响应含 status 与 result（处理中为 []，SUCCEEDED 时 result 为资源列表且响应含 costUSD）。以下示例使用同一 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 与 result：非终态或处理中时 result 为 []；SUCCEEDED 时 result 为资源数组且响应含 costUSD；FAILED 表示任务失败。

POST/v1/task/result

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/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 个

task_idstring

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

查询任务结果 — 输出参数

总计: 可变

statusstring

当前任务状态。非成功时 result 通常为 []；SUCCEEDED 时 result 含资源项且响应含 costUSD。

SUBMITTEDSUCCEEDEDFAILED

resultarray[object]

生成资源列表。处理中或未成功时为 []；成功时为对象数组。

costUSDnumber

任务费用（美元），仅在 status 为 SUCCEEDED 时出现。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

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

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

## 概述

通过 iCreat 二段式异步任务 API 提交生成请求，再轮询查询任务结果接口，成功时从 `result` 获取图片资源 URL（含 `costUSD`）。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/openai/gpt-image-2-5-sunburst-economy`
- **Query result endpoint (POST)**：`/v1/task/result`
- **Model ID**：`openai/gpt-image-2-5-sunburst-economy`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Query result**：POST `/v1/task/result`，Body `{ "task_id": "..." }`；响应含 `status` 与 `result`（处理中 `result` 为 `[]`）；`SUCCEEDED` 时 `result` 为资源数组且含 `costUSD`，`type` 为 `Image` 时读取 `url` 或 `download_url`

### 输入要点

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

### 输出要点

- 轮询：看 `status`；`result` 处理中为 `[]`
- 成功：`result` 为 `[{ "type": "Image", "url": "...", "download_url": "..." }]`，并含 `costUSD`

## 注意事项

- 两步须用同一 `task_id` 串联；处理中 `result` 为 `[]`，需继续轮询
- `FAILED` 为终态，需排查请求参数或参考内容