Name1 API

Name1 API 文档

面向真实上线场景的 Name1 文档中心：创建 API令牌、完成人工充值、替换 base_url，并通过 OpenAI 兼容协议调用 /v1/chat/completions。

创建 API令牌

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
  }'

余额系统

计费与人工充值

Name1 当前采用人工充值。自动支付暂未接入，因此充值需要用户联系管理员并由 Admin 后台确认。

复制注册邮箱

用户在 Billing 页面复制自己的注册邮箱，作为充值识别信息。

联系管理员

把注册邮箱和充值金额发给管理员，按实际运营方式完成付款沟通。

管理员手动充值

管理员在 /admin/manual-recharge 搜索用户邮箱，输入金额和备注后确认。

余额到账

确认后系统写入 RechargeOrder、BalanceRecord 和 AuditLog，并更新用户余额。

按用量扣费

成功 API 调用会根据 usage 和模型价格产生消费记录。

余额不足

余额不足时请求会被拦截，并返回 402 insufficient_balance。

开始接入

用 Name1 管理你的 AI API 调用

创建 API令牌，完成余额充值，替换 base_url，然后用 OpenAI SDK 或 cURL 发起第一条请求。

创建 API令牌打开 Dashboard