本平台完全兼容 OpenAI API 格式,可直接使用 OpenAI SDK 或任何兼容客户端。
| 项目 | 内容 |
|---|---|
| Base URL | https://api.huanyuf.top |
| 认证方式 | Bearer Token (API Key) |
| 请求格式 | JSON |
| 响应格式 | JSON / SSE (流式) |
请求地址: POST /v1/chat/completions
请求头:
Authorization: Bearer sk-你的密钥 Content-Type: application/json
请求示例:
{ "model": "claude-opus-4-6", "messages": [ {"role": "system", "content": "你是一个有用的助手"}, {"role": "user", "content": "你好,请介绍一下自己"} ], "stream": false, "max_tokens": 4096 }
curl 示例:
curl https://api.huanyuf.top/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的密钥" \ -d '{ "model": "claude-opus-4-6", "messages": [{"role": "user", "content": "Hello!"}] }'
Python 示例:
from openai import OpenAI client = OpenAI( api_key="sk-你的密钥", base_url="https://api.huanyuf.top/v1" ) response = client.chat.completions.create( model="claude-opus-4-6", messages=[ {"role": "user", "content": "你好"} ] ) print(response.choices[0].message.content)
设置 “stream”: true 即可获得 SSE 流式响应:
stream = client.chat.completions.create( model="claude-opus-4-6", messages=[{"role": "user", "content": "写一首诗"}], stream=True ) for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="")
| 状态码 | 含义 | 解决方法 |
|---|---|---|
| 400 | 请求参数错误 | 检查模型名称和请求格式 |
| 401 | 认证失败 | 检查 API Key 是否正确 |
| 429 | 请求频率超限 | 降低请求频率,稍后重试 |
| 500 | 服务器内部错误 | 联系管理员 |