# x-api-key header (Anthropic style)
curl https://root-ai.org/v1/messages \
  -H "x-api-key: rootai_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "model": "root-ai-flash", "max_tokens": 64, "messages": [{ "role": "user", "content": "Hi" }] }'

# Authorization header (fallback)
curl https://root-ai.org/v1/models \
  -H "Authorization: Bearer rootai_YOUR_API_KEY"

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Hourly request limit reached for your plan."
  }
}

export ANTHROPIC_BASE_URL=https://root-ai.org
export ANTHROPIC_AUTH_TOKEN=rootai_YOUR_API_KEY
claude --model root-ai-flash

// TypeScript
const client = new Anthropic({
  baseURL: "https://root-ai.org",   // SDK appends /v1/messages
  apiKey: "rootai_YOUR_API_KEY",
});

# Python
client = anthropic.Anthropic(
    base_url="https://root-ai.org",
    api_key="rootai_YOUR_API_KEY",
)

"model": "root-ai-pro-ultra"      // Ultra Reasoning
"model": "root-ai-flash-instant"  // Instant (no reasoning)
"model": "root-ai-flash"          // Standard (1M ctx)

curl https://root-ai.org/v1/messages \
  -H "x-api-key: rootai_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "root-ai-flash",
    "reasoning_effort": "high",
    "max_tokens": 512,
    "messages": [{ "role": "user", "content": "Plan a project" }]
  }'

// accepted: instant, standard, medium, high, xhigh
// aliases:   reasoning -> high, ultra / max -> xhigh

{
  "model": "root-ai-pro",
  "thinking": { "type": "enabled", "budget_tokens": 4096 },
  "max_tokens": 2048,
  "messages": [{ "role": "user", "content": "Hard problem" }]
}

// budget_tokens mapping:
//   < 2048  -> medium
//   < 8192  -> high
//   >= 8192 -> ultra (max)

// Turn 2: pass the previous assistant reply back in messages
{
  "model": "root-ai-flash",
  "max_tokens": 512,
  "messages": [
    { "role": "user", "content": "What is 2 + 2?" },
    { "role": "assistant", "content": [ { "type": "text", "text": "2 + 2 is 4." } ] },
    { "role": "user", "content": "Now multiply it by 3." }
  ]
}

{
  "model": "root-ai-flash",
  "max_tokens": 512,
  "messages": [{
    "role": "user",
    "content": "Return a JSON object with keys: name, age, city. Values: Juan, 24, Cebu. Respond with JSON only."
  }]
}

// reply
{
  "name": "Juan",
  "age": 24,
  "city": "Cebu"
}

{
  "model": "root-ai-flash",
  "max_tokens": 800,
  "tools": [ { "type": "web_search" } ],
  "messages": [ { "role": "user", "content": "Latest AI news this week?" } ]
}

{
  "model": "root-ai-flash",
  "max_tokens": 800,
  "tools": [{
    "type": "custom",
    "name": "image_generate",
    "description": "Generate an image from a text prompt.",
    "input_schema": {
      "type": "object",
      "properties": {
        "prompt": { "type": "string" },
        "width": { "type": "integer", "enum": [1024, 1536] },
        "height": { "type": "integer", "enum": [1024, 1536, 864] },
        "output_format": { "type": "string", "enum": ["png", "jpg"] }
      },
      "required": ["prompt"]
    }
  }],
  "messages": [ { "role": "user", "content": "Generate a logo of a pineapple surfing." } ]
}

{
  "type": "message",
  "role": "assistant",
  "model": "root-ai-flash",
  "content": [
    {
      "type": "tool_use",
      "id": "call_abc123",
      "name": "weather_lookup",
      "input": { "city": "Cebu" }
    }
  ],
  "stop_reason": "tool_use",
  ...
}

{
  "model": "root-ai-vision",
  "max_tokens": 512,
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "What is in this image?" },
      {
        "type": "image",
        "source": {
          "type": "base64",
          "media_type": "image/png",
          "data": "iVBORw0KGgoAAAANS..."
        }
      }
    ]
  }]
}

// or by URL:
// { "type": "image", "source": { "type": "url", "url": "https://example.com/pic.png" } }

Here's your image:

![Futuristic city at sunset](https://tempfile.aiquickdraw.com/workers/images/image_abc123.png)

// response also contains the tool_use block:
{
  "type": "tool_use",
  "id": "call_xyz",
  "name": "image_generate",
  "input": { "prompt": "...", "width": 1536, "height": 1024, "output_format": "png" }
}

// usage shows cached tokens per response
"usage": {
  "input_tokens": 14210,
  "output_tokens": 512,
  "input_tokens_details": { "cached_tokens": 13880 }   // hit the cache
}

// Tips for best cache hits:
// 1. Keep system instructions stable between turns.
// 2. Re-send conversation history in the same order.
// 3. Only append new messages at the end.

curl -N https://root-ai.org/v1/messages \
  -H "x-api-key: rootai_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "root-ai-flash",
    "max_tokens": 512,
    "stream": true,
    "messages": [{ "role": "user", "content": "Tell me a story" }]
  }'