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
}'上线准备
部署
生产部署需要完整环境变量、PostgreSQL、强密钥、HTTPS、受限 CORS 和可验证的上游配置。
生产环境变量
| 环境变量 | 说明 |
|---|---|
| DATABASE_URL | 生产数据库连接，建议 PostgreSQL。 |
| JWT_SECRET | 登录会话签名密钥，必须强随机。 |
| API_KEY_HASH_PEPPER | API令牌 hash pepper，必须强随机且不能泄露。 |
| UPSTREAM_BASE_URL | 上游 OpenAI 兼容接口地址，影响质量和可用性。 |
| UPSTREAM_API_KEY | 上游服务端密钥，只能在服务端环境变量中配置。 |
| NEXT_PUBLIC_APP_URL | Name1 对外访问域名。 |
| UPSTREAM_TIMEOUT_MS | 上游请求超时时间。 |
| MAX_REQUEST_BODY_BYTES | 最大请求体大小。 |
| API_RATE_LIMIT_PER_MINUTE | 单实例每分钟限流阈值。 |
| ALLOWED_ORIGINS | 允许的浏览器来源，生产环境应显式限制。 |
| SEED_ADMIN_EMAIL | 初始化管理员邮箱。 |
| SEED_ADMIN_PASSWORD | 初始化管理员密码，上线后必须更换。 |
强密钥要求
JWT_SECRET 和 API_KEY_HASH_PEPPER 必须使用强随机值；UPSTREAM_API_KEY 不能暴露给浏览器、README 示例或日志。
多实例限流提醒
当前内存限流不适合多实例生产。多实例部署建议迁移到 Redis 等共享限流存储。
用 Name1 管理你的 AI API 调用
创建 API令牌，完成余额充值，替换 base_url，然后用 OpenAI SDK 或 cURL 发起第一条请求。