• English
  • API reference

    Geekit exposes each upstream provider's own request format and replaces only the authentication with a Geekit-issued token. Point your SDK's base URL at the gateway, swap the key for a Geekit token, and the rest of your code is unchanged.

    Authentication

    Authorization: Bearer sk-xxxxxxxxxxxxxxxx

    Tokens are created in the dashboard and can be restricted by group, allowed models, quota, and expiry.

    OpenAPI specifications

    The machine-readable specifications are published alongside these docs and can be imported into Postman, Insomnia, or a code generator:

    FileContents
    relay.jsonRelay endpoints: chat, images, audio, embeddings, rerank
    api.jsonManagement endpoints: users, tokens, channels, logs, billing

    Supported request formats

    FormatPath prefixNotes
    OpenAI Compatible/v1/chat/completionsWidest coverage; the default choice
    OpenAI Responses/v1/responsesResponses format
    OpenAI Realtime/v1/realtimeAzure included
    Claude Messages/v1/messagesAnthropic's native format
    Google Gemini/v1beta/models/...Gemini's native format
    Rerank/v1/rerankCohere, Jina
    Midjourney Proxy/mjImage tasks
    Suno/sunoMusic tasks

    Format conversion

    The gateway converts between formats, so a client speaking one format can reach an upstream that speaks another:

    • OpenAI Compatible ⇄ Claude Messages
    • OpenAI Compatible → Google Gemini
    • Google Gemini → OpenAI Compatible (text only; function calling is not supported yet)
    • Reasoning content folded into regular content

    Example

    curl https://<your-gateway-domain>/v1/chat/completions \
      -H "Authorization: Bearer $GEEKIT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-5",
        "messages": [{"role": "user", "content": "Hello"}],
        "stream": true
      }'

    Billing

    Charges follow the usage reported by the upstream, separating input, output, cache-hit, and reasoning tokens, then converting to quota with the channel's ratios. Every request writes its billing detail to the log, so you can reconcile by token, model, or channel in the dashboard.