Integration docs

What is the gonka.broker API?

gonka.broker is an OpenAI-compatible gateway to decentralized AI infrastructure. Existing applications can usually connect by changing the base URL, model alias, and API key.

OpenAI Python SDK

from openai import OpenAI
import os

client = OpenAI(
  api_key=os.environ["GONKA_API_KEY"],
  base_url="https://api.gonka.broker/v1"
)

response = client.chat.completions.create(
  model="gonka-auto",
  messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

cURL

curl https://api.gonka.broker/v1/chat/completions \
  -H "Authorization: Bearer $GONKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gonka-auto","messages":[{"role":"user","content":"Hello"}]}'

Hermes and OpenClaw

Create an OpenAI-compatible provider, set the base URL to https://api.gonka.broker/v1, use gonka-auto, and load GONKA_API_KEY from the local environment.

n8n

Use an HTTP Request node or an OpenAI-compatible credential. Set the Authorization header to Bearer {{$env.GONKA_API_KEY}}.

LangChain

from langchain_openai import ChatOpenAI
import os

llm = ChatOpenAI(
  model="gonka-auto",
  api_key=os.environ["GONKA_API_KEY"],
  base_url="https://api.gonka.broker/v1"
)

Streaming and retries

The chat-completions endpoint supports streaming. For HTTP 429 and temporary 5xx responses, use exponential backoff with jitter and a hard retry ceiling.

Account and payments

The customer portal provides account access and balance information. USDT TRC20 top-ups are coming soon.