API 文档 | 云大师

快速接入

云大师 API 兼容 OpenAI API 格式，只需修改 Base URL 和 API Key 即可完成迁移。

Base URL

https://token.yundashi.com/v1

三步开始

2. 在控制台创建 API Key

3. 使用以下代码发起请求

# cURL 示例
curl https://token.yundashi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
  }'

认证方式

所有 API 请求需在 Header 中携带 API Key 进行认证：

Authorization: Bearer sk-your-api-key

API Key 可在控制台 - API Keys 页面创建和管理。

对话补全

POST /v1/chat/completions 创建对话补全

请求参数

参数	类型	必填	说明
model	string	是*	模型 ID，如 deepseek-v4-pro
messages	array	是*	消息数组，包含 role 和 content
max_tokens	integer	否	最大生成 token 数
temperature	float	否	采样温度，0-2，默认 1
stream	boolean	否	是否流式返回，默认 false

请求示例

import openai

client = openai.OpenAI(
    base_url="https://token.yundashi.com/v1",
    api_key="sk-your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

print(response.choices[0].message.content)

模型列表

云大师算力商店支持以下模型，所有模型通过统一接口调用：

模型 ID	上下文长度	提供商	说明
deepseek-v4-pro	1M	DeepSeek	深度推理，适合复杂任务
doubao-seed2.0-pro	128K	字节跳动	通用对话，高性价比
qwen3.7-max	1M	阿里通义	多语言，长文本理解
glm-5.1	128K	智谱 AI	中英双语，代码生成
kimi-k2.6	256K	月之暗面	超长文本，文档分析
minimax-m3	1M	MiniMax	多模态，创意写作

用量查询

GET /v1/usage 查询账户用量

查询当前账户的 token 用量和余额信息。

curl https://token.yundashi.com/v1/usage \
  -H "Authorization: Bearer sk-your-api-key"

错误码说明

状态码	说明
200	请求成功
400	请求参数错误
401	API Key 无效或已过期
429	请求频率超限，请稍后重试
500	服务器内部错误