开发文档 · 折光 AI

快速开始

创建 API Key 后，将客户端 Base URL 指向折光 AI。建议为开发、测试和生产分别创建密钥。

身份认证

所有请求使用 Bearer Token。密钥只能保存在服务端环境变量中。

HTTP Header

Authorization: Bearer zg-demo-key
Content-Type: application/json

文本模型

POST /v1/responses

curl https://api.zheguangai.com/v1/responses \
  -H "Authorization: Bearer $ZHEGUANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "你好",
    "stream": false
  }'

图像模型

POST /v1/images/generations

{
  "model": "gpt-image",
  "prompt": "柔和自然光下的护肤产品静物摄影",
  "size": "1024x1536",
  "quality": "medium"
}

错误处理

对 429、502、503 和 504 使用指数退避，不要无限重试。
为每次业务请求生成幂等标识，避免重复扣费或重复任务。
生产环境设置连接、首字与总请求超时，并记录请求 ID。