API 文档

图片生成采用异步任务模式。提交后请保存 taskId，并通过任务接口获取生成进度和结果。

认证

在控制台创建 API Key，使用 Bearer Token 调用。

Authorization: Bearer pk_xxxxx

创建生图任务

POST /api/v1/images/generations

字段	类型	说明
model	string	gpt-image-2 / gemini-3.1-flash-image-preview / gemini-3-pro-image-preview
prompt	string	提示词
size	string	模型支持的比例，例如 auto / 1:1 / 16:9
resolution	string	模型支持的分辨率档位
image_urls	string[]	外部参考图 URL 或 data:image base64
n	number	生成数量。gpt-image-2 固定 1，Gemini 为 1-4

cURL

curl https://piccc.ai/api/v1/images/generations \
  -H "Authorization: Bearer pk_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "a premium product poster in studio lighting",
    "image_urls": ["https://example.com/ref.png"],
    "size": "1:1",
    "resolution": "2K",
    "n": 1
  }'

响应示例

{
  "success": true,
  "taskId": "img_...",
  "status": "submitted",
  "created": 1778190000,
  "cost": 8,
  "credits_remaining": 92
}

查询任务

GET /api/tasks/{taskId}

任务接口会返回当前状态、消耗积分与可访问的结果图片地址。

模型配置

GET /api/images/models