Skip to main content
Already running LLM calls? Point them at the AI Gateway to route across providers, add fallbacks, and centralize cost and latency tracking with a single base URL change.
1

​
Create an account

Sign up for a free orq.ai account. New accounts land directly in the AI Gateway application at /{workspace}/gateway.
2

​
Connect a provider

The AI Gateway routes requests through provider credentials configured in the workspace, keeping spend and data fully under control.
  1. In the AI Gateway sidebar, go to BYOK.
  2. Pick a provider (this quickstart uses OpenAI) and click Connect.
  3. Choose Setup your own API key and paste the provider key.
No OpenAI key yet? Create one at platform.openai.com/api-keys. For other providers, see the providers overview.

Supported providers

See the full list of supported model providers and how to connect them.
3

​
Get an API key

In the AI Gateway sidebar, go to API Keys. Click Create API Key, give it a name, and copy it.Then run the command below in a terminal, replacing your-api-key-here with the key copied above. The code samples in the next step read from this environment variable.
export ORQ_API_KEY="your-api-key-here"
4

​
Make a request

Send a request to the unified /v3/router/responses endpoint using the provider-prefixed model id (e.g. openai/gpt-5.4).
curl -X POST https://api.orq.ai/v3/router/responses \
  -H "Authorization: Bearer $ORQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "input": "Hello, world!"
  }'
A successful response looks like:
JSON
{
  "id": "resp_01K7M0YTJ6X90VHPRDMM5GEC4R",
  "object": "response",
  "model": "gpt-5.4",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! How can I assist you today?"
        }
      ]
    }
  ],
  "usage": { "input_tokens": 14, "output_tokens": 11, "total_tokens": 25 }
}
5

​
Review the request

In the AI Gateway sidebar, go to Traces to see the request, model, latency, token counts, and cost.

​
Troubleshooting

  1. Confirm echo $ORQ_API_KEY returns the value you expect.
  2. Verify the key under API Keys in the AI Gateway sidebar is active.
  3. Make sure the Authorization: Bearer header is set, not a query parameter.
{"code":401,"error":"API key for openai is not configured in your workspace."}
Go to Providers in the AI Gateway sidebar, open the matching provider, and click Setup your own API key.
Some models require an explicit toggle in the AI Gateway. Search for the model id under Models and enable it before invoking it.

​
Next steps

Auto Router

Let the gateway pick the optimal model per request based on quality, cost, and latency.

Fallbacks and retries

Define backup models so requests survive provider outages automatically.

Identity tracking

Attribute usage and cost to a specific end user or tenant.

Supported models

Browse 300+ models across OpenAI, Anthropic, Google, AWS, Azure, and more.