API reference

Authorization: Bearer ory_live_...    (or ory_test_... for test mode)

curl https://api.oryvox.ai/v1/chat/completions \
  -H "Authorization: Bearer $ORYVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "oryvox-balanced",
    "messages": [
      {"role": "system", "content": "You are concise."},
      {"role": "user", "content": "What is a CDN?"}
    ],
    "max_tokens": 200,
    "routing": {"mode": "balanced"},
    "max_cost": 0.01
  }'

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1790000000,
  "model": "openai/gpt-5-mini",
  "choices": [
    {"index": 0, "message": {"role": "assistant", "content": "A CDN is..."}, "finish_reason": "stop"}
  ],
  "usage": {"prompt_tokens": 24, "completion_tokens": 41, "total_tokens": 65},
  "oryvox": {"request_id": "req_8f2k...", "selected_model": "openai/gpt-5-mini", "provider": "openai",
             "cost": 0.000092, "saved": 0.00071, "cache": null, "fallbacks": 0}
}

curl https://api.oryvox.ai/v1/responses \
  -H "Authorization: Bearer $ORYVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6c1d9f0e-order-42" \
  -d '{
    "model": "oryvox-auto",
    "instructions": "Answer in one sentence.",
    "input": "Why is the sky blue?",
    "max_output_tokens": 120,
    "metadata": {"task": "faq", "priority": "realtime"}
  }'

{
  "id": "resp_...",
  "object": "response",
  "created_at": 1790000000,
  "model": "google/gemini-3-flash",
  "status": "completed",
  "output_text": "Air molecules scatter short blue wavelengths more than red ones.",
  "output": [
    {"type": "message", "id": "msg_...", "status": "completed", "role": "assistant",
     "content": [{"type": "output_text", "text": "Air molecules scatter...", "annotations": []}]}
  ],
  "usage": {"input_tokens": 21, "output_tokens": 14, "total_tokens": 35, "input_tokens_details": {"cached_tokens": 0}},
  "oryvox": {"request_id": "req_...", "selected_model": "google/gemini-3-flash", "provider": "google", "cost": 0.00002, "saved": 0.0004, "cache": null, "fallbacks": 0}
}

event: response.created
data: {"type":"response.created","response":{"id":"resp_...","object":"response","created_at":1790000000,"model":"oryvox-auto","status":"in_progress"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Air molecules","item_id":"resp_..."}

event: response.completed
data: {"type":"response.completed","response":{ ...full response, including "oryvox"... }}

curl https://api.oryvox.ai/v1/embeddings \
  -H "Authorization: Bearer $ORYVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/text-embedding-3-small", "input": ["first text", "second text"]}'

{
  "object": "list",
  "data": [{"object": "embedding", "index": 0, "embedding": [0.0123, -0.0456]}],
  "model": "openai/text-embedding-3-small",
  "usage": {"prompt_tokens": 4, "total_tokens": 4}
}

{
  "object": "list",
  "data": [
    {"id": "oryvox-auto", "object": "model", "owned_by": "oryvox", "created": 0, "oryvox": {"virtual": true}},
    {
      "id": "anthropic/claude-sonnet-5.5", "object": "model", "owned_by": "anthropic", "created": 1780000000,
      "oryvox": {
        "name": "Claude Sonnet 5.5", "input_price": 3.0, "output_price": 15.0, "context_window": 200000,
        "tools": true, "vision": true, "json": true, "reasoning": true, "embeddings": false,
        "quality": 92, "routable": true
      }
    }
  ],
  "has_more": false
}

curl https://api.oryvox.ai/v1/cache/invalidate \
  -H "Authorization: Bearer $ORYVOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"tags": ["document:456"]}'

for await (const r of client.requests.list({ limit: 50 })) console.log(r.request_id);

for r in client.requests.list(limit=50):
    print(r.request_id)