aiengin
登录注册

API Reference · 接口说明

OpenAI 兼容网关,现有 SDK 零改造接入

Base URL

所有请求统一走网关接入地址:https://aiengin.jyqg.org.cn/v1

https://aiengin.jyqg.org.cn/v1

将 OpenAI SDK 的 base_url / baseURL 指向上述地址,api_key 填入你的 sk- 密钥,即可直接调用,无需修改业务代码。

鉴权

使用标准的 Authorization: Bearer <sk-xxx> 请求头,亦支持 x-api-key 头。

主要端点

MethodPath说明
GET/v1/models列出当前可用模型
POST/v1/chat/completions对话补全(OpenAI 兼容)
POST/v1/completions文本补全
POST/v1/embeddings文本向量化
POST/v1/images/generations图像生成
POST/v1/audio/transcriptions语音转写
POST/v1/moderations内容审核

请求体与响应结构同 OpenAI 官方定义,现有客户端代码可直接复用。

模型与价格

可用模型、厂商与价格实时同步自 模型广场;用量与花费在控制台 → 用量日志 查看。

错误码

HTTP含义处理建议
401密钥缺失 / 无效检查 Authorization 头与密钥状态
402额度不足到控制台充值后重试
403无权访问该模型 / 分组检查密钥绑定的模型分组
404模型不存在通过 /v1/models 或模型广场核对模型名
429触发限流降低请求频率或增大退避间隔
5xx上游渠道异常网关会自动切换渠道,可稍后重试

稳定性建议

  • 对 429 / 5xx 采用指数退避重试(如 1s → 2s → 4s)
  • 长对话开启流式输出(stream: true)降低首包等待
  • 生产环境在服务端持有密钥,避免在前端暴露 sk-