VNAI API 开发文档

旧接口 (VNAGI) 与新接口 (OpenAI 兼容) 对比及迁移指南

维度	旧接口api.php	新接口api3.php
认证方式	请求体字段 key	Header Authorization: Bearer <token>
用户输入	单行文本 prompt	对话数组 messages
可调参数	固定	temperature, max_tokens
生态	仅自行搭建站点可用	覆盖多应用，多网站
响应格式	自定义 JSON	OpenAI 标准格式
多轮对话	不支持	支持（通过 messages 携带历史）
错误信息	统一返回 {"error":"服务器响应超时"}	结构化错误对象（含状态码）

旧接口示例

请求

POST /api.php
Content-Type: application/json

{
  "key": "sk-vnxxxxxxxxxxxxx",
  "model": "c3",
  "prompt": "你好，介绍一下你自己"
}

成功响应

{
  "content": "我是VNAI...",
  "model": "c3",
  "request_time": "2026-05-04T12:00:00+08:00",
  "response_content": "你好，介绍一下你自己"
}

错误时返回 HTTP 500 及 {"error":"服务器响应超时"}

新接口示例

请求

POST /api.php
Authorization: Bearer sk-vnnb
Content-Type: application/json

{
  "model": "c3",
  "messages": [
    { "role": "user", "content": "你好" },
    { "role": "assistant", "content": "你好！有什么能帮你？" },
    { "role": "user", "content": "介绍一下你自己" }
  ],
  "temperature": 0.8,
  "max_tokens": 1000
}

成功响应

{
  "id": "chatcmpl-abc123...",
  "object": "chat.completion",
  "created": 1746345600,
  "model": "c3",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "我是VNAI，由ECA Studio训练..."
    },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0 }
}

错误响应（示例：无效API Key）

HTTP 401
{
  "error": {
    "message": "Incorrect API key provided",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

401 API Key 错误

400 请求参数/模型无效

502 AI服务不可用

迁移步骤

将 key 字段改为请求头 Authorization: Bearer <你的key>
将单条 prompt 替换为 messages 数组，至少包含一个 {"role":"user","content":"..."}
解析响应时，用 choices[0].message.content 代替 content
根据 HTTP 状态码和 error.type 进行差异化的错误处理

提示：新接口兼容 OpenAI SDK，修改 base_url 和 api_key 后即可直接使用官方客户端调用。
接口地址https://520le.cn/api/api3.php
详细QQ群:692733860 咨询

VNAI开发团队 × ECA工作室 · 文档版本 v1.0

最后更新 2026-05-04

此页面由VN-A1-MAX辅助生成