Developer Quickstart
Blazo exposes an OpenAI-compatible endpoint at https://blazo.io/api/v1. Create an API key in Dashboard → API Keys and pass it as your Bearer token.
Node.js / TypeScript (OpenAI SDK)
import OpenAI from "openai";
const openai = new OpenAI({
apiKey: process.env.BLAZO_API_KEY, // blz_live_...
baseURL: "https://blazo.io/api/v1",
});
const stream = await openai.chat.completions.create({
model: "deepseek/deepseek-v4.1-flash-fast",
stream: true,
messages: [{ role: "user", content: "Write a SQLite UPSERT example." }],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="blz_live_your_key_here",
base_url="https://blazo.io/api/v1",
)
completion = client.chat.completions.create(
model="glm/glm-5.3",
messages=[{"role": "user", "content": "Hello from Python!"}],
)
print(completion.choices[0].message.content)cURL
curl https://blazo.io/api/v1/chat/completions \
-H "Authorization: Bearer blz_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/minimax-m3.1-flash",
"messages": [{"role": "user", "content": "Explain idempotency keys briefly."}]
}'Credit Metering & Pricing Formula
Credits are stored strictly as integers (`150 credits = $1.00 USD`). After each request finishes, Blazo computes wholesale cost from the returned prompt/completion token usage and applies the configured compute multiplier:
credits_charged = Math.max(1, Math.ceil(wholesale_usd * markup_multiplier * 150))HTTP Error Codes
| Status | Meaning | Resolution |
|---|---|---|
| 401 | Invalid or revoked API key | Check your blz_live_... token in Dashboard → API Keys. |
| 402 | Insufficient credit balance | Top up prepaid credits in Dashboard → Billing. |
| 429 | Upstream rate limit exceeded | Retry with exponential backoff or route to another model. |
| 503 | Upstream inference gateway unavailable | Verify `UPSTREAM_API_KEY` environment configuration. |
Connected Apps / Blazo Partner API (OAuth2)
Authorized external applications can connect a user's Blazo account once via /oauth/authorize and exchange the single-use code at /api/partner/oauth/token to read balances, issue idempotent debits/refunds, and receive signed HMAC-SHA256 webhooks. See PARTNER_CONTRACT.md in the repository for the complete TypeScript SDK helper.