ModGate
Sign in
Build

API reference

ModGate implements the OpenAI v1 API. Every endpoint below is a drop-in replacement — point any OpenAI SDK at our base URL.

Base URL

https://api.modgat.com/v1

Chat completions

POST /v1/chat/completions

{
  "model": "claude-4.5-sonnet",
  "messages": [{ "role": "user", "content": "Hello" }],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 1024,
  "tools": [],
  "response_format": { "type": "json_object" }
}

ModGate-specific headers

  • X-ModGate-Route — cheapest, fastest, or a comma-separated fallback chain.
  • X-ModGate-Channel — pin a specific upstream channel code.
  • X-ModGate-Budget — max cost in USD for this call.

Embeddings

POST /v1/embeddings

{
  "model": "openai/text-embedding-3-large",
  "input": ["one", "two", "three"]
}

Images

POST /v1/images/generations

{
  "model": "openai/gpt-image-1",
  "prompt": "a cat in a top hat",
  "size": "1024x1024",
  "n": 1
}

Audio

  • POST /v1/audio/speech — text-to-speech
  • POST /v1/audio/transcriptions — speech-to-text

Metadata

  • GET /v1/meta/model/list — every callable model + pricing
  • GET /v1/meta/endpoint/list — every gateway endpoint
  • GET /v1/meta/supplier/list — providers
  • GET /v1/meta/category/tree/all — category taxonomy

Account

  • GET /v1/apikey/balance/{code} — remaining quota
  • GET /v1/apikey/cost/{code} — spend
  • GET /v1/apikey/qps/{code} — live QPS
  • GET /v1/metrics — request timeseries