API 文档

兼容 OpenAI Images API 格式，可直接接入 Claude Code、OpenClaw、Dify 等工具。

Base URL

Base URL
https://aigc-pic.com/v1

认证方式

支持两种认证方式，任选其一：

  • x-api-keyheader —— 在个人中心创建 API Key
  • Authorization: Bearer <token>header —— 登录后的 JWT token
示例
# 方式一：x-api-key header
curl -H "x-api-key: aigc_xxxxxxxxxxxx" https://aigc-pic.com/v1/models

# 方式二：Bearer token
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" https://aigc-pic.com/v1/models

接口列表

POST/v1/images/generations

生成图片（同步等待结果返回）

请求参数 (JSON Body)

promptstring (必填)

图片描述，最长 8000 字符

modelstring

模型名称，默认 gpt-image-2-all

ninteger

生成数量 1-4，默认 1（每张消耗 1 积分）

sizestring

尺寸，如 1024x1024、2048x2048

qualitystring

质量：standard / hd

response_formatstring

返回格式：url（默认）/ b64_json

请求示例

curl
curl -X POST https://aigc-pic.com/v1/images/generations \
  -H "x-api-key: aigc_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一只可爱的橘猫坐在窗台上看夕阳",
    "model": "gpt-image-2-all",
    "n": 1,
    "size": "1024x1024"
  }'

成功响应

JSON
{
  "created": 1711234567,
  "data": [
    {
      "url": "https://aigc-pic.com/uploads/xxx_0.png",
      "revised_prompt": "一只橘猫趴在窗台上..."
    }
  ]
}
GET/v1/images/generations/:id

查询之前的生成记录

curl
curl https://aigc-pic.com/v1/images/generations/PASTE_IMAGE_ID \
  -H "x-api-key: aigc_xxxxxxxxxxxx"
GET/v1/models

列出可用模型（无需认证）

curl
curl https://aigc-pic.com/v1/models

响应

JSON
{
  "object": "list",
  "data": [
    { "id": "gpt-image-2-all", "object": "model", "owned_by": "aigc-pic" },
    { "id": "gpt-image-2-vip", "object": "model", "owned_by": "aigc-pic" }
  ]
}
GET/v1/credits

查询剩余积分

curl
curl https://aigc-pic.com/v1/credits \
  -H "x-api-key: aigc_xxxxxxxxxxxx"

响应

JSON
{
  "object": "credits",
  "credits": 100,
  "email": "[email protected]",
  "email_verified": true
}

可用模型

gpt-image-2-all

全功能模型，根据提示词自动选择最佳尺寸。速度快，适合日常使用。

每次消耗 1 积分

gpt-image-2-vip

高质量模型，支持精确尺寸控制。适合需要精细调整的场景。

每次消耗 1 积分

错误处理

所有错误统一返回 OpenAI 兼容格式：

错误格式
{
  "error": {
    "message": "可读的错误描述",
    "type": "invalid_request_error | authentication_error | server_error",
    "code": "错误代码"
  }
}
400

请求参数有误

401

API Key 无效或缺失

402

积分不足

403

邮箱未验证

500

服务器错误（积分会自动退还）

如何获取 API Key？

  1. 注册并登录 aigc-pic.com
  2. 进入个人中心 → API Key 管理
  3. 点击"创建 API Key"，复制生成的密钥
  4. 在请求头中设置 x-api-key: aigc_xxxxxxxx

如有问题请联系客服或加入微信福利群