快速开始

本快速开始将创建一个 GPT Image 2 任务，保存 APIPod 任务 ID，并轮询结果接口。

创建 API Key

设置本地环境变量

export APIPOD_API_KEY="your-api-key"
export APIPOD_IDEMPOTENCY_KEY="image-$(date +%s)"

每次逻辑创建操作使用一个稳定且唯一的幂等键。如果网络故障导致结果不确定，请使用同一个键和完全相同的 JSON 请求体重试。

创建图片任务

curl https://api.apipod.ai/v1/images/generations \
  -H "Authorization: Bearer $APIPOD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $APIPOD_IDEMPOTENCY_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product photograph of a translucent glass speaker, soft studio lighting",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }'

创建成功时返回以下结构：

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "img_example_task_id"
  }
}

轮询任务

export APIPOD_TASK_ID="img_example_task_id"

curl "https://api.apipod.ai/v1/images/status/$APIPOD_TASK_ID" \
  -H "Authorization: Bearer $APIPOD_API_KEY"

状态为 pending 或 processing 时继续轮询；状态变为 completed、failed 或 cancelled 时停止。

完成响应

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "img_example_task_id",
    "status": "completed",
    "result": [
      "https://example.com/generated-image.png"
    ],
    "completed_at": 1786358400
  }
}

创建接口返回 HTTP 200 只表示任务已受理，并不表示图片或视频已经生成完成。

GPT Image 2 参数

查看全部支持字段和五种语言请求示例。

任务生命周期

补齐生产级轮询、Webhook 和终态处理。

概览

核心概念

完成响应

GPT Image 2 参数

任务生命周期

​完成响应

GPT Image 2 参数

任务生命周期

完成响应