API

OpenAI-compatibel. Elk model.

Richt je bestaande OpenAI SDK op https://api.yout.chat/v1 met je Yout.chat-sleutel en elk groot model is van jou. Eén creditpool, één rekening, geen contracten per model.

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

Naadloze vervanger

Als je code al met de OpenAI API praat, verander je maar twee dingen.

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)

Werkt ongewijzigd met OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, en alles wat de OpenAI-vorm spreekt.

Endpoints

Alle endpoints accepteren Authorization: Bearer <key>. Sessiecookies werken voor de webapp.

POST/v1/chat/completions

OpenAI-compatibel. Geef stream: true mee voor SSE. Credits worden atomair afgeschreven.

Request body
{
  "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
}
Respons (niet-streaming)
{
  "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-compatibele modellijst. Elk actief model met id, context_window, en de creditkosten per token.

POST/api/chat/stream/

Native streaming-endpoint — eenvoudiger JSON-vorm dan die van OpenAI, gebruikt door de webapp. Gebruik bij voorkeur /v1/chat/completions voor compatibiliteit met SDK's van derden.

GET/api/chat/models/

Uitgebreidere modelcatalogus met taaktags, modaliteit en pro-only-vlag. Gebruik dit in je eigen UI.

GET/api/chat/limit/

Je huidige quotum — creditsaldo + planstatus, of de dagelijkse limiet voor anonieme gebruikers.

GET/api/chat/keys/

Lijst je actieve API-sleutels (gemaskeerd).

POST/api/chat/keys/

Maak een benoemde API-sleutel. De volledige token wordt eenmalig getoond — bewaar hem.

Request body
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

Trek een sleutel in. Bestaande sessies die hem gebruiken krijgen 401 bij de volgende aanroep.

POST/api/media/image/

Beeldgeneratietaak. Retourneert job_uuid; poll /api/media/jobs/<uuid>/.

POST/api/media/video/

Videogeneratietaak. ~1,2 mln credits voor 5 seconden Veo. Credits worden automatisch terugbetaald bij mislukking.

POST/api/media/speech/

Tekst-naar-spraak. Retourneert job_uuid; uitvoer is een ondertekende audio-URL zodra deze klaar is.

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

Poll een generatietaak: status, output_url, error, credits_cost.

POST/api/chat/share/

Maak een openbare alleen-lezen momentopname. Retourneert een /c/<slug> URL.

POST/api/chat/purge/

Wis je gesprekken, berichten en gebruiksgrootboek aan de serverkant.

Facturering

API-gebruik put uit dezelfde creditpool als de webapp. Geen aparte API-facturering.

Prijzen per token

Tekstmodellen rekenen credits_per_1k_input × invoertokens + credits_per_1k_output × uitvoertokens. Mediamodellen rekenen een vast credits_per_call.

Minimumkosten

Elke geslaagde aanroep schrijft minstens 10 credits af om overhead te dekken, ongeacht het aantal tokens.

Terugbetaling bij mislukking

Beeld-/video-/spraaktaken die stroomopwaarts mislukken betalen credits automatisch terug. Bij mislukte tekststreams wordt alleen het geproduceerde gefactureerd.

Roodstand

Aanroepen retourneren 402 insufficient_credits wanneer je saldo de geschatte kosten niet kan dekken. Plannen worden niet vertraagd zolang plan_active waar is en het saldo positief is.

Authenticatie & privacy

  • Bearer-token — per gebruiker, te vinden op je Account-pagina. Roteer door je account te verwijderen + opnieuw aan te maken (een echt rotate-endpoint staat op de roadmap).
  • Geen gebruikersidentificatoren doorgestuurd — we proxyen naar providers zonder je e-mailadres, IP, user agent of account-ID. Alleen een generieke HTTP-Referer: yout.chat .
  • no-log signaal — wordt stroomopwaarts verzonden zodat modelproviders worden gevraagd je prompts niet te loggen/trainen waar hun contracten dat toelaten.
  • Geen berichtinhoud standaard bewaard — we schrijven een UsageLedger rij (tokens + credits + model) maar niet de prompt of respons.

Roadmap

  • OpenAI-compatibele /v1/chat/completions shim zodat bestaande SDK's ongewijzigd werken
  • Webhook-callbacks voor langlopende mediataken (vervangt polling)
  • Tokenrotatie + scopes per token
  • Idempotentiesleutels op /stream/ + herhaalveilige taakaanmaak
  • Zelfbedieningsbediening voor rate limits

Klaar om te lanceren?

Het gratis niveau geeft je 50K credits om mee te spelen. Upgrade wanneer je meer nodig hebt.