模型 API
把任何 OpenAI Responses API 客户端——包括 OpenAI Codex CLI——指向 Buda,用你现有的 sk_ API 密钥调用 Buda 支持的任意模型。
把你的 OpenAI 客户端指向 Buda。 POST /api/v1/responses 讲的是 OpenAI Responses API 协议——OpenAI Codex CLI 以及其他较新的 OpenAI 生态工具默认就用这套协议。把工具的 base URL 设成 Buda,API 密钥换成 Buda 的 sk_ 密钥即可直接用,不用写任何 Buda 专属的对接代码。
这是原始模型 API——一次调用进,一次模型回复出,按调用计费。如果你想要的是带自有 Drive 知识库、会话历史、多步骤运行时的托管智能体,请看 API Claw（爪）。
Base URL
https://buda.im/api/v1把客户端的 base URL 配成上面这个地址,API 密钥换成 Buda 的 sk_ 密钥——去身份认证创建一个。
支持的模型
Buda 用一个接口接入多个模型系列——按任务挑一个合适的,或者交给 Buda 自动选。
| 模型 | 系列 |
|---|---|
claude-haiku-4-5 | Claude |
claude-sonnet-5 | Claude |
claude-opus-5* | Claude |
claude-fable-5* | Claude |
gemini-3.1-pro | Gemini |
gemini-3.1-flash | Gemini |
gemini-3.7-flash | Gemini |
gpt-5.6-sol* | GPT |
gpt-5.6-terra | GPT |
gpt-5.6-luna | GPT |
deepseek-v4-flash* | DeepSeek |
deepseek-v4-pro* | DeepSeek |
auto | 由 Buda 帮你选一个当前默认模型 |
* 仅限特定订阅套餐;没有对应套餐时请求这些模型会回退到默认模型。
model 字段要填上面这些 Buda 自己的模型 ID,不是 OpenAI 自己的模型名(gpt-4o 等)——Buda 不是把请求代理给 OpenAI 的模型目录,而是路由到它自己的模型目录。
示例:一次简单回复
curl -X POST https://buda.im/api/v1/responses \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"input": "用恰好三个字打个招呼。"
}'{
"id": "resp_...",
"object": "response",
"status": "completed",
"model": "claude-sonnet-5",
"output": [
{
"type": "message",
"role": "assistant",
"content": [{ "type": "output_text", "text": "你好朋友!" }]
}
],
"usage": { "input_tokens": 12, "output_tokens": 5, "total_tokens": 17 }
}示例:流式输出
设 "stream": true 就能边生成边拿到回复,标准 OpenAI Responses API 的 SSE 事件(response.created、response.output_text.delta、response.completed 等):
curl -N -X POST https://buda.im/api/v1/responses \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"input": "用恰好三个字打个招呼。",
"stream": true
}'示例:系统指令与多轮上下文
instructions 用来设这次调用的系统提示词;input 除了单个字符串,也能传完整的消息数组,自己把之前几轮对话带过来:
curl -X POST https://buda.im/api/v1/responses \
-H "Authorization: Bearer sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"instructions": "用简体中文回复。",
"input": [
{ "role": "user", "content": "Buda 是什么?" },
{ "role": "assistant", "content": "Buda 是一个 AI 智能体平台。" },
{ "role": "user", "content": "用一句话概括一下。" }
]
}'每次调用都是无状态的——Buda 不会在调用之间保留服务端会话状态(没有 previous_response_id)。需要多轮历史的话,像上面这样自己把历史传回去。
配合 OpenAI Codex CLI 使用
Codex CLI 现在要求自定义 provider 用 wire_api = "responses",正好就是这个接口讲的协议。往 ~/.codex/config.toml 加一个 provider:
[model_providers.buda]
name = "buda"
base_url = "https://buda.im/api/v1"
wire_api = "responses"
env_key = "BUDA_API_KEY"BUDA_API_KEY=sk_your_api_key codex --model claude-sonnet-5 -c model_provider=\"buda\"暂不支持
这一版只覆盖纯文本输入输出。暂不支持:函数/工具调用、图片或文件输入、GET /v1/models 模型列表接口。如果你的场景需要这些能力,先直接用上面表里的模型 ID,并留意后续更新——这块能力还在持续扩展。
计费
每次调用都从你自己账户的 AI 积分里扣,跟 API Claw（爪）用的是同一个池子——不是共享配额。积分池的运作方式看什么是额度;调用返回 429 insufficient_quota 就说明该充值了。