OpenAI-compatible endpoint

OpenHands can use OPENAI_BASE_URL=https://api.tekiz.ai/v1 with a hosted generated sk_tekiz_* key, or OPENAI_BASE_URL=http://127.0.0.1:8790/v1 for local routing.

Use Ollama on your router

On a router you run, use local models for suitable tasks and an authorized cloud route when the work needs more capacity.

When an OpenHands route fails

If a provider key or model rate-limits or fails, TEKIZ.AI can try the next healthy route you configured. OpenHands keeps the same endpoint.

Connect OpenHands

export OPENAI_BASE_URL=https://api.tekiz.ai/v1
export OPENAI_API_KEY=sk_tekiz_your_generated_key

# Then, in OpenHands Settings > LLM, use:
# Provider: OpenAI
# Model: tekizai/frontier
# Base URL: https://api.tekiz.ai/v1
# API key: your generated sk_tekiz key
# Use an OpenHands secret/environment setting for a generated key.

Development-mode OpenHands configuration

Development-mode OpenHands can instead use this TOML in its config.toml. It is a file example only. Do not paste it into a terminal.

[llm]
model = "tekizai/frontier"
api_base = "https://api.tekiz.ai/v1"
api_key = "sk_tekiz_your_generated_key"

# Local router alternative:
# api_base = "http://127.0.0.1:8790/v1"
# api_key = "local-router"

Keep long jobs moving

If a provider is unavailable, a new request can use another approved route. An active stream stays with the provider that started it.

Use more than one provider credential

A router you run can use your authorized provider credentials to handle rate limits and provider outages.

Use accounts you are allowed to use

Put authorized provider credentials on a router you control. A hosted TEKIZ.AI key uses the models available to your account.

Keep OpenHands connected to your chosen router

A router you run can choose approved providers or local models for each new request. Hosted accounts use a separate TEKIZ.AI endpoint and key.

Next steps

Create an API key, review local router setup, copy the hosted quickstart, or estimate routing fit.