API

OpenAI-kapareho. Bawat modelo.

Point ang iyong umiiral na OpenAI SDK sa https://api.yout.chat/v1 Sa iyong Yout.chat key at bawat pangunahing modelo ay iyong. Isang credit pool, isang bill, walang per-modelo kontrata.

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

Drop-in na pagpapalit

Kung ang iyong code ay nagsasalita na sa OpenAI API, baguhin mo lamang ang dalawang bagay.

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)

Gumagana hindi nagbago sa OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, Ang OpenAI ay isang planetang hindi pangunahin.

Mga Endpoint

Lahat ng endpoints tanggapin Authorization: Bearer <key>. Ang mga cookies ng session ay gumagana para sa web app.

POST/v1/chat/completions

OpenAI000♠00♠000 Pag-paste stream: true para sa SSE. Credits debited atomically.

Humingi ng katawan
{
  "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
}
Tugon (hindi 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-kapaki-pakinabang na modelo ng listahan. Ang bawat aktibong modelo na may id, context_window, at per-token credit gastos.

POST/api/chat/stream/

Native streaming endpoint - simpleng JSON hugis kaysa sa OpenAI, ginagamit ng web app. /v1/chat/completions Ang mga ito ay tinatawag na mga SDK.

GET/api/chat/models/

Mas mayaman modelo katalogo na may mga tag na gawain, modality, pro-only flag. Gamitin ito sa iyong sariling UI.

GET/api/chat/limit/

Ang iyong kasalukuyang quota — credits balance + status ng plano, o anon araw-araw na allowance.

GET/api/chat/keys/

Ilista ang iyong mga aktibong API key (masked).

POST/api/chat/keys/

Lumikha ng isang pinangalanan API key. Buong token ay ibabalik sa isang beses — i-save ito.

Humingi ng katawan
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

Revoke ng isang susi. Nasasakupan session gamit ito makakuha ng 401 sa susunod na tawag.

POST/api/media/image/

Image henerasyon trabaho. Bumalik job_uuid; Talaan ng mga lungsod /api/media/jobs/<uuid>/.

POST/api/media/video/

Video generation job. ~1.2M credits para sa5segundo Veo. Credits auto-refund sa pagkabigo.

POST/api/media/speech/

Teksto-sa-pagsasalita. Bumalik job_uuid; Ang output ay isang naka-sign na audio URL kapag kumpleto.

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

Poll ng isang henerasyon ng trabaho: status, output_url, error, credits_cost.

POST/api/chat/share/

Lumikha ng isang pampublikong basahin lamang snapshot. Bumalik ng isang /c/<slug> Ang URL.

POST/api/chat/purge/

Wipe ang iyong mga pag-uusap, mga mensahe, at paggamit ledger server-side.

Pagbili

API paggamit pulls mula sa parehong credit pool bilang web app. Walang hiwalay na API billing.

Per-token pagpepresyo

Teksto modelo singil credits_per_1k_input × input token + credits_per_1k_output × output token. Media modelo singilin ng isang flat credits_per_call.

Minimum na singil

Ang bawat matagumpay na tawag ay may debit na hindi ba sa 10 credits upang masakop ang overhead, anuman ang bilang ng token.

Pagkakamali refund

Image / video / pagsasalita trabaho na nabigo upstream awtomatikong ibalik ang credits. Text stream failures bill lamang kung ano ang ginawa.

Overdraft

Pagbabalik ng tawag 402 insufficient_credits kapag ang iyong balanse ay hindi maaaring masakop ang tinatayang gastos. Plano ay hindi throttled hangga't plan_active <tl> ay totoo at balanse ay positibo.

Pag-authenticate & privacy

  • Ang Token ng Bearer — Pumili ng isang pagpipilian sa pamamagitan ng pagtanggal + muling paggawa ng iyong account (ang tamang pumili ng endpoint sa roadmap).
  • Walang user identifiers ipinadala — proxy kami sa mga provider na walang iyong email, IP, user agent, o account ID. Generic HTTP-Referer: yout.chat Ang Only.
  • no-log signal — ipinadala upstream kaya modelo provider ay tinanong na hindi mag-log / tren sa iyong mga prompt kung saan ang kanilang mga kontrata suporta ito.
  • Walang nilalaman ng mensahe persisted sa pamamagitan ng default — magsusulat kami ng isang UsageLedger hilera (tokens + credits + modelo) ngunit hindi ang prompt o tugon.

Roadmap

  • OpenAI-kapareho /v1/chat/completions shim kaya umiiral na SDKs trabaho unchanged
  • Webhook callbacks para sa mahabang-running media trabaho (palitan ang polling)
  • Token pag-ikot + bawat-token na mga sakop
  • Idempotency key sa /stream/ + Retry-ligtas na paglikha ng trabaho
  • Self-serve rate-limit controls

Handa na bang mag-ship?

Libreng antas ay nagbibigay sa iyo ng 50K credits upang i-play sa. Upgrade kapag kailangan mo ng higit pa.