GPT Image 2.5 Flare

接入前须知

模型 ID

gpt-image-2.5-flare

输出类型

图片

API 协议

异步任务 API

分辨率

未公布

画幅

未公布

参考图

支持

产物保留时间

14 天，请在过期前下载

API 地址

https://open.scenepond.ai/v1

仅准备此接口接受的素材和参数。通过 API 传入的参考素材网址必须可访问。

模型特点与局限

• 明确主体、构图和光线，确认图片前检查细节与一致性。
• 使用 GPT Image 时，以相同提示词比较支持的质量档位，最终图片费用由 token 用量决定。

已发布的参数描述此接口。未列出的能力尚未核实，发布前请检查输出质量和输入素材的使用权。

价格表

示例账单: 1 张 · token 用量估算示例 $0.0224

价格取决于模型配置。用量记录显示已记录的扣费；异步任务完成后可能调整费用。

第一个请求

创建 API Key，在服务端环境中设置 SCENEPOND_API_KEY。不要在浏览器代码中暴露密钥。

curl --fail-with-body -X POST "https://open.scenepond.ai/v1/tasks" \
  -H "Authorization: Bearer $SCENEPOND_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "gpt-image-2.5-flare",
  "parameters": {
    "count": 1,
    "prompt": "A quiet lakeside at sunrise, soft light and a clear subject."
  }
}
JSON

如何确认结果

1. 保存创建响应中的 task_id。状态和进度仅表示任务已被接受，不代表产物已生成。
2. GET /v1/tasks/{task_id} — 每隔几秒轮询，直到 succeeded 或 failed。不要通过新建任务来查询进度。
3. GET /v1/tasks/{task_id}/artifacts — 成功后获取产物列表，使用同一 API Key 在 artifacts[].expires_at 之前下载 artifacts[].content_url。
4. 失败时读取 error.code 与 error.message；如果返回了 error.retryable 和 error.charged，请核对是否可重试及是否扣费。字段缺失时，重试前先核对用量并联系支持。

curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID" \
  -H "Authorization: Bearer $SCENEPOND_API_KEY"

curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
  -H "Authorization: Bearer $SCENEPOND_API_KEY"

按现象排查错误

HTTP 错误表示请求失败。HTTP 响应成功后任务仍可能失败，请读取任务状态与错误字段。

联系支持时请提供：时间、模型 ID、任务 ID 和错误信息。不要提供密钥。

能做什么与提示词示例

常见问题

相关模型