API 文档

快速开始

本平台提供 OpenAI 兼容的 API 接口，支持 GPT-4、Claude、DeepSeek 等多种模型。只需 3 步即可开始使用：

注册账号并登录
在「余额充值」中充值余额
在「API Token」中创建一个 Token，使用下方接口调用

Base URL: https://xghax1337.top/api/v1

认证方式

在请求头中携带 API Token 进行认证：

Authorization: Bearer sk-your-api-token-here

Chat Completions

POST /api/v1/chat/completions

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称，如 gpt-4o、claude-3-sonnet-20240229
`messages`	array	是	消息数组，格式同 OpenAI
`stream`	boolean	否	是否启用流式输出，默认 false
`temperature`	number	否	温度参数，默认 0.7
`max_tokens`	integer	否	最大输出 token 数，默认 2000

请求示例

curl https://xghax1337.top/api/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

模型列表

GET /api/v1/models

curl https://xghax1337.top/api/v1/models \
  -H "Authorization: Bearer sk-your-token"

用量查询

GET /api/v1/usage

返回余额、今日用量、总用量等信息。

curl https://xghax1337.top/api/v1/usage \
  -H "Authorization: Bearer sk-your-token"

代码示例

Python (openai 库)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-token",
    base_url="https://xghax1337.top/api/v1"
)

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

Python (流式输出)

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

JavaScript (fetch)

const response = await fetch("https://xghax1337.top/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-your-token",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-4o",
    messages: [{ role: "user", content: "Hello!" }]
  })
});
const data = await response.json();
console.log(data.choices[0].message.content);

目录