开始你的第一次调用
一个兼容的接口，一条清晰的接入路径。
01 · 创建账户和 Key
先注册或登录，再前往 API Keys 创建应用密钥。建议为每个应用单独创建，设置有效期、额度和模型范围。
02 · 在服务端保存密钥
使用环境变量 APILUMA_API_KEY 保存你的密钥。通过 Authorization: Bearer 发送；不要把密钥写入网页代码、URL 或公共仓库。
export APILUMA_API_KEY='YOUR_API_KEY'需要更换密钥时，先创建新 Key，更新应用配置，再停用旧 Key。
03 · 选择模型并发起请求
从当前公开目录选择模型。Python 示例使用 OpenAI SDK，可先运行 pip install openai。
示例只会复制代码，不会在网页里发送你的密钥或发起付费调用。
支持的接口
/v1/models查询密钥可访问的模型
/v1/chat/completions文本对话；流式能力按具体模型验证
Base URL 为 https://api.apiluma.com/v1。SDK 通常会自动添加 /chat/completions，无需重复添加 /v1。
04 · 核对额度与调用记录
账户额度和密钥额度是不同的限制。创建 Key 不会增加账户额度。在线充值暂未开放；管理员可按实际开通情况配置额度，已有兑换码可在额度页兑换。
公开模型页展示所选分组的参考价；实际消耗以账户分组和调用记录为准。请求完成后刷新日志查看结果，统计可能存在处理延迟。
遇到问题时
401检查 Key 是否有效、完整，或已经过期。403检查密钥权限、模型范围和账户分组。429可能触发限流或额度限制；查看错误信息后退避重试。5xx上游或网关暂时异常。保留 request id，避免密集重试。数据与隐私
请求内容会被转发给所选模型对应的上游服务，处理规则取决于实际使用的服务。平台保留账户、额度和调用记录，用于鉴权、计量及故障排查；当前尚未公布固定的日志保留周期。
使用 Google 登录时，我们会接收 Google 账户的唯一标识、姓名和邮箱，用于创建或识别账户、完成登录并关联已有账户功能。仅申请 openid、profile 和 email 权限，不申请 Gmail、云端硬盘或联系人访问权限。你可以在 Google 账户中撤销授权；如需删除 Apiluma 账户或咨询数据处理，请联系 [email protected]。
请仅使用你有权提交的数据，并妥善保管密钥。公开页面不采集 API Key，不运行调用演示。当前版本不作零存储或持续可用性的承诺。