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
}'接口规范
API 参考
Name1 当前提供 OpenAI 兼容的 Chat Completions 转发接口，适合 SDK、服务端任务和后端代理接入。
Endpoint
所有 OpenAI 兼容调用都通过你的部署域名进入 Name1 网关。
POST /v1/chat/completions
请求示例
POST /v1/chat/completions
Authorization: Bearer sk-n1_xxx
Content-Type: application/json
{
"model": "gpt-4o-mini",
"messages": [
{ "role": "system", "content": "You are concise." },
{ "role": "user", "content": "Hello" }
],
"temperature": 0.7,
"max_tokens": 512,
"stream": false
}Headers
| 名称 | 值 | 必填 | 说明 |
|---|---|---|---|
| Authorization | Bearer sk-n1_xxx | 是 | 使用 Name1 生成的 sk-n1_ API令牌。旧 sk-mg_ 仅用于兼容旧用户。 |
| Content-Type | application/json | 是 | 请求体必须是 JSON。 |
Request Body
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID。模型是否可用、是否启用以及价格由 Admin 后台维护。 |
| messages | array | 是 | OpenAI 兼容消息数组，至少包含一条 user 消息。 |
| temperature | number | 否 | 采样温度，可按模型能力传入。 |
| max_tokens | integer | 否 | 最大输出 tokens，是否生效取决于上游模型能力。 |
| stream | boolean | 否 | 当前必须为 false 或不传；stream=true 暂不支持。 |
OpenAI 风格响应
{
"id": "chatcmpl_name1_abc123",
"object": "chat.completion",
"created": 1767225600,
"model": "gpt-4o-mini",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Name1 provides an OpenAI-compatible gateway for managed AI API access."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 18,
"completion_tokens": 14,
"total_tokens": 32
}
}响应字段说明
id
本次 Chat Completion 的响应 ID。
object
对象类型，通常为 chat.completion。
choices
模型返回的候选结果数组。
usage
输入、输出和总 tokens，用于日志与扣费计算。
已支持 stream=true（流式 SSE）
传入 stream=true 即可获得 OpenAI 兼容的 SSE 流式响应，费用在流结束后按实际 tokens 结算。
用 Name1 管理你的 AI API 调用
创建 API令牌，完成余额充值，替换 base_url，然后用 OpenAI SDK 或 cURL 发起第一条请求。