参考文档GPT Image 2.5 稳定版本

TopviewAI Pro 工作台 API 指南

管理 API 密钥并了解登录后的工作台请求。以下图片接口示例使用 GPT Image 2.5，其他模型各有自己的请求格式。

https://topviewai.pro
01

快速上手

仅需两个步骤即可完成你的第一次 API 调用：提交生成任务，然后轮询查询任务状态。

1

提交任务

向生成接口发送 POST 请求以获取 Task ID。

2

查询状态

使用 Task ID 检查进度，直到获取图片 URL。

02

身份验证

这些工作台接口同时要求已登录会话和 API 密钥，仅提供 Bearer 密钥无法调用。请妥善保管密钥。

HTTP 请求头
Authorization: Bearer {YOUR_API_KEY}
POST
https://topviewai.pro/api/image/gpt-image-2-5/generate

提交 GPT Image 2.5 图片请求。响应返回 task_id，请通过对应状态接口查询结果。

接口异步执行：请保存 task_id，轮询对应状态接口，直到 SUCCESS 或终止错误。

请求体参数

参数名称类型必填描述
promptstring是使用 1～20,000 个字符描述图片。
aspect_ratiostring否可选图片比例，默认 auto。例如：1:1、4:3、3:4、16:9、9:16。
返回示例（JSON）
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://topviewai.pro/api/image/gpt-image-2-5/status

查询任务执行状态与生成结果。

查询参数

参数名称必填描述
task_id是提交任务时返回的任务 ID。
返回示例
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "群山间的落日",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

计费

GPT Image 2.5 费用示例

4 积分 / 张 1K 图片

消耗随模型、分辨率和设置变化，请查看工作台预估积分及任务实际记录的用量。

错误处理

  • 401 未授权无效的 API Key
  • 402 需要付款余额不足
  • 429 请求过多触发速率限制
03

关于 TopviewAI Pro

视频、图片、编辑、语音和音频共用一个工作台。

为每项任务自主选择模型

可使用 Seedance 2.5 制作视频、GPT Image 2.5 制作图片，也可选择工作台中的其他模型。所有模型均使用真实名称。

共用积分，按模型计费

选择订阅或一次性按量充值。积分用于支付实际使用的模型和工具。

图片工具视频工具

© 2026 TopviewAI Pro.