一个API Key，调用所有模型

平台概述

云枢互联AI模型开放平台提供统一的API接口，支持通过一个API Key调用多个AI模型。目前支持：

• Laya System One - 基于强化学习的文本理解与决策大模型。
• DeepSeek 1.5B R1 - 轻量级推理模型。

统一调用入口：https://api.yunshuhulian.cn/v1/chat/completions

所有请求（包括网页终端和API调用）统一使用 POST 方法发送到上述地址。网关后端自动完成：

1. 校验用户API Key是否合法
2. 根据请求体中的 model 字段判断调用哪个模型
3. 使用系统级API Key转发到对应模型的真实后端
4. 记录调用次数，返回结果

用户无需关心真实模型的地址和密钥，只需一个API Key即可调用所有模型。

认证方式

所有API请求需要在请求头中携带API Key：

Authorization: Bearer <your-api-key>

API Key在平台首页申领，每个用户唯一。请妥善保管，不要泄露。

统一接口

POST /v1/chat/completions

兼容OpenAI格式的统一调用接口，通过 model 字段路由到对应模型后端。

请求参数

字段	类型	必填	说明
model	string	是	模型名称：laya / deepseek
messages	array	是*	对话消息（DeepSeek模式必填）
state	object	是*	Laya模式：待分析文本 {message: "..."}
questions	object	是*	Laya模式：问题配置
max_tokens	int	否	最大生成token数，默认1024
temperature	float	否	随机性，0-2，默认0.7

Laya模型

Laya模型使用专有请求格式，通过 state.message 传入待分析文本，通过 questions 定义分析维度。

三种问题类型

类型	说明	返回
choice	分类选择，criteria为键值对	选中的分类ID + 概率分布
noul	是非判断，无criteria	0-1连续值（0=否，1=是）
score	分级评分，criteria为等级数组	分值 + 对应等级

请求示例

{
  "model": "laya",
  "state": { "message": "这个产品真的太棒了！" },
  "questions": {
    "sentiment": {
      "type": "choice",
      "instructions": "判断情感",
      "criteria": {"pos": "正面", "neg": "负面"}
    }
  }
}

DeepSeek模型

DeepSeek模型使用标准OpenAI对话格式，通过 messages 数组传入对话历史。

请求示例

{
  "model": "deepseek",
  "messages": [
    {"role": "system", "content": "你是一个AI助手"},
    {"role": "user", "content": "你好"}
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}

代码示例

cURL

curl https://api.yunshuhulian.cn/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python

import requests

url = "https://api.yunshuhulian.cn/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "deepseek",
    "messages": [{"role": "user", "content": "你好"}]
}
resp = requests.post(url, headers=headers, json=data)
print(resp.json())

错误码

状态码	说明
200	请求成功
401	API Key无效或缺失
400	请求参数错误或不支持的模型
504	模型服务超时
500	服务器内部错误