API documentation

Rocket Relay is compatible with OpenAI-style client integrations. Point your SDK to the relay endpoint, authenticate with a Rocket Relay API key, and route traffic across models with one integration surface.

Quick start

Keep your existing client SDK and replace the base URL with Rocket Relay.

Standard balance billing

https://relay.rcapalpha.com/v1

BYOK routing (use credentials from your own pool)

https://relay.rcapalpha.com/byok/v1

Point any OpenAI-compatible client at /byok/v1. The upstream provider is inferred from the requested model, just like the shared pool — call a Claude model and your Anthropic key is used; call a GPT model and your OpenAI key is used.

Code examples

curl https://relay.rcapalpha.com/v1/chat/completions \
  -H "Authorization: Bearer sk-rr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Summarize our changelog"}]
  }'

Image generation and edits

Use gpt-image-2 on the Images API endpoints. Chat and text-generation requests should continue to use text models such as gpt-5.5 orclaude-sonnet-4-6.

Generate an image

curl https://relay.rcapalpha.com/v1/images/generations \
  -H "Authorization: Bearer sk-rr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product render of a transparent glass teapot on a walnut table",
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

Edit an image

curl https://relay.rcapalpha.com/v1/images/edits \
  -H "Authorization: Bearer sk-rr-YOUR-KEY" \
  -F model="gpt-image-2" \
  -F image="@input.png" \
  -F prompt="Replace the background with a bright studio setup" \
  -F response_format="b64_json"

GPT Image 2 is billed from image-token usage. Official list pricing is $8 input, $2 cached input, and $30 output per 1M image tokens; Rocket Relay shows the configured sell-side price in the model catalog below.

BYOK base URLs

If your tool only supports an OpenAI-style base URL and API key, switch the base URL to a BYOK endpoint instead of adding custom headers.

Use case	Base URL
Standard shared upstream billing	https://relay.rcapalpha.com/v1
BYOK (use credentials from your own pool)	https://relay.rcapalpha.com/byok/v1

`/byok/v1` is the single BYOK entry point. The upstream provider is chosen from the model name (e.g. `gpt-5.5` → your OpenAI key, `claude-sonnet-4-6` → your Anthropic key). Requests that map to a provider you have not stored a credential for return an error — they are never served from the shared account pool.

Endpoints

Method	Endpoint	Description
POST	/v1/chat/completions	OpenAI-compatible chat completions
POST	/v1/messages	Claude Messages API compatibility
POST	/v1/embeddings	Embeddings and vector-ready workflows
POST	/v1/images/generations	GPT Image 2 image generation
POST	/v1/images/edits	GPT Image 2 image edits with multipart or JSON image inputs
GET	/v1/models	Available models exposed by the relay
ANY	/byok/v1/...	Same OpenAI-compatible endpoints, but forced through your stored BYOK credential pool (provider chosen from the requested model)

Rate limits

Tier	RPM	TPM
Starter	60	100,000
Professional	300	500,000
Enterprise	1,000	2,000,000

Response headers include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`.

Supported models and sell-side pricing

Loading model catalog...