Name1 API
Name1 API 文档
面向真实上线场景的 Name1 文档中心：创建 API令牌、完成人工充值、替换 base_url，并通过 OpenAI 兼容协议调用 /v1/chat/completions。
OpenAI SDK 兼容
现有项目通常只需要替换 base_url 和 API令牌 即可接入。
令牌级治理
支持额度限制、模型白名单、IP 白名单和过期时间。
人工充值
当前未接自动支付，由管理员确认后手动入账。
POST /v1/chat/completions
curl https://your-domain.com/v1/chat/completions \
-H "Authorization: Bearer sk-n1_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "Hello Name1" }
],
"stream": false
}'排障
错误码
错误响应采用 OpenAI 兼容风格。下表列出用户最常见的状态码、code、场景和处理建议。
| 状态码 | code | 场景 | 处理建议 |
|---|---|---|---|
| 400 | stream_not_supported | 请求传入 stream=true。 | 改为 false 或删除 stream 字段。 |
| 401 | missing_authorization | 缺少 Authorization header。 | 添加 Authorization: Bearer sk-n1_xxx。 |
| 401 | invalid_api_key | API令牌 无效、被删除、过期或前缀不被接受。 | 在 Dashboard 重新创建 sk-n1_ 令牌。 |
| 402 | insufficient_balance | 账户余额或 令牌 额度不足。 | 完成充值或调整 令牌 额度后重试。 |
| 403 | model_not_allowed | 令牌 的模型白名单不允许该模型。 | 更换模型或调整 API令牌 白名单。 |
| 403 | ip_not_allowed | 请求来源 IP 不在 令牌 白名单。 | 从允许的出口 IP 调用，或更新 IP 白名单。 |
| 404 | model_not_found | 模型不存在、未启用或未在后台维护。 | 在模型广场查看可用模型，或联系管理员。 |
| 429 | rate_limited | 超过当前限流阈值。 | 降低请求频率，或调整 API_RATE_LIMIT_PER_MINUTE。 |
| 502 | upstream_error | 上游服务返回错误或不可用。 | 检查 UPSTREAM_BASE_URL、上游状态和超时设置。 |
用 Name1 管理你的 AI API 调用
创建 API令牌，完成余额充值，替换 base_url，然后用 OpenAI SDK 或 cURL 发起第一条请求。