API Overview

kineticRouter offers three API protocol families: OpenAI-compatible, Anthropic native, and Grok / xAI.

Base URL

Protocol	Base URL	Description
OpenAI Compatible	`https://api.kineticrouter.com/v1`	Compatible with OpenAI SDK, supports all models
Anthropic Native	`https://api.kineticrouter.com/anthropic`	Compatible with Anthropic SDK, native Claude experience
Grok / xAI Protocol	`https://api.kineticrouter.com/grok`	Grok / xAI route with an xAI OpenAI-compatible text JSON/SSE shape

Authentication

All protocols use a unified kineticRouter API Key, but the header format varies by protocol:

Protocol	Header	Format
OpenAI	`Authorization`	`Bearer sk-xxx`
Anthropic	`x-api-key`	`sk-xxx`
Grok / xAI	`Authorization`	`Bearer sk-xxx`

See the Authentication guide for details.

Available Endpoints

OpenAI Compatible Protocol

Endpoint	Method	Description
`/v1/chat/completions`	POST	Create chat completion
`/v1/models`	GET	List available models
`/v1/models/{model_id}`	GET	Get model details
`/v1/images/generations`	POST	Generate images

Anthropic Native Protocol

Endpoint	Method	Description
`/anthropic/v1/messages`	POST	Create Messages

Grok / xAI Protocol

Endpoint	Method	Description
`/grok/v1/chat/completions`	POST	Create a Grok chat completion. See Chat Completions
`/grok/v1/responses`	POST	Create a Grok Responses API response. See Responses
`/grok/v1/models`	GET	List available Grok models. See Models
`/grok/v1/models/{model_id}`	GET	Get a Grok model detail

Rate Limits

kineticRouter uses pay-as-you-go pricing with a unified rate policy for all users:

Limit	Quota
RPM (requests/minute)	100 (team-aggregated)
TPM (tokens/minute)	Unlimited

RPM is aggregated at the team level — multiple API Keys under the same team share a single quota. If you need a higher RPM quota, contact kineticRouter support to request an adjustment.

When rate-limited, the API returns 429 Too Many Requests with the following response headers:


x-ratelimit-limit-requests: 100
x-ratelimit-remaining-requests: 0
x-ratelimit-reset-requests: 1s

Error Codes

All protocols return unified HTTP status codes:

Status Code	Description	Common Causes
`200`	Success	—
`400`	Bad Request	Invalid parameters, missing required fields
`401`	Unauthorized	Invalid or expired API Key
`403`	Forbidden	Account lacks access to the model
`404`	Not Found	Incorrect model ID
`429`	Rate Limited	Exceeded rate limit
`500`	Server Error	Internal error, please retry
`502`	Upstream Error	Model provider service issue
`503`	Service Unavailable	Under maintenance

Error Response Format


{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API Key is invalid. Please check and try again.",
    "type": "authentication_error"
  }
}

kineticRouter Extension Parameters

kineticRouter provides extension parameters on top of standard protocols for advanced routing and fallback control:

Planned example

The Anthropic-native route is planned and its configuration is shown only as a reference. This example is intentionally not copyable in its current display state.

See Provider Routing and Fallback for details.