Authentication

使用 Bearer Token 方式对所有 API 请求进行身份认证。你需要在每个请求中携带 API Key。

Bearer Token 认证

Authorization 请求头

在每个请求中添加 Authorization 请求头，格式如下：

Authorization: Bearer <你的API Key>

其中 <你的API Key> 替换为你在平台创建的密钥，通常以 sk- 开头。

完整的请求头示例：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

获取 API Key

1. 登录 零派智能业务平台。
2. 进入 API Key 管理页面。
3. 点击创建按钮。
4. 设置名称、额度或权限（如平台提供）。
5. 复制生成的 API Key（形如 sk-xxxxxxxx）。

创建后请立即保存 API Key，部分平台仅在创建时显示一次完整密钥。

安全建议

• 不要将 API Key 硬编码在代码中。 建议使用环境变量管理，例如 API_KEY。
• 不要将 API Key 提交到版本控制。 将 .env 文件加入 .gitignore。
• 不要在前端代码中暴露 API Key。 在生产环境中应通过后端代理转发请求。
• 定期轮换密钥。 如果密钥泄露，立即在平台删除并重新创建。
• 按用途创建不同令牌。 为不同项目、不同环境分别创建 Token，便于管理与隔离。

代码示例

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $API_KEY"

import os
import requests

base_url = os.environ.get("BASE_URL")
api_key = os.environ.get("API_KEY")

response = requests.get(
    f"{base_url}/v1/models",
    headers={
        "Authorization": f"Bearer {api_key}",
    },
)

print(response.status_code)
print(response.json())

const baseURL = process.env.BASE_URL;
const apiKey = process.env.API_KEY;

const response = await fetch(`${baseURL}/v1/models`, {
  headers: {
    Authorization: `Bearer ${apiKey}`,
  },
});

console.log(response.status);
console.log(await response.json());

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  baseURL := os.Getenv("BASE_URL")
  apiKey := os.Getenv("API_KEY")

  req, err := http.NewRequest("GET", baseURL+"/v1/models", nil)
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+apiKey)

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(resp.StatusCode)
  fmt.Println(string(body))
}