技术文档

统一 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 格式,支持以下参数:

参数类型必填说明
modelstring模型名称,如 wenxin-4、qwen-max、chatglm-4
messagesarray对话消息列表,包含 role 和 content
max_tokensinteger最大生成 token 数,默认 1024
temperaturefloat采样温度 0-2,默认 0.7
top_pfloat核采样参数,默认 0.8
streamboolean是否流式输出,默认 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
智谱 AIChatGLM兼容智谱 Open API
火山引擎豆包兼容火山引擎 API
腾讯混元自动转换腾讯消息格式

计费说明

平台支持多种计费方式,按模型不同而异:

参数类型必填说明
按次计费per_call每次调用固定费用
按 Token 计费per_token按总 token 数计费
输入/输出分别计费per_input_output_token输入输出 token 单价不同
包月订阅monthly每月固定费用,包含一定调用量
包年订阅yearly每年固定费用,包含一定调用量

错误码

状态码说明
200请求成功
400请求参数错误
401API Key 无效或未授权
402账户余额不足,请充值
429请求频率超限
500服务端内部错误