API

OpenAI-compatible. Wonke uhlobo.

Usho ukuthi i-OpenAI SDK yakho ekhona ikhona https://api.yout.chat/v1 nge-Yout.chat yakho ebalulekile futhi ngayinye imodeli enkulu iyini yakho. I-credit pool eyodwa, i-bill eyodwa, akukho imigomo yemodeli ngayinye.

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

Bhala ukuze uthole isithonjana Iya kwikhodi

Ukushintsha-faka

Uma ikhodi yakho sele ikhuluma ne-OpenAI API, ushintsha izinto ezimbili kuphela.

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
  }'

Isebenza ngaphandle koshintsho OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, futhi noma yini enye ekhuluma OpenAI uhlobo.

Izinkomba zesiphelo

Zonke iziqephu eziphelile zivuma Authorization: Bearer <key>. I-cookies yesiqephu isebenza kwi-web app.

POST/v1/chat/completions

OpenAI-ehambisanayo. I-password stream: true i-SSE. Ama-credits akhokhwa ngokuzenzakalela.

Isiqu sesicelo

{
  "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
}

Uphendulelo (akukho lutho)

{
  "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-ilungele uhlu lwemodeli. Yonke imodeli esebenzayo id, context_window, kanye nezindleko zemali engenayo ngayinye.

POST/api/chat/stream/

Isimo sokuphela kokuthunyelwa okusemthethweni — isimo se-JSON esilula kunaso se-OpenAI, esisetshenziswa yi-web app. /v1/chat/completions i-SDK ehambisanayo yeqembu lesithathu.

GET/api/chat/models/

Imodeli egcwele kakhulu ye-catalog enezithonjana zomsebenzi, indlela, i-pro-only flag. Sebenzisa lokhu ku-UI yakho.

GET/api/chat/limit/

I-quota yakho yamanje — i-credits balance + plan status, noma anon daily allowance.

GET/api/chat/keys/

Linganisa izinkinobho zakho ezisebenzayo ze-API (zifihlakele).

POST/api/chat/keys/

Dala isithonjana se-API esibizwa ngegama. I-token ephelele ibuyiselwa kabili — igcinwe.

Isiqu sesicelo

{"name": "production"}

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

Khubaza isithonjana. Izingqungquthela ezikhona ezisebenzisa lokhu zithola 401 kunoma yisiphi isikhalazo esilandelayo.

POST/api/media/image/

Umsebenzi wokuhlela isithombe. Ibuyela job_uuid; umngcele /api/media/jobs/<uuid>/.

POST/api/media/video/

Umsebenzi wokuhlela ividiyo. ~1.2M ama-credits we-5-second Veo. Ama-credits abuyiselwa ngokuzenzakalela uma kukhubazeka.

POST/api/media/speech/

Umbhalo-kuya-kwezwi. Ibuyela job_uuid; isingeniso siyi-URL yomsindo obhalwe ngesandla uma kuqediwe.

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

Umbuzo womsebenzi wokuthuthukisa: status, output_url, error, credits_cost.

POST/api/chat/share/

Dala isithonjana esifundeka kuphela esisemthethweni. Ibuyisela i /c/<slug> I-URL.

POST/api/chat/purge/

Cisha ukuxhumana kwakho, imilayezo, kanye nokusetshenziswa kwe-leadger yekhasimende-kwesobunxele.

I-Billing

Ukusetshenziswa kwe-API kusuka ku-credit pool efanayo ne-web app. Akukho zindleko ezihlukile ze-API.

Ukulinganisa nge-token ngayinye

Imodeli yombhalo ikhokhisa credits_per_1k_input × ama-token wokungena + credits_per_1k_output × i-output tokens. Amamodeli we-media akhokhisa i-flat credits_per_call.

Izindleko ezincane

Yonke inkulumo ephumelelayo ikhokhisa ama-credits angama-10 ukuze ibambe i-overhead, kungakhathaliseki inani le-token.

Ukubuyiselwa kwemali

Isithombe/ividiyo/imisebenzi yokukhuluma ehlulekile ukudlulisa ngokuzenzakalela ama-credits. Ukuhluleka kohlelo lokubhala kufaka i-bill kuphela okutholwe.

I-overdraft

Ucingo lubuyela emuva 402 insufficient_credits uma i-akhawunti yakho ingafinyeleli izindleko ezilinganiselwe. Ama-akhawunti angeke agwenywe uma plan_active ilungile futhi i-balance i positive.

Ukuqinisekisa nobumfihlo

I-token yomuntu ophethe — kumsebenzisi ngamunye, etholakala kukhasi le-akhawunti yakho. Jikelezisa ngokucima + ukubuyisela i-akhawunti yakho (ujikeleza ngokufanele indawo yokuqeda kwi-roadmap).
Akukho msebenzisi ophawulwe — sisebenzisana nabahlinzeki ngaphandle kwe-imeyili yakho, IP, umphathi womsebenzisi, noma i-ID ye-akhawunti. Generic HTTP-Referer: yout.chat kuphela.
no-log isiqondiso — ithunyelwe phezulu kwe-stream ukuze abahlinzeki bemodeli bacela ukuba bangabhalisi/baqeqeshe ku-prompts yakho lapho imikhankaso yabo ixhasa khona.
Akukho myalezo oqukethwe ogcinwe ngokuzenzakalela — sibhale UsageLedger umugqa (i-token + credits + model) kodwa hhayi umlayezo noma impendulo.

I-Roadmap

OpenAI-compatible /v1/chat/completions shim ukuze SDKs ezikhona zisebenze zingashintshwa
I-Webhook callbacks yemisebenzi yemidiya esebenza isikhathi eside (faka indawo yokuvota)
Ujikelezo lwe-token + izigaba ze-token ngayinye
Amakinombho we-Idempotency asebenzayo /stream/ + ukuhlela umsebenzi
Ukulawula umkhawulo wezinga lokusebenzela ngokwakho

Ukulungele ukuthutha?

Izinga elimahhala likunikeza ama-50K credits ukudlala. Yenza ushintsho uma ufuna okuningi.

Qala ngokukhululekileyo Bona ukuthengiselana okuzenzakalelayo