快速开始

五分钟内跑通第一次调用。

1. 拿一个令牌

1. 打开控制台
2. 左侧「令牌」→ 右上「添加令牌」
3. 起个名字（比如 test），额度可以留空表示不限，然后保存
4. 复制生成的密钥，形如：

sk-5GLQNX5f7UgeJE2i7wbT9ZLR8rgHr2uuO8tD8ry3mAfZfNjd

密钥只显示一次

创建时复制下来。丢了只能删掉重建，找不回来——服务端只存哈希，不存明文。

2. 服务地址

所有接口都在这个前缀下：

https://api.blueworkshop.top/v1

3. 发第一个请求

curl

curl https://api.blueworkshop.top/v1/chat/completions \
  -H "Authorization: Bearer $CYAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-0813",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.blueworkshop.top/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-pro-0813",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(resp.choices[0].message.content)
print(resp.usage)

Node.js

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.CYAN_API_KEY,
  baseURL: 'https://api.blueworkshop.top/v1',
})

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-pro-0813',
  messages: [{ role: 'user', content: '你好，介绍一下你自己' }],
})
console.log(resp.choices[0].message.content)

正常的话会返回一段 JSON，choices[0].message.content 就是回答，usage 里是这次消耗的 token 数。

4. 确认模型名

上面用的是 deepseek-v4-pro-0813。换模型前先查一下有哪些：

curl https://api.blueworkshop.top/v1/models \
  -H "Authorization: Bearer $CYAN_API_KEY"

返回一个模型数组，id 字段就是可以填进 model 的值。完整说明见模型列表。

常见第一次就卡住的地方

现象	原因
401 Invalid token	密钥没带、带错，或者令牌被禁用了
404 model not found	模型名写错，或者当前分组没有这个模型
429	触发限流，见限流与重试
502 / 530	上游服务抖动，稍后重试；连续出现找我们
请求一直不返回	没加 stream: false 时默认非流式，长回答会等较久；改用流式输出

下一步

• 用现成软件接入 → 客户端接入
• 要完整的参数说明 → 对话补全
• 要做逐字输出的界面 → 流式输出