Appearance
HTTP API 与 SDK
极智网关提供 OpenAI 与 Anthropic 兼容接口。大多数支持自定义 Base URL 的 SDK 和客户端都可以直接接入。
接口地址
| 协议 | Base URL | 鉴权方式 |
|---|---|---|
| OpenAI 兼容 | https://api.aethesauce.space/v1 | Authorization: Bearer <API_KEY> |
| Anthropic 兼容 | https://api.aethesauce.space | SDK 密钥参数或 x-api-key |
模型 ID 和可用范围取决于当前分组，请以控制台实时列表为准。
OpenAI SDK
python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AETHE_API_KEY"],
base_url="https://api.aethesauce.space/v1",
)
response = client.chat.completions.create(
model="<MODEL_ID>",
messages=[
{"role": "user", "content": "你好，请用一句话介绍自己"}
],
)
print(response.choices[0].message.content)
Anthropic SDK
python
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["AETHE_API_KEY"],
base_url="https://api.aethesauce.space",
)
message = client.messages.create(
model="<MODEL_ID>",
max_tokens=1024,
messages=[
{"role": "user", "content": "你好，请用一句话介绍自己"}
],
)
print(message.content[0].text)
流式响应
OpenAI 兼容请求中设置 stream: true 即可请求 Server-Sent Events（SSE）流：
bash
curl https://api.aethesauce.space/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<MODEL_ID>",
"stream": true,
"messages": [{"role": "user", "content": "写一个快速排序"}]
}'
客户端必须持续读取响应流，不能等整个请求结束后再一次性解析 JSON。
生产环境建议
- 从环境变量或密钥管理服务读取 API 密钥，不要写入源码。
- 设置合理的连接超时与请求超时。
- 只对网络错误、
429和部分5xx使用有限次数的指数退避重试。 - 记录服务端返回的请求 ID，排障时不要记录完整密钥或敏感对话内容。
- 为不同应用创建独立密钥并设置额度上限。