技术文档
统一 API 接口,兼容 OpenAI 格式,一次接入多家厂商
API 概述
AI大模型集合开放平台提供统一的 RESTful API 接口,聚合百度、阿里、智谱等多家主流大模型厂商能力。开发者只需调用一个 API 即可访问多种 AI 模型,平台负责请求转发、计量计费和响应返回。所有接口兼容 OpenAI 格式。
认证方式
所有 API 请求需在 Header 中携带 API Key 进行认证。注册企业账户后,系统自动生成专属 API Key。
// 请求头示例
headers: {
"X-API-Key": "your-api-key",
"Content-Type": "application/json"
}API 端点
统一 API 端点地址,所有模型调用均使用此地址:
POST https://api.zhiaitech.com/v1/chat/completions快速开始
以下示例展示如何调用文本生成模型:
// 使用 fetch 调用
const response = await fetch('https://api.zhiaitech.com/v1/chat/completions', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your-api-key'
},
body: JSON.stringify({
model: 'wenxin-4',
messages: [
{ role: 'system', content: '你是专业的技术顾问' },
{ role: 'user', content: '帮我分析这段代码' }
],
max_tokens: 2048,
temperature: 0.7
})
});
const data = await response.json();
console.log(data.choices[0].message.content);请求参数
请求体为 JSON 格式,支持以下参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,如 wenxin-4、qwen-max、chatglm-4 |
| messages | array | 是 | 对话消息列表,包含 role 和 content |
| max_tokens | integer | 否 | 最大生成 token 数,默认 1024 |
| temperature | float | 否 | 采样温度 0-2,默认 0.7 |
| top_p | float | 否 | 核采样参数,默认 0.8 |
| stream | boolean | 否 | 是否流式输出,默认 false |
响应格式
所有厂商响应统一转换为 OpenAI 兼容格式:
{
"id": "chatcmpl-xxx",
"model": "wenxin-4",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!有什么可以帮你的?"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 5,
"completion_tokens": 12,
"total_tokens": 17
}
}支持厂商
平台已接入以下厂商,自动处理各厂商 API 格式差异:
| 厂商 | 模型 | 说明 |
|---|---|---|
| 百度智能云 | 文心一言 | 自动转换文心消息格式 |
| 阿里云 | 通义千问 | 兼容 DashScope API |
| 智谱 AI | ChatGLM | 兼容智谱 Open API |
| 火山引擎 | 豆包 | 兼容火山引擎 API |
| 腾讯 | 混元 | 自动转换腾讯消息格式 |
计费说明
平台支持多种计费方式,按模型不同而异:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 按次计费 | per_call | 每次调用固定费用 | |
| 按 Token 计费 | per_token | 按总 token 数计费 | |
| 输入/输出分别计费 | per_input_output_token | 输入输出 token 单价不同 | |
| 包月订阅 | monthly | 每月固定费用,包含一定调用量 | |
| 包年订阅 | yearly | 每年固定费用,包含一定调用量 |
错误码
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数错误 |
| 401 | API Key 无效或未授权 |
| 402 | 账户余额不足,请充值 |
| 429 | 请求频率超限 |
| 500 | 服务端内部错误 |