Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Consumer API

Consumers reach the network through ogong-gatewayd, which speaks an OpenAI-compatible HTTP API. Any OpenAI client library works; point its base URL at the gateway.

Model id format

OGONG model ids encode the trust tier, the maker, and the model:

ogong/<tier>/<maker>/<model>
  • <tier> - verified or tee (see Trust tiers).
  • <maker> - the model author; attributed on-chain (royalty slot reserved, inactive at launch).
  • <model> - the model name.

Example: ogong/verified/<maker>/llama-3.3-70b.

The gateway parses the id, asks the router for a provider that can serve that tier + model, and forwards the request.

Chat completions

curl http://127.0.0.1:4546/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{
    "model": "ogong/verified/<maker>/<model>",
    "messages": [
      {"role": "system", "content": "You are helpful."},
      {"role": "user", "content": "Hello from OGONG"}
    ],
    "stream": true
  }'

Streaming uses standard OpenAI SSE framing.

Other modalities

Providers can serve image, audio (music / TTS / STT), and video. The corresponding OpenAI-style endpoints are forwarded to a provider that serves that modality:

EndpointModality
/v1/chat/completionstext (and vision input)
/v1/embeddingsembeddings
/v1/images/*image generation
/v1/audio/musicmusic generation
/v1/audio/speechtext-to-speech
/v1/audio/transcriptionsspeech-to-text
/v1/videos/*video generation

Availability depends on what providers in the marketplace are serving for the requested tier.

Pricing

The gateway enforces a budget ceiling per 1k tokens via --max-price (atomic OGONG units). Requests that would exceed it are rejected at match time. Settlement of paid work happens on-chain after a passing audit and validator quorum; see How verification works.