API

OpenAI-kompatibel. All Modell.

D'Spill ass OpenAI Stück verkaaft ginn. https://api.yout.chat/v1 mat Ärem Yout.chat Schlëssel an all wichteg Modell ass Ären. E Kreditpool, eng Rechnung, keng Kontrakter pro Modell.

Basis- URL: https://api.yout.chat/v1 · Auth: Authorization: Bearer <your-key>

Registréieren fir e Schlëssel ze kréien Code

Ersatz fir Drop-in

If your code already talks to the OpenAI API, you only change two things.

from openai import OpenAI

client = OpenAI(
    api_key="yout-...",                  # ← from Account → API keys
    base_url="https://api.yout.chat/v1",       # ← that's it
)

resp = client.chat.completions.create(
    model="anthropic-claude-sonnet-46",
    messages=[
        {"role": "user", "content": "Write a haiku about caching."},
    ],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "yout-...",
  baseURL: "https://api.yout.chat/v1",
});

const stream = await client.chat.completions.create({
  model: "openai-gpt-54",
  messages: [{ role: "user", content: "Stream a bedtime story, one sentence." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

KEY="yout-..."

curl -N https://api.yout.chat/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic-claude-opus-47",
    "messages": [{"role":"user","content":"Say hi in one word."}],
    "stream": true
  }'

D'Aarbechten sinn net geännert ginn OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, Et ass eng vun de gréisste Schëffer vun der Welt mat OpenAI Tonnen.

Endpunkten

All Endpunkte akzeptéieren Authorization: Bearer <key>. D'Websäit vum Veräin ass op der Websäit vum Veräin.

POST/v1/chat/completions

OpenAI Awunner. Pass stream: true fir SSE. Kreditter atomesch debitéiert.

Ufro-Körper

{
  "model": "anthropic-claude-sonnet-46",
  "messages": [
    {"role": "system", "content": "You are helpful."},
    {"role": "user",   "content": "What is 2+2?"}
  ],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 512
}

Antwort (net Stream)

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "anthropic-claude-sonnet-46",
  "choices": [{"index":0,"message":{"role":"assistant","content":"Four."},"finish_reason":"stop"}],
  "usage": {"prompt_tokens": 15, "completion_tokens": 2, "total_tokens": 17},
  "yout": {"credits_charged": 10, "balance": 14999990}
}

GET/v1/models

OpenAI-compatible model list. Every active model with id, context_window, Et gëtt och Kreditt- a Kredittkaartservicer.

POST/api/chat/stream/

Native streaming endpoint — simpler JSON shape than OpenAI's, used by the web app. Prefer /v1/chat/completions D'Sprooch ass eng Sprooch mat enger grousser Diversitéit.

GET/api/chat/models/

Richtiger Modellkatalog mat Task-Tags, Modalitéiten, pro-only Flaggen. Benotzt dëst an Ärer eegener UI.

GET/api/chat/limit/

D'Aktivitéite vun der Gemeng sinn: d'Aarbechtsplazen, d'Schoul, d'Sozialversécherung an d'Aarbechtszäit.

GET/api/chat/keys/

D'Aktivitéite vun der Gemeng sinn: (fr)

POST/api/chat/keys/

Erstellen en API Schlëssel mat Numm. Full Token gëtt eemol zréckginn - späichert et.

Ufro-Körper

{"name": "production"}

POST/api/chat/keys/<id>/revoke/

En Schlëssel zréckzéien. Existéierend Sessioune mat him kréien 401 op dem nächsten Uruff.

POST/api/media/image/

Bildgeneréierungsauftrag. job_uuid; Pol /api/media/jobs/<uuid>/.

POST/api/media/video/

Videogeneréierungsaufgab. ~1.2M Credits fir 5-Sekonnen Veo. Credits automatesch zréckbezuelt wann et net klappt.

POST/api/media/speech/

Text-zu-Sprooch. job_uuid; Ausgab ass eng signéiert Audio- URL wann se fäerdeg ass.

GET/api/media/jobs/<uuid>/

Generéiere vun engem Auftrag status, output_url, error, credits_cost.

POST/api/chat/share/

Erstellen vun engem ëffentleche Schnappschuss. /c/<slug> URL:

POST/api/chat/purge/

D'Sprooch gëtt och an der Kommunikatioun, an der Kommunikatiounstechnik an an der Kommunikatiounstechnik benotzt.

Abrechnung

D'API-Benotzung gëtt aus dem selwechte Kreditpool wéi d'Webapp gezunn. Keng separat API-Billing.

Lëscht vun de Präisdréier

Textmodelle credits_per_1k_input × input tokens + credits_per_1k_output × Ausgabetoken. Medienmodelle bezuelen e flaache Präis credits_per_call.

Minimum

All Joer gëtt et eng Ausstellung mat 100 Biller, déi an der ganzer Stad ze gesinn sinn.

Retour

Bild-/Video-/Sprooch-Aufgaben, déi am Upstream verluer goen, ginn automatesch zréckbezuelt. Textstream-Verluer bezuelen nëmmen dat, wat produzéiert gouf.

Iwwerschreiden

Anrufe 402 insufficient_credits wann Äert Saldo d'geschätzte Käschte net decken kann. Pläng ginn net gedrosselt soulaang wéi plan_active ass richteg an de Saldo ass positiv.

Authentifizéierung & Privatsphär

Lëscht vu lëtzebuergesche Schrëftsteller — pro Benotzer, op Ärer Kontsäit ze fannen. Rotatiounen duerch Läschen + Neierstellen vun Ärem Kont (richtege Rotatiouns-Ennpunkt op der Roadmap).
Keng Benotzeridentifikatiounen weidergeleet — Generic HTTP-Referer: yout.chat just
no-log Signal — Upstream geschéckt, fir datt Modell-Provider net op Är Prompts loggen/trainéieren, wann hir Kontrakter et ënnerstëtzen.
Standardmäßeg gëtt keng Noriichtinhalt behalen — mir schreiwen e UsageLedger D'Reegel (Token + Credits + Modell) awer net d'Prompt oder d'Äntwert.

Roadmap

OpenAI-kompatibel /v1/chat/completions shim sou datt d'existéierend SDKs onverännert funktionnéieren
Webhook Callbacks fir laang lafend Medienjobs (ersetzt Polling)
Lëscht vun de lëtzebuergesche Schrëftsteller
Idempotency keys on /stream/ + Retry- safe Aufgabserstellung
Lëscht vun de lëtzebuergesche Gemengen

Sidd Dir bereet ze schécken?

D'Spill huet 50 Punkten an et gëtt 500

Freed Präisiwwerreechung