开发者文档

API 文档

蜀算云提供 OpenAI 兼容的 API 接口，几行代码即可接入 20+ 国产大模型。 支持流式输出、函数调用等完整能力。

快速开始

1

注册账号

访问蜀算云注册页面，填写用户名与密码即可创建账号，注册即送免费体验额度。

2

获取 API Key

登录控制台后进入「令牌管理」页面，点击「创建令牌」生成 API Key（格式为 sk-xxx），请妥善保管。

3

调用接口

使用 Base URL 与 API Key，按照 OpenAI SDK 标准方式调用接口，即可获得模型响应。

Base URL
https://shusuan.cloud/api/proxy/v1

所有 API 请求均以此地址为前缀，兼容 OpenAI 接口格式，可直接复用 OpenAI 官方 SDK。

认证方式

蜀算云 API 采用 Bearer Token 认证。每个请求都需要在 HTTP Header 中携带 API Key：

Authorization: Bearer sk-your-api-key

以下示例展示如何通过 cURL 验证 API Key 是否有效：

curl https://shusuan.cloud/api/proxy/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

模型列表

蜀算云已接入以下国产大模型，价格按百万 Token 计费：

模型名称厂商上下文输入价格输出价格
DeepSeek V3
deepseek-v3
深度求索64K¥1.5/百万Token¥3/百万Token
DeepSeek R1
deepseek-r1
深度求索64K¥6/百万Token¥24/百万Token
Qwen Max
qwen-max
阿里云32K¥30/百万Token¥90/百万Token
Qwen Plus
qwen-plus
阿里云128K¥6/百万Token¥18/百万Token
Qwen Turbo
qwen-turbo
阿里云1M¥3/百万Token¥9/百万Token
Qwen Long
qwen-long
阿里云10M¥0.75/百万Token¥3/百万Token
GLM-4
glm-4
智谱AI128K¥5/百万Token¥5/百万Token
MiniMax abab6.5
minimax-abab6.5
MiniMax245K¥30/百万Token¥30/百万Token

对话接口 (Chat Completions)

接口路径：POST /v1/chat/completions，请求格式与 OpenAI 完全兼容。选择不同语言查看示例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://shusuan.cloud/api/proxy/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好，请介绍一下自己。"}
    ]
)

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

流式输出

在请求中设置 stream: true 即可启用流式输出，模型会逐字返回内容，适合实时对话场景：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://shusuan.cloud/api/proxy/v1"
)

stream = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "写一首关于成都的诗"}],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

函数调用 (Function Calling)

通过 tools 参数传入函数定义， 模型会自主判断是否需要调用函数并返回结构化参数：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://shusuan.cloud/api/proxy/v1"
)

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "获取指定城市的实时天气",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "城市名称"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="qwen-max",
    messages=[{"role": "user", "content": "成都今天天气怎么样？"}],
    tools=tools
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"调用函数: {tool_call.function.name}")
print(f"参数: {tool_call.function.arguments}")

错误码

HTTP 状态码

状态码名称说明
200OK请求成功
400Bad Request请求参数错误，请检查请求体格式
401UnauthorizedAPI Key 无效或缺失，请检查认证头
403Forbidden无权限访问该资源或模型
404Not Found请求的接口或资源不存在
429Too Many Requests请求频率超过限制，请稍后重试
500Internal Server Error服务器内部错误，请稍后重试
503Service Unavailable服务暂时不可用，可能正在维护

业务错误码

错误码含义处理建议
1000通用错误请检查请求参数是否正确
1001API Key 无效请前往控制台确认 Key 是否正确
1002余额不足账户额度已用尽，请前往控制台充值
1003模型不存在请检查 model 参数是否在模型列表中
1004请求超时模型响应超时，请稍后重试
1005上下文超限输入内容超出模型上下文长度限制