繁星AI API 使用文档

1. 令牌管理

令牌是调用 API 的唯一凭证，每个令牌可独立配置权限范围、调用配额、模型白名单等限制。

入口路径：左侧导航「令牌」菜单，或直接访问控制台地址：https://ai.idcyunwei.org/console/token

令牌列表展示全部已创建密钥，包含字段：令牌名称、启用状态、已消耗配额、剩余配额、过期时间。

2. 创建令牌

基础配置步骤

1. 令牌列表右上角点击 创建令牌 按钮，弹出配置弹窗
2. 填写令牌名称（建议按业务区分：生产环境、测试客户端、本地调试等）

高级配置选项说明

3. 编辑与删除令牌

编辑令牌

令牌列表对应条目右侧点击「编辑」，可修改全部配置项（无法修改/查看原始令牌Key）。

删除令牌

列表右侧点击「删除」，确认后令牌立即永久失效，无法恢复，调用会直接返回鉴权失败。

4. 操练场在线测试

内置在线调试工具，无需编写代码快速验证令牌可用性、模型返回效果。

访问地址：https://ai.idcyunwei.org/console/playground

使用步骤

1. 左侧下拉选择需要测试的模型
2. 底部输入框填写提问内容，点击发送
3. 右侧对话面板实时展示模型完整返回内容

5. 获取 API 地址

复制 Base URL

1. 访问平台首页 https://ai.idcyunwei.org
2. 页面中部找到 API Base URL 展示区域
3. 点击复制按钮，复制地址填入客户端/代码 base_url 参数

6. 代码调用示例

Python OpenAI SDK 标准调用

from openai import OpenAI

# ai.idcyunwei.org 平台配置
client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx",
    base_url="https://ai.idcyunwei.org/v1"
)

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

curl Claude 原生格式调用

curl https://ai.idcyunwei.org/v1/messages \
 -H "x-api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
 -H "anthropic-version: 2023-06-01" \
 -H "content-type: application/json" \
 -d '{
 "model": "claude-3-5-sonnet-20241022",
 "max_tokens": 1024,
 "messages": [{"role": "user", "content": "Hello"}]
 }'

curl Gemini 原生格式调用

curl "https://ai.idcyunwei.org/v1beta/models/gemini-1.5-pro:generateContent?key=sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
 -H "Content-Type: application/json" \
 -d '{
 "contents": [{"parts": [{"text": "Hello"}]}]
 }'

7. 支持接口端点