Build on the Larz ecosystem

Quickstart

The Larz API is a clean, Larz-native HTTP API. Base URL:

https://api.larzos.com/v1Copy

Create a key below, then make your first call:

# Generate text
curl https://api.larzos.com/v1/generate \
  -H "Larz-Api-Key: larz_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Write a friendly welcome message for a new user"}'Copy

Response:

{
  "id": "larz_gen_82f103691a39…",
  "object": "generation",
  "model": "drlarz-chat",
  "output": "Welcome aboard! We're so glad you're here…",
  "usage": { "tokens": 219 },
  "created": 1783362964
}Copy

Authentication

Every request needs your secret key in the Larz-Api-Key header. (An Authorization: Bearer header is also accepted.) Keys are secret — never expose them in client-side code.

Larz-Api-Key: larz_sk_xxxxxxxxxxxxxxxxxxxxxxxxCopy

Your API keys

Create, name and revoke keys here. Each key starts on the Free tier. Your secret is shown once — store it safely.

Generate

Generate text from a prompt (simple) or a messages array (multi-turn).

Request

Examples

Copy

Tools

Run any of 40+ ready-made Larz Tools with a single input — no prompt engineering. Browse the catalog with GET /larz/v1/tools.

Copy

Models

Usage

Check a key's tier, monthly token usage and limits — handy for showing quota in your own app.

Errors

Errors return an HTTP status plus a Larz error envelope: {"error":{"type","message"}}.

Try it live

Paste one of your keys and run a real request from the browser.

Publish a tool

Turn a prompt into a hosted tool that appears in the Larz OS directory and the API — zero hosting. Or register an external endpoint you host yourself (Pro+). Submissions go through a quick review.

Pricing & limits

Every key has a hard monthly token cap, so costs can never run away. Need more? See plans or contact us.