鉴权方式

宁享Token 使用标准的 Bearer Token 鉴权。所有需要鉴权的接口都要在请求头中携带 Authorization: Bearer <API_KEY>。

获取 API Key

1. 登录 宁享Token 控制台
2. 进入「密钥管理」页面
3. 点击「创建密钥」，复制生成的 Key（仅展示一次，请妥善保存）

API Key 是访问 宁享Token 的唯一凭证，请勿提交到代码仓库或暴露在前端代码中。

基本用法

在请求头中携带 Authorization：

curl /v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role":"user","content":"hello"}]
  }'

各 SDK 配置示例

OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role":"user","content":"hello"}]
)
print(resp.choices[0].message.content)

OpenAI Node SDK

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: '/v1'
})

const resp = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'hello' }]
})
console.log(resp.choices[0].message.content)

Anthropic Python SDK (Claude 协议)

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-api-key",
    base_url=""
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role":"user","content":"hello"}]
)
print(msg.content[0].text)

Google GenAI Python SDK (Gemini 协议)

from google import genai

client = genai.Client(
    api_key="sk-your-api-key",
    http_options={"base_url": "/v1beta"}
)

resp = client.models.generate_content(
    model="gemini-3.1-pro",
    contents="hello"
)
print(resp.text)

安全建议

• 服务端调用：API Key 仅在服务端使用，不要打包进客户端 App 或浏览器代码。
• 环境变量：使用环境变量或密钥管理服务保存 Key，避免硬编码。
• 最小权限：为不同业务/环境创建独立 Key，便于配额管理与吊销。
• 监控异常：在控制台开启用量告警，发现异常调用立即禁用 Key。

下一步

• 快速开始：跑通第一个请求
• SDK 使用：更多 SDK 配置细节