API

OpenAI-kompatibbli. Kull mudell.

Punt tiegħek eżistenti OpenAI SDK fuq https://api.yout.chat/v1 ma Yout.chat ewlenin tiegħek u kull mudell maġġuri huwa tiegħek. pool kreditu wieħed, kont wieħed, l-ebda kuntratti kull mudell.

URL bażiku: https://api.yout.chat/v1 · Awtorizzazzjoni: Authorization: Bearer <your-key>

Sostituzzjoni drop-in

Jekk il-kodiċi tiegħek diġà jitkellem lill-OpenAI API, inti biss jibdlu żewġ affarijiet.

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)

Xogħlijiet mhux mibdula ma OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, u xi ħaġa oħra li titkellem il-forma OpenAI.

Punti aħħarin

Il-punti aħħarin kollha jaċċettaw Authorization: Bearer <key>. Il-cookies tas-sessjoni jaħdmu għall-web app.

POST/v1/chat/completions

OpenAI-kompatibbli. Pass stream: true għall-SSE. Krediti ddebititati atomikament.

Korp tat-talba
{
  "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
}
Rispons (mhux fluss)
{
  "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

Lista tal-mudell kompatibbli OpenAI. Kull mudell attiv b' id, context_window, u l-ispiża tal-kreditu għal kull token.

POST/api/chat/stream/

Native streaming endpoint — forma JSON aktar sempliċi minn OpenAI, użat mill-web app. Preferixxi /v1/chat/completions għall-kompatibbiltà tal-SDK ta' parti terza.

GET/api/chat/models/

Katalogu mudell rikk b'tags kompitu, modalità, bandiera pro-biss. Uża dan fl-UI tiegħek stess.

GET/api/chat/limit/

Il-kwota attwali tiegħek — bilanċ ta’ krediti + status tal-pjan, jew allowance ta’ kuljum anon.

GET/api/chat/keys/

Elenka ċ-ċwievet API attivi tiegħek (masked).

POST/api/chat/keys/

Oħloq API ewlenija imsemmija. token sħiħ huwa rritornat darba - tissejvja.

Korp tat-talba
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

Revokar ta' ċavetta. Sessjonijiet eżistenti li jużawha jiksbu 401 fuq is-sejħa li jmiss.

POST/api/media/image/

Xogħol tal-ġenerazzjoni tal-immaġni. Ritorni job_uuid; toqba /api/media/jobs/<uuid>/.

POST/api/media/video/

Video ġenerazzjoni tax-xogħol. ~1.2M krediti għall-5-sekonda Veo. Krediti awtomatiku rimborżat fuq falliment.

POST/api/media/speech/

Test-to-speech. Ritorni job_uuid; output huwa URL awdjo ffirmat ladarba kompleta.

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

Poll a ġenerazzjoni tax-xogħol: status, output_url, error, credits_cost.

POST/api/chat/share/

Oħloq snapshot pubbliku qari biss. Jirritorna a /c/<slug> URL.

POST/api/chat/purge/

Imsaħ konversazzjonijiet tiegħek, messaġġi, u l-użu tal-leġiżlatur server-side.

Fatturazzjoni

L-użu API jiġbed mill-istess pool kreditu bħala l-web app. L-ebda API separata billing.

Prezzijiet għal kull token

Ħlas għall-mudelli tat-test credits_per_1k_input × tokens ta’ input + credits_per_1k_output × tokens output. mudelli tal-midja jiċċarġjaw flat credits_per_call.

Ħlas minimu

Kull sejħa b'suċċess debits mill-inqas 10 krediti biex ikopru overhead, irrispettivament mill-għadd token.

Rifużjoni ta’ nuqqas

Ix-xogħlijiet ta’ immaġni/vidjow/diskors li ma jirnexxilhomx upstream awtomatikament jirrimborżaw il-krediti.

Overdraft

Ritorn ta’ sejħiet 402 insufficient_credits meta l-bilanċ tiegħek ma jkunx jista' jkopri l-ispiża stmata. Il-pjanijiet ma jiġux imrażżna sakemm plan_active huwa veru u l-bilanċ huwa pożittiv.

Awtentikazzjoni & privatezza

  • Token tal-portatur — għal kull utent, li tinstab fuq il-paġna Kont tiegħek.Rotate billi tħassar + re-ħolqien kont tiegħek (punt aħħari rotazzjoni xierqa fuq il-pjan direzzjonali).
  • L-ebda identifikaturi tal-utent mhumiex mgħoddija — aħna proxy lill-fornituri mingħajr email tiegħek, IP, user agent, jew ID kont. ġeneriċi HTTP-Referer: yout.chat biss.
  • no-log sinjal — mibgħuta upstream sabiex fornituri mudell huma mitluba ma log/taħriġ fuq il-prompts tiegħek fejn il-kuntratti tagħhom jappoġġjaw dan.
  • L-ebda kontenut tal-messaġġ ma jippersisti b'mod default — aħna jiktbu a UsageLedger (tokens + krediti + mudell) iżda mhux il-prompt jew ir-rispons.

Pjan direzzjonali

  • OpenAI-kompatibbli /v1/chat/completions shim sabiex SDKs eżistenti jaħdmu mhux mibdula
  • Webhook callbacks għal xogħlijiet tal-midja fit-tul (jissostitwixxu l-votazzjoni)
  • Rotazzjoni tat-token + skoperturi għal kull token
  • Idempotency ċwievet fuq /stream/ + ħolqien ta' impjiegi sikuri li ma jerġgħux jiġu ppruvati
  • Kontrolli tal-limitu tar-rata self-service

Lest biex tibgħat?

Livell b'xejn jagħtik krediti 50K biex tilgħab. Aġġorna meta jkollok bżonn aktar.