Quickstart

Make your first API call in minutes. Organization owners and admins can mint a key in Account settings → API keys. Need an organization? Contact us.

1. Authenticate

Pass your key as a Bearer token on every request. See Authentication for scopes, member attribution, and key hygiene.

Header
Authorization: Bearer oo_live_YOUR_KEY

# Optional: attribute spend to a team member
X-Member-User-Id: <uuid>

2. Your first chat call

Pick any text model from your catalog. Credits debit from your org pool; the response includes what was charged and tokens saved by our efficiency layer.

Request
curl -X POST "https://api.oneover.com/functions/v1/api-v1-chat" \
  -H "Authorization: Bearer oo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      { "role": "user", "content": "Hello from OneOver" }
    ],
    "stream": false
  }'
Response
{
  "request_id": "af5ac481-…",
  "model": "gpt-5.6-sol",
  "message": { "role": "assistant", "content": "…" },
  "credits_charged": 4,
  "balance": { "subscription": 14996, "anytime": 5000 },
  "efficiency": {
    "original_estimated_tokens": 4200,
    "compacted_estimated_tokens": 2800,
    "tokens_saved": 1400,
    "actions": ["dropped_2_old_turns"]
  }
}

3. Streaming

Set stream: true for Server-Sent Events. You receive connection_established, content chunks, then a done event with credits and efficiency.

Streaming request
curl -X POST "https://api.oneover.com/functions/v1/api-v1-chat" \
  -H "Authorization: Bearer oo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      { "role": "user", "content": "Hello from OneOver" }
    ],
    "stream": true
  }'

4. Generate an image

POST /api-v1-images
curl -X POST "https://api.oneover.com/functions/v1/api-v1-images" \
  -H "Authorization: Bearer oo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-pro",
    "prompt": "Minimal hero illustration",
    "aspect_ratio": "16:9"
  }'

5. Catalog and balance

GET /api-v1-models
curl "https://api.oneover.com/functions/v1/api-v1-models?type=text" \
  -H "Authorization: Bearer oo_live_YOUR_KEY"
GET /api-v1-usage?view=balance
curl "https://api.oneover.com/functions/v1/api-v1-usage?view=balance" \
  -H "Authorization: Bearer oo_live_YOUR_KEY"

Ready to experiment? Try the Playground for live calls with your key.