Gateway Overview

What Is the Gateway

Instead of managing separate API keys and SDKs for each model provider, the Creor Gateway provides a single /v1/chat/completions endpoint that is fully compatible with the OpenAI SDK. Point any OpenAI-compatible client at https://api.creor.ai/v1 and use your Creor API key to access all supported models.

Key Benefits

• Single API key for all providers -- no need to manage keys for Anthropic, OpenAI, Google, and others separately.
• OpenAI SDK compatible -- swap the base URL and API key; your existing code works without changes.
• Unified billing -- all usage across all models appears on a single invoice.
• Automatic model routing -- the gateway routes your request to the correct provider based on the model ID.
• Built-in rate limiting and retry logic on the server side for provider-level errors.

Quick Start

Make your first request in under a minute. You need a Creor API key from the dashboard (Settings > API Keys).

curl

curl https://api.creor.ai/v1/chat/completions \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      {"role": "user", "content": "What is the Creor Gateway?"}
    ]
  }'

OpenAI SDK (JavaScript)

OpenAI SDK (Python)

Request Format

The Gateway accepts the same request format as the OpenAI Chat Completions API. All standard parameters are supported.

POST https://api.creor.ai/v1/chat/completions
Content-Type: application/json
Authorization: Basic base64(YOUR_API_KEY:)

{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Explain TCP/IP in simple terms."}
  ],
  "temperature": 0.7,
  "max_tokens": 1024,
  "stream": false
}

Supported Parameters

Message Roles

Response Format

Non-streaming responses follow the OpenAI Chat Completions response format. The gateway normalizes responses from all providers into this consistent shape.

{
  "id": "chatcmpl-9f8g7h6j5k4l3m2n1",
  "object": "chat.completion",
  "created": 1712937600,
  "model": "claude-sonnet-4-20250514",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "TCP/IP is a set of rules that computers use..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 156,
    "total_tokens": 198
  }
}

Response Fields

Streaming

Set "stream": true to receive Server-Sent Events (SSE) as tokens are generated. This is the recommended approach for interactive applications where you want to display text as it arrives.

curl https://api.creor.ai/v1/chat/completions \
  -u YOUR_API_KEY: \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "stream": true,
    "messages": [
      {"role": "user", "content": "Write a short poem about code"}
    ]
  }'

See the dedicated Streaming page for the full event format, error handling, and complete SDK examples.

Usage & Billing

All requests through the Gateway are billed based on token usage. Each model has its own per-token pricing, which you can view on the Models page or in the dashboard.

How Billing Works

• Input tokens (your messages) and output tokens (the response) are billed separately.
• Pricing is per million tokens and varies by model.
• Usage is tracked in real time and visible in the dashboard under Usage & Analytics.
• Free plan users have a monthly credit allowance. Starter and Pro plans have higher or unlimited credits.
• If you exceed your credit balance, requests return a 402 Payment Required error until you add credits or upgrade.

Checking Your Usage

curl https://api.creor.ai/v1/usage \
  -u YOUR_API_KEY:

{
  "period_start": "2026-04-01T00:00:00Z",
  "period_end": "2026-04-30T23:59:59Z",
  "total_tokens": 1284560,
  "total_cost_usd": 3.42,
  "credit_remaining_usd": 16.58,
  "breakdown_by_model": [
    { "model": "claude-sonnet-4-20250514", "tokens": 820000, "cost_usd": 2.46 },
    { "model": "gpt-4o", "tokens": 464560, "cost_usd": 0.96 }
  ]
}

Next Steps