API 接入文档

接口与 OpenAI 的 chat completions 协议一致。请求体原样转发给上游，字段不裁剪。

Base URL：https://aiapigpt.com/v1
鉴权：API Key（sk- 开头）
协议：OpenAI chat completions（/v1/chat/completions）

文中 sk-your-sub2api-key 请替换为你自己的 Key，妥善保管、不要提交到代码仓库。

一、Base URL 与请求头

每个请求都带 Authorization: Bearer <你的 API Key>。Key 无效与 Key 被停用返回的状态码不同（401 / 403），但两者都不会透露这个 Key 是否存在。

Base URL

Authorization: Bearer sk-your-sub2api-key
Content-Type: application/json

二、端点

端点	说明
POST /v1/chat/completions	对话补全。stream 为 true 时按 SSE 逐块下发。
GET /v1/models	列出你当前可以调用的模型（需要鉴权）。只返回同时满足「有单价 + 有可用上游账号 + 在你的 Key 授权范围内」的模型，所以清单里不会出现调不动的项。
GET /healthz	健康检查，不需要鉴权。
其它路径	一律 404。除此之外本站不提供其它 OpenAI 端点（图片、音频、 embeddings 等都未实现）。

三、请求示例

三、1 curl

curl https://aiapigpt.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-sub2api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

三、2 Python SDK（openai）

from openai import OpenAI

client = OpenAI(
    base_url="https://aiapigpt.com/v1",
    api_key="sk-your-sub2api-key",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

四、有用的响应头

X-Request-Id: 本次请求 ID。你也可以在请求头里自带 X-Request-Id，方便与自己的日志对齐。
X-Sub2Api-Charge: ok = 已扣费；pending = 扣费失败、已登记补扣，稍后会自动重试。