Model API

Point your OpenAI client at Buda. POST /api/v1/responses speaks the OpenAI Responses API wire format — the same one OpenAI Codex CLI and other newer OpenAI-ecosystem tools use by default. Set your tool's base URL to Buda and your API key to a Buda sk_ key, and it works without writing any Buda-specific integration code.

Base URL

https://buda.im/api/v1

Configure your client's base URL to the value above and its API key to a Buda sk_ key — see Authentication to create one.

Supported models

Buda gives you one endpoint in front of many model families — pick whichever fits the task, or let Buda pick for you.

* Gated to specific subscription plans; an ungated request for one of these falls back to a default model.

Example: a single reply

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": "Say hello in exactly three words."
  }'

{
  "id": "resp_...",
  "object": "response",
  "status": "completed",
  "model": "claude-sonnet-5",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Hello there, friend!" }]
    }
  ],
  "usage": { "input_tokens": 12, "output_tokens": 5, "total_tokens": 17 }
}

Example: streaming

Set "stream": true to get the reply as it's generated, as standard OpenAI Responses API server-sent events (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": "Say hello in exactly three words.",
    "stream": true
  }'

Example: system instructions and multi-turn context

instructions sets the system prompt for the call; input also accepts a full message array instead of a single string when you need to pass prior turns yourself:

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": "Reply in Simplified Chinese.",
    "input": [
      { "role": "user", "content": "What is Buda?" },
      { "role": "assistant", "content": "Buda is an AI agent platform." },
      { "role": "user", "content": "Summarize that in one sentence." }
    ]
  }'

Using it with OpenAI Codex CLI

Codex CLI now requires wire_api = "responses" for custom providers, which is exactly what this endpoint speaks. Add a provider to ~/.codex/config.toml:

[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\"

What's not supported yet

This first version covers plain text in, text out. Not yet available: function/tool calling, image or file inputs, and the GET /v1/models listing endpoint. If your use case needs one of these, use the model IDs from the table above directly and check back — this surface is actively growing.

Billing

Every call is billed in AI credits against your own account, the same pool used by API Claws — not a shared quota. See What are credits for how the credit pools work, and top up if a call returns 429 insufficient_quota.

Related