Tài liệu APIAPI documentation

Cổng LLM tương thích OpenAI, chạy trên Cloudflare Workers ở mức hoàn toàn miễn phí. Không cần đăng ký, không cần API key — gửi request là dùng được. Trỏ SDK OpenAI sẵn có vào đây là chạy. An OpenAI-compatible LLM gateway running on Cloudflare Workers at zero cost. No signup, no API key — just send a request. Point any existing OpenAI SDK at it and it works.

Free tier & API keyFree tier & API keys

Base URL: https://api.iamzero.app/v1. Gọi mà không gửi header Authorization thì bạn đang ở free tier. Gửi key đúng thì lên tier có key với giới hạn rộng hơn. Base URL: https://api.iamzero.app/v1. Call it without an Authorization header and you are on the free tier. Send a valid key to get the wider key tier.

Gửi key sai sẽ nhận 401 chứ không tự động tụt xuống free tier — để lỗi cấu hình lộ ra thay vì bị che. Cần key riêng (giới hạn rộng hơn) thì liên hệ chủ dịch vụ; key cấp bằng wrangler secret put LLM_API_KEYS, mỗi consumer một key để thu hồi riêng được. Sending a wrong key returns 401 rather than silently dropping to the free tier — a misconfiguration should surface, not hide. For your own key with wider limits, ask the service owner; keys are issued via wrangler secret put LLM_API_KEYS, one per consumer so they can be revoked individually.

Danh sách modelList models

GET /v1/models

Trả kèm quota còn lại hôm nay — hạn mức ở đây rất nhỏ và lệch nhau giữa các model, nên hãy đọc x_remaining để lùi bước thay vì đâm vào 429. Includes remaining quota for today — the ceilings here are small and uneven, so read x_remaining and back off instead of walking into a 429.

# free tier — không cần key
curl https://api.iamzero.app/v1/models

{
  "object": "list",
  "data": [
    {
      "id": "llama-3.3-70b",
      "object": "model",
      "owned_by": "meta via groq",
      "x_provider": "groq",
      "x_upstream_model": "llama-3.3-70b-versatile",
      "x_daily_ceiling": 1000,
      "x_calls_today": 5,
      "x_remaining": 995,
      "x_note": "Nhanh nhất; trần ~1.000 req/ngày."
    }
  ]
}

Nếu D1 không đọc được, x_calls_today trả chuỗi "unmeasured" — hệ thống này không bao giờ điền một con số "hợp lý" thay cho số đo thật. If D1 is unreachable, x_calls_today is the string "unmeasured" — this system never substitutes a plausible-looking number for a measured one.

Chat completions

POST /v1/chat/completions

Tham sốParameters

Các tham số khác của OpenAI (temperature, top_p, tools…) hiện bị bỏ qua, vì tầng provider miễn phí bên dưới không nhận chúng đồng nhất. Other OpenAI parameters (temperature, top_p, tools…) are currently ignored, because the free provider layer underneath does not accept them consistently.

curl

curl -X POST https://api.iamzero.app/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [
      {"role": "system", "content": "Trả lời ngắn gọn."},
      {"role": "user",   "content": "Thủ đô Việt Nam?"}
    ],
    "max_tokens": 128
  }'

Python openai SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.iamzero.app/v1",
    api_key="free",   # free tier bỏ qua giá trị này; SDK bắt buộc phải có gì đó
)
r = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Thủ đô Việt Nam?"}],
)
print(r.choices[0].message.content)

JavaScript fetch

const r = await fetch("https://api.iamzero.app/v1/chat/completions", {
  method: "POST",
  headers: { "content-type": "application/json" },   // free tier: không cần key
  body: JSON.stringify({
    model: "auto",
    messages: [{ role: "user", content: "Thủ đô Việt Nam?" }],
  }),
});
const data = await r.json();
console.log(data.choices[0].message.content);

Kết quảResponse

{
  "id": "chatcmpl-2f1c…",
  "object": "chat.completion",
  "created": 1786500000,
  "model": "llama-3.3-70b",
  "choices": [
    { "index": 0,
      "message": { "role": "assistant", "content": "Thủ đô của Việt Nam là Hà Nội." },
      "finish_reason": "stop" }
  ],
  "x_provider": "groq",
  "x_upstream_model": "llama-3.3-70b-versatile",
  "x_tier": "anon"
}

Model & hạn mứcModels & limits

Thời gian đo bằng curl từ Việt Nam ngày 2026-08-12, một lần mỗi model — là mốc tham khảo, không phải cam kết. Timings measured once per model with curl from Vietnam on 2026-08-12 — a reference point, not a guarantee.

Mã lỗiError codes

Lỗi trả theo shape OpenAI để SDK đọc được:Errors use the OpenAI shape so SDKs can read them: {"error":{"message","type","code"}}

Giới hạn cần biết trướcConstraints worth knowing up front

• Timeout 8 giây mỗi lane. Prompt dài hoặc model chậm sẽ trả 502 timeout. 8-second timeout per lane. Long prompts or slow models come back as a 502 timeout.
• 32 KB nội dung và 4096 token đầu ra khi có key; free tier là 8 KB và 512 token. 32 KB of content and 4096 output tokens with a key; the free tier gets 8 KB and 512 tokens.
• Role system được gấp vào tin nhắn user đầu tiên trước khi gửi đi, vì bốn nhà cung cấp miễn phí không có cách khai báo system giống nhau. Nội dung vẫn được tôn trọng, chỉ khác vị trí. The system role is folded into the first user message before dispatch, because the four free providers have no consistent system-prompt API. The content is still honoured, just repositioned.
• Không lưu hội thoại. API không giữ trạng thái; mỗi request phải gửi lại toàn bộ lịch sử cần thiết. No conversation storage. The API is stateless; resend whatever history you need on every request.
• Không gửi dữ liệu nhạy cảm. Các lane miễn phí có thể dùng nội dung để huấn luyện — đừng đưa PII của khách hàng qua đây. Do not send sensitive data. Free tiers may train on your content — keep customer PII out of it.
• Mọi lượt gọi đều bị đếm trước khi gửi, kể cả lượt sau đó thất bại. Con số hạn mức vì thế là cận trên, không phải số lần thành công. Every call is metered before dispatch, including ones that then fail. Quota figures are therefore an upper bound, not a success count.

Endpoint khácOther endpoints