接口调用文档

这里是公开可查看的 Sub2API OpenAI 兼容接口说明。真实调用时需要在请求头中携带你的 API Key，Base URL 填 https://ai.wwz8.xyz/v1。

基础信息

Base URLhttps://ai.wwz8.xyz/v1

推荐模型gpt-5.5

认证方式Authorization: Bearer sk-...

不要直接 POST 到 /v1，它只是基础路径。实际接口需要加 /responses 或 /chat/completions。

Responses 接口

GPT-5 系列推荐使用 Responses API。

curl https://ai.wwz8.xyz/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句中文回复：测试成功。",
    "stream": false
  }'

Chat Completions

如果你的客户端只支持旧格式，可以使用 Chat Completions。

curl https://ai.wwz8.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，测试一下。"}
    ],
    "stream": false
  }'

Python 示例

import requests

api_key = "YOUR_API_KEY"
url = "https://ai.wwz8.xyz/v1/responses"

payload = {
    "model": "gpt-5.5",
    "input": "用一句中文回复：Sub2API 调用测试成功。",
    "stream": False,
}

response = requests.post(
    url,
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=60,
)

print(response.status_code)
print(response.json())

常见错误

API_KEY_REQUIRED：没有在请求头携带 API Key。

INVALID_API_KEY：API Key 不存在、已删除或已被禁用。

Service temporarily unavailable：后台没有可用上游账号，或该分组没有开启调度。

POST /v1 返回 HTML：请求地址写错了，需要调用 /v1/responses。