文档
5 分钟完成接入
OpenLux 兼容 OpenAI 接口协议。把 base_url 指向 OpenLux,并替换密钥,即可沿用现有代码与 SDK。
1. 获取 API Key
登录后进入 控制台,在「API Key 管理」中创建密钥。密钥仅在创建时完整展示一次,请妥善保存。
2. 调用示例
cURL
curl https://openlux.lol/v1/chat/completions \
-H "Authorization: Bearer $OPENLUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}'Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-openlux-...",
base_url="https://openlux.lol/v1",
)
resp = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)3. 兼容的接口
/v1/chat/completions:对话与多模态输入/v1/images/generations:图像生成与编辑/v1/embeddings:向量与检索/v1/models:可用模型列表
4. 计费与用量
按量计费,调用前可在 模型列表 查询单价;充值余额与消费明细实时可见,支持预算提醒。
5. 错误码
| HTTP | 说明 | 处理建议 |
|---|---|---|
| 401 | 密钥无效或已停用 | 在控制台重新生成 API Key |
| 402 | 余额不足 | 充值后重试,或切换到更低成本模型 |
| 429 | 触发限流 | 降低并发或稍后重试 |
| 5xx | 上游或链路异常 | 自动重试;持续失败请联系客服 |
6. 获取帮助
遇到问题可通过 联系我们 提交工单,或发送邮件至 support@openlux.lol,技术团队 7×24 小时响应。