Sandbox Mode

Integrate and test your application end-to-end without spending real credits or making real model calls.

How it works

  • Flag a key as is_sandbox when creating it from the Developer Console.
  • Requests made with a sandbox key never call the underlying model — you get a realistic, deterministic canned response shaped exactly like production.
  • Sandbox calls log to the usage dashboard with credits_used=0 — they never affect billing.
  • Sandbox keys are rate-limited the same way as live keys, so you can also load-test your integration's retry logic.

Example sandbox response

Sandbox responses match the real response schema field-for-field, with a marker so you can tell them apart in logs:

POST /v1/chat/completions (sandbox key)

{
  "id": "req_sandbox_8f1c...",
  "object": "chat.completion",
  "answer": "[sandbox] Under UAE Federal Decree-Law No. 33 of 2021, the standard notice period is ...",
  "citations": [],
  "jurisdiction": "AE",
  "warnings": [
    "sandbox_mode: no real model call was made"
  ],
  "sandbox": true
}