登录后可同步历史记录并解锁更多功能
开发者资源

GPT Image 1.5 API 文档

将 OpenAI 的 GPT Image 1.5 模型集成到您的应用中。支持文生图和图生图，简单易用的 REST API。

1

身份认证

GPT Image 1.5 API 使用 Bearer Token 认证。在请求头中传递您的 API Key。

身份认证
Authorization: Bearer sk-your-api-key-here

请妥善保管您的 API Key，不要在客户端代码中暴露。

定价

类型费用描述
文生图10 积分根据文本提示生成图片。
图生图10 积分使用文本提示编辑现有图片。
2

创建任务

POSThttps://gptimage15.ai/api/generate
异步生成

定价

每次生成请求消耗 10 Credits，无论是文生图还是图生图。

发起一个生成任务。API 会立即返回 task_id，您可以用它来轮询获取结果。

请求体参数

参数类型必填描述
promptstring必填图片生成的文本描述。最多 2000 个字符。
sizestring可选图片尺寸：1024*1024、1024*1536 或 1536*1024。默认：1024*1024
qualitystring可选图片质量：low、medium 或 high。默认：medium
imagesarray可选用于图生图模式。要编辑的图片 URL 数组。
input_fidelitystring可选对输入图片的保真度：low 或 high。默认：high。仅用于图生图。
callback_urlstring可选任务完成时的 Webhook 回调 URL。

请求示例

Text-to-Image (cURL)
curl -X POST https://gptimage15.ai/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape...",
    "size": "1536*1024",
    "quality": "high"
  }'
Image-to-Image (Edit Mode)
{
  "prompt": "Add a rainbow in the sky",
  "images": [
    "https://example.com/landscape.jpg"
  ],
  "input_fidelity": "high",
  "quality": "medium"
}
成功响应
{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS"
  }
}
错误响应
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

查询状态

GEThttps://gptimage15.ai/api/status

轮询此接口以查询任务进度。建议每 5-10 秒轮询一次。

查询参数

参数类型描述
task_idstring从生成接口获取的任务 ID。 必填

状态值

PENDING任务排队中
IN_PROGRESS处理中
SUCCESS已完成
FAILED发生错误
cURL
curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
响应（处理中）
{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}
响应（已完成）
{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}
响应（失败）
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

错误码

状态码描述
200成功
400请求错误 - 参数无效（缺少 prompt、size/quality 无效等）
401未授权 - API Key 缺失或无效
404未找到 - 任务 ID 不存在
500服务器内部错误 - 请重试或联系支持

需要帮助？

访问我们的支持渠道或发送邮件联系我们。

联系支持