Name1 API 文档
面向真实上线场景的 Name1 文档中心：创建 API令牌、完成人工充值、替换 base_url，并通过 OpenAI 兼容协议调用 /v1/chat/completions。
OpenAI SDK 兼容
现有项目通常只需要替换 base_url 和 API令牌 即可接入。
令牌级治理
支持额度限制、模型白名单、IP 白名单和过期时间。
人工充值
当前未接自动支付，由管理员确认后手动入账。
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
}'什么是 Name1
Name1 是一个 OpenAI 协议兼容的 AI API 聚合网关与 Token 中转站，负责统一鉴权、统一模型接入、统一余额扣费和统一调用观测。
OpenAI 协议兼容
沿用 /v1/chat/completions 和 OpenAI SDK 接入方式，通常只需要替换 base_url 与 API令牌。
细粒度访问控制
每个 API令牌 都可以独立设置额度、模型白名单、IP 白名单和过期时间。
余额系统与人工充值
平台已内置余额与消费记录，当前充值流程由用户联系管理员并由 Admin 手动入账。
可观测与运营后台
Dashboard 和 Admin 提供调用日志、审计日志、模型管理、用户管理与运营支持。
适用场景
团队统一出口
适合需要统一管理多个成员、多个项目或多个客户调用凭证的团队。
服务端集成
适合在后端服务、任务队列、内部工具或代理层里复用 OpenAI 兼容调用方式。
现有项目迁移
已有 OpenAI SDK 项目通常只需要替换 base_url 和 sk-n1_ 令牌 即可接入 Name1。
当前真实限制
以下限制需要在上线前明确告知用户，避免把暂未支持的能力误写成已支持功能。
stream=true 暂不支持
流式请求会返回 400 stream_not_supported。
当前为人工充值
充值需要用户联系管理员，Admin 后台确认后到账。
内存限流只适合单实例
多实例生产需要共享限流存储。
用 Name1 管理你的 AI API 调用
创建 API令牌，完成余额充值，替换 base_url，然后用 OpenAI SDK 或 cURL 发起第一条请求。