GET STARTED

Your first Yugo request

A familiar API, with automatic model routing.

1. Create an API key

At launch, sign in to the console (coming soon), select a project, and create a key. Save the key on your server; it is shown once. Never put it in frontend code or source control.

2. Set your connection

The API base URL is https://bitmind--yugo-api-gateway-fastapi-app.modal.run/v1.

export YUGO_API_KEY="<your project key>"
export YUGO_BASE_URL="https://bitmind--yugo-api-gateway-fastapi-app.modal.run/v1"

3. Make a Chat Completions call

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["YUGO_BASE_URL"],
    api_key=os.environ["YUGO_API_KEY"],
    max_retries=0,
)

response = client.chat.completions.create(
    model="yugo",
    messages=[{"role": "user", "content": "Hello, Yugo."}],
    max_tokens=1024,
    reasoning_effort="minimal",
)
print(response.choices[0].message.content)

Use an output-limit parameter supported by the chosen models. max_tokens and max_completion_tokens retain their native semantics. Find supported capabilities with GET /v1/catalog.

4. Inspect the receipt

Responses include a request ID and receipt location. View execution and billing status in Requests, then inspect actual model costs in Usage & spend. Pending costs remain pending until authoritative usage is available.

See routing controls, retry behavior, and current compatibility before integrating a client.