身份认证

所有 API 请求都需要进行身份认证。CiYuanX 使用 Bearer Token 方式进行认证，确保你的 API 调用安全可靠。

获取 API 密钥

请前往控制台 → API 令牌页面创建和管理你的 API 密钥。

创建步骤

登录你的 CiYuanX 账户
进入控制台页面
点击左侧菜单中的"API 令牌"
点击"新建令牌"按钮
设置令牌名称和权限
复制生成的 API 密钥

代码示例

在请求头中通过 Authorization: Bearer YOUR_API_KEY 传入密钥：

cURLPythonTypeScript

bash

curl https://ciyuanx.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

python

import os
import requests

response = requests.post(
    "https://ciyuanx.io/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['AI_GATEWAY_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-4.1",
        "messages": [
            {"role": "user", "content": "Hello!"}
        ],
    },
)

print(response.json())

typescript

const response = await fetch("https://ciyuanx.io/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.AI_GATEWAY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-4.1",
    messages: [{ role: "user", content: "Hello!" }],
  }),
});

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

安全注意事项

注意

请妥善保管你的 API 密钥，不要将其暴露在客户端代码中
定期轮换 API 密钥，提高账户安全性
如果 API 密钥泄露，请立即在控制台中删除并重新生成
建议使用环境变量存储 API 密钥，避免硬编码

常见错误

401 未授权

API 密钥无效或已过期。

解决方法： 检查 API 密钥是否正确，或重新生成新的 API 密钥。

403 禁止访问

权限不足或账户被限制。

解决方法： 检查账户状态，联系管理员获取相应权限。

身份认证 ​

获取 API 密钥 ​

代码示例 ​

安全注意事项 ​

常见错误 ​

401 未授权 ​