BuyEasy OpenAPI 文档

AI 模型

兼容 OpenAI 协议的大模型对话能力

BuyEasy AI 网关同时兼容 Chat Completions 与 Codex 使用的 Responses API，支持不中断的 SSE 流式返回。

统一鉴权

x-api-key + Authorization Bearer

可计费

成功调用写入账单和调用日志

订单隔离

采购支付只走客户授权账号

JSON 返回

统一 success / code / data 结构

请求入口

Base URL: https://open.buyeasysaas.com

Header: x-api-key / Authorization

接入说明

使用与商品、订单 API 相同的 App Key / Secret 鉴权。
普通 OpenAI SDK 使用 /api/ai/chat/completions；Codex 的 Base URL 使用 https://open.buyeasysaas.com/v1。
Codex 自定义模型供应商必须设置 wire_api = "responses"，环境变量中的 API Key 填 App Secret。
对话与生成类请求建议携带 Idempotency-Key，避免重试导致重复计费。

AI 模型接口持续迭代，可用模型、参数与限流以线上返回为准。

POST/api/ai/chat/completions

对话补全

兼容 OpenAI Chat Completions 协议，支持多轮 messages 与流式（stream）返回。

必须客户授权

订单预览、下单和支付必须使用客户自己的平台账号授权

参数	类型	必填	说明	示例
model	string	是	模型标识，可在控制台查看可用模型	gpt-4o-mini
messages	array	是	对话消息数组，每项含 role 与 content	[{"role":"user","content":"你好"}]
stream	boolean	否	是否流式返回，默认 false	false
temperature	number	否	采样温度，0~2	0.7

modelstring是

模型标识，可在控制台查看可用模型

gpt-4o-mini

messagesarray是

对话消息数组，每项含 role 与 content

[{"role":"user","content":"你好"}]

streamboolean否

是否流式返回，默认 false

false

temperaturenumber否

采样温度，0~2

0.7

请求示例

curl -X POST "https://open.buyeasysaas.com/api/ai/chat/completions" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_APP_KEY" \
-H "Authorization: Bearer YOUR_APP_SECRET" \
-d '{
  "model": "gpt-4o-mini",
  "messages": [{"role": "user", "content": "用一句话介绍跨境采购"}],
  "stream": false
}'

返回示例

{
  "success": true,
  "code": 0,
  "message": "success",
  "data": {
  "id": "chatcmpl-001",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "跨境采购是向海外供应商批量采购商品并进口销售。" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 20, "total_tokens": 32 }
},
  "billing": {
    "charged": 0.027,
    "unitPrice": 0.027,
    "multiplier": 1,
    "product": "接口产品名称",
    "callId": 1024
  }
}

- 鉴权方式与其它接口一致（x-api-key / Authorization: Bearer）。

- OpenAI SDK 的 base_url 设为 https://open.buyeasysaas.com/api/ai，api_key 填 App Secret。

- 按 token 计费，成功返回 usage 后计入 billing；可用模型列表见控制台。

POST/v1/responses

Codex / Responses API

兼容 Codex 所需的 OpenAI Responses API，支持 SSE 流式事件与 /v1/responses/* 子路径。

必须客户授权

订单预览、下单和支付必须使用客户自己的平台账号授权

参数	类型	必填	说明	示例
model	string	是	客户后台已上架的模型 ID	gpt-5-codex
input	string\|array	是	Responses API 输入内容	检查当前项目并修复类型错误
stream	boolean	否	Codex 使用流式模式	true

modelstring是

客户后台已上架的模型 ID

gpt-5-codex

inputstring|array是

Responses API 输入内容

检查当前项目并修复类型错误

streamboolean否

Codex 使用流式模式

true

请求示例

curl -N -X POST "https://open.buyeasysaas.com/v1/responses" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_APP_KEY" \
-H "Authorization: Bearer YOUR_APP_SECRET" \
-d '{
  "model": "gpt-5-codex",
  "input": "检查当前项目并修复类型错误",
  "stream": true
}'

返回示例

event: response.created
data: {"type":"response.created",...}

event: response.completed
data: {"type":"response.completed","response":{"status":"completed",...}}

- Codex 的 base_url 必须是 https://open.buyeasysaas.com/v1，不能填写 /api/ai。

- config.toml 设置：model_provider = "buyeasy"；[model_providers.buyeasy] 中设置 base_url、env_key = "BUYEASY_API_KEY"、wire_api = "responses"。

- BUYEASY_API_KEY 的值填写消费者后台生成的 App Secret；App Key 不是 Codex Bearer Token。

- GET /v1/models 可使用同一个 App Secret 查询当前可调用模型。