API MasterOpenAI-compatibleMulti-provider

Jatevo API Master docs for model routes and coding agents.

One API key, one OpenAI-compatible endpoint, and provider-specific model IDs for Cerebras, Qwen, Kimi, OpenAI, GLM, NVIDIA, and future routes. Use these docs to wire Jatevo into Hermes Agent, OpenCode, Cline, Roo Code, OpenClaw, LiteLLM, and normal SDKs.

Base URL
https://api.jatevo.ai/v1
Key format
sk-jvo-...
Usage
api.jatevo.ai/usage
Docs index

Jump to provider, harness, or reference sections.

Quickstart

Make the first request

Every Jatevo route uses the same base URL and Bearer token shape. Choose the model ID that maps to your provider.

curl

Works with any API Master key

export JATEVO_API_KEY=sk-jvo-your-key-here

curl https://api.jatevo.ai/v1/chat/completions \
  -H "Authorization: Bearer $JATEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cerebras/gemma-4-31b",
    "messages": [
      {"role": "user", "content": "Say hello from Jatevo API Master."}
    ],
    "max_tokens": 120
  }'
Minimum values
Base URL
https://api.jatevo.ai/v1
API key
sk-jvo-...
Header
Authorization: Bearer
Default test model
cerebras/gemma-4-31b
Endpoint reference

OpenAI-compatible surface

Use the standard /v1 path for SDKs and harnesses. Provider routing is controlled by the model ID.

POST/v1/chat/completions

OpenAI-compatible chat endpoint for most SDKs, agents, and coding tools.

POST/v1/responses

Responses-style endpoint where the selected upstream route supports it.

GET/v1/models

List models visible to the current API key.

GET/docs-json

Machine-readable route examples and model metadata.

Provider docs

Dedicated provider pages

Each provider needs its own model IDs, limits, pricing, and caveats. These cards are the first version of that catalog.

Cerebras Gemma 4 31B

Cerebras

Use the 131K context setting. Jatevo validation found that to be the practical limit on the current Cerebras route.

Ready
Model ID
cerebras/gemma-4-31b
Context
131K total tokens
Max output
32,768 tokens
Pricing
$1.00 input / $1.50 output per 1M tokens
Protocol
Chat Completions, streaming
Aliases
gemma-4-31b

Alibaba Model Studio / Qwen 3.7 Max

Alibaba Cloud

Use the Jatevo Qwen route instead of putting Alibaba keys in local agent configs.

Ready
Model ID
qwen/qwen3.7-max
Context
1M listed window
Max output
65,536 tokens
Pricing
API Master pricing
Protocol
Chat Completions
Aliases
qwen3.7-max

Kimi K2.7 Code

Jatevo Inference

Best default for coding agents that need long-context source edits and tool-use style prompts.

Ready
Model ID
kimi-k2.7-code
Context
256K listed window
Max output
Route dependent
Pricing
$0.75 input / $3.50 output per 1M tokens
Protocol
Chat Completions, Responses where supported
Aliases
kimi/kimi-k2.7-code

OpenAI / Codex LB

OpenAI via Jatevo LB

Use this route for frontier reasoning and OpenAI-style compatibility while keeping keys and budgets centralized.

Ready
Model ID
lb/gpt-5.5
Context
272K for GPT 5.5 route
Max output
Route dependent
Pricing
API Master credits
Protocol
Chat Completions, Responses where supported
Aliases
gpt-5.5, gpt-5.4, codex-auto-review

GLM route

Z.ai / GLM

Keep this as an explicit route. It is no longer the OpenClaw default model.

Draft
Model ID
glm/GLM-5.2
Context
200K listed window
Max output
Route dependent
Pricing
$1.40 input / $4.40 output per 1M tokens
Protocol
Chat Completions
Aliases
glm/GLM-5.1

NVIDIA Nemotron 3 Ultra

NVIDIA route

Use when you need a large reasoning route and can tolerate provider-specific reasoning controls.

Ready
Model ID
nvidia/Nemotron-3-Ultra-550b-a55b
Context
128K listed window
Max output
Route dependent
Pricing
$1.00 input / $3.00 output per 1M tokens
Protocol
Chat Completions
Aliases
None
Harness integrations

Agent and editor setup

Each guide explains where to paste the base URL, where the key belongs, which model ID to use, and how to verify the connection.

Hermes Agent

Best first model: cerebras/gemma-4-31b

Ready
  1. 1Create ~/.hermes/.env and store JATEVO_API_KEY.
  2. 2Register Jatevo as a custom provider in ~/.hermes/config.yaml.
  3. 3Use provider custom:jatevo and model cerebras/gemma-4-31b.
  4. 4Restart hermes gateway only when Telegram or Discord gateway is already running.

~/.hermes/config.yaml

custom_providers:
  - name: jatevo
    base_url: https://api.jatevo.ai/v1
    key_env: JATEVO_API_KEY
    api_mode: chat_completions
    models:
      cerebras/gemma-4-31b:
        name: Cerebras Gemma 4 31B
        context_length: 131000

model:
  provider: custom:jatevo
  default: cerebras/gemma-4-31b
  context_length: 131000

OpenCode

Best first model: kimi-k2.7-code

Ready
  1. 1Run opencode auth login and add a Jatevo provider key.
  2. 2Use the OpenAI-compatible AI SDK adapter.
  3. 3Set options.baseURL to https://api.jatevo.ai/v1.
  4. 4Restart OpenCode and verify the model appears under /models.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "jatevo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Jatevo API Master",
      "options": {
        "baseURL": "https://api.jatevo.ai/v1"
      },
      "models": {
        "kimi-k2.7-code": {
          "name": "Kimi K2.7 Code"
        },
        "cerebras/gemma-4-31b": {
          "name": "Cerebras Gemma 4 31B"
        }
      }
    }
  }
}

Cline / Roo Code

Best first model: cerebras/gemma-4-31b

Ready
  1. 1Open the extension settings.
  2. 2Set API Provider to OpenAI Compatible.
  3. 3Set Base URL, API Key, and Model ID exactly as shown.
  4. 4Click Verify, then run a short prompt before a real code task.

Settings values

API Provider: OpenAI Compatible
Base URL: https://api.jatevo.ai/v1
API Key: sk-jvo-your-key-here
Model ID: cerebras/gemma-4-31b
Max output: 32768
Context window: 131000

OpenClaw

Best first model: openai/gpt-5.5 or provider-prefixed routes

Ready
  1. 1Add Jatevo as an OpenAI-compatible provider.
  2. 2Keep the Jatevo key in environment variables.
  3. 3Expose selected routes in the model picker.
  4. 4Use provider-specific aliases for Cerebras, Qwen, Kimi, GLM, or LB routes.

Provider shape

{
  "models": {
    "providers": {
      "jatevo-api": {
        "api": "openai-completions",
        "baseUrl": "https://api.jatevo.ai/v1",
        "apiKey": "${JATEVO_API_KEY}",
        "models": {
          "cerebras/gemma-4-31b": {},
          "kimi-k2.7-code": {},
          "qwen/qwen3.7-max": {}
        }
      }
    }
  }
}

LiteLLM

Best first model: Any Jatevo model ID

Draft
  1. 1Define one LiteLLM model entry per Jatevo route.
  2. 2Set api_base to the Jatevo /v1 endpoint.
  3. 3Keep the API key in environment variables.
  4. 4Use LiteLLM budgets only if you need an extra customer-facing policy layer.

litellm.yaml

model_list:
  - model_name: jatevo-gemma
    litellm_params:
      model: openai/cerebras/gemma-4-31b
      api_base: https://api.jatevo.ai/v1
      api_key: os.environ/JATEVO_API_KEY

Python and TypeScript SDKs

Best first model: Any Jatevo model ID

Ready
  1. 1Use the official OpenAI SDK.
  2. 2Change only base_url/baseURL, api_key, and model.
  3. 3Keep Jatevo attribution headers for app-level tracking.
  4. 4Use stream=true when the harness expects incremental output.

Python

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.jatevo.ai/v1",
    api_key=os.environ["JATEVO_API_KEY"],
)

response = client.chat.completions.create(
    model="cerebras/gemma-4-31b",
    messages=[{"role": "user", "content": "Reply with one short sentence."}],
    max_tokens=120,
)

print(response.choices[0].message.content)
Compatibility matrix

Provider by harness

Use this as the index for future dedicated provider and harness pages.

ProviderHarnessStatusModel IDContextStreaming
Cerebras Gemma 4 31BHermes AgentReadycerebras/gemma-4-31b131KYes
Cerebras Gemma 4 31BCline / Roo CodeReadycerebras/gemma-4-31b131KYes
Kimi K2.7 CodeOpenCodeReadykimi-k2.7-code256K listedYes
Qwen 3.7 MaxOpenClawReadyqwen/qwen3.7-max1M listedYes
OpenAI / Codex LBOpenClawReadylb/gpt-5.5272KYes
GLM routeLiteLLMDraftglm/GLM-5.2200K listedYes
Credits and usage

Check usage without exposing vendor keys.

Users paste their Jatevo API Master key into the usage dashboard to inspect remaining credit, request logs, cached input tokens, and per-model usage. Vendor keys stay server-side.

Open usage dashboard
Error reference

Common integration failures

These are the first checks when a harness fails to connect.

401

Missing or invalid key

Set Authorization: Bearer sk-jvo-... and verify the key is active.

402

Monthly budget exhausted

Top up or wait for the budget window to reset.

403

Model not allowed

Use the model ID enforced on the key, especially for grant keys.

429

Rate limit exceeded

Reduce agent concurrency or wait for the rolling RPM window.

context_length_exceeded

Prompt too long

Keep prompt plus completion under the provider context limit.

5xx / upstream unavailable

Provider route failed

Retry. Jatevo logs the upstream route and request ID for debugging.

Roadmap

Next docs pages to split out

The current /docs page is the index. These should become dedicated pages as the docs surface grows.

Provider pages

  • /docs/providers/cerebras
  • /docs/providers/qwen
  • /docs/providers/kimi

Harness pages

  • /docs/harnesses/hermes
  • /docs/harnesses/opencode
  • /docs/harnesses/cline

Reference pages

  • /docs/errors
  • /docs/limits
  • /docs/billing