API 文档

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

Base URL

https://aigc-pic.com/v1

认证方式

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

x-api-key header —— 在个人中心创建 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)

参数	类型	说明
prompt	string (必填)	图片描述，最长 8000 字符
model	string	模型名称，默认 gpt-image-2-all
n	integer	生成数量 1-4，默认 1（每张消耗 1 积分）
size	string	尺寸，如 1024x1024、2048x2048
quality	string	质量：standard / hd
response_format	string	返回格式：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": "错误代码"
  }
}

HTTP 状态码	说明
400	请求参数有误
401	API Key 无效或缺失
402	积分不足
403	邮箱未验证
500	服务器错误（积分会自动退还）

如何获取 API Key？

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

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