API

OpenAI-la jaanqaadayo. mid kasta oo qaab.

Tilmaamkaaga hadda jira OpenAI SDK at https://api.yout.chat/v1 la Yout.chat furaha iyo mid kasta oo ka mid ah qaabka weyn waa adiga. Mid credit pool, bill, ma per-model heshiisyada.

URL-ka asalka ah: https://api.yout.chat/v1 · A_uth: Authorization: Bearer <your-key>

Ku soo biir si aad u hesho furaha U gudub koodka

bedelka

Haddii code aad horey u hadlaya OpenAI API, waxaad kaliya u beddeli kartaa laba wax.

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

Shaqada aan la beddelin OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, iyo wax kasta oo kale oo ku hadla qaabka OpenAI.

Dhammaan

Dhammaan xadka u dhaafka aqbala Authorization: Bearer <key>. Kukiyada muddada shaqada ee web app.

POST/v1/chat/completions

OpenAI-la jaanqaada. Guji stream: true SSE. Credits debited atomically.

Qoyska codsiga

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

Jawaab (aan-wax-bixin)

{
  "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-la jaanqaadayo liiska qaabka. Mid kasta oo ka mid ah qaabka hawlgalka la id, context_window, iyo per-token qiimaha credit.

POST/api/chat/stream/

Native streaming endpoint — qaabka JSON fudud ka badan OpenAI, waxaa loo isticmaalaa by web app. /v1/chat/completions si ay u dhinac saddexaad SDK la jaanqaadayo.

GET/api/chat/models/

Richer qaabka catalog la tags shaqada, habka, pro-oo kaliya flag. U isticmaalkan aad UI.

GET/api/chat/limit/

Qiimahaada hadda jira — credits miisaaniyadda + xaaladda qorshaha, ama anon maalin kasta.

GET/api/chat/keys/

Liiska aad furaha API hawlgalka (mask).

POST/api/chat/keys/

abuuro API key magaciisa. Full token waa la soo celiyey mar - kaydinta.

Qoyska codsiga

{"name": "production"}

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

Dib u dhig astaanta. Kulanka hadda jira oo isticmaalaya in ay helaan 401 ee codsiga soo socda.

POST/api/media/image/

Shaqada abuurista sawirka. job_uuid; god /api/media/jobs/<uuid>/.

POST/api/media/video/

Video abuurista shaqada. ~ 1.2M credits for 5-second Veo. Credits auto-soo celinta ku guul darreysatay.

POST/api/media/speech/

Qoraalka-u-hadalka. job_uuid; soosaarka waa URL audio la saxiixay mar la dhammeeyo.

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

Dooro shaqo abuur: status, output_url, error, credits_cost.

POST/api/chat/share/

abuuro dadweynaha akhriska oo keliya snapshot. /c/<slug> URL-ka

POST/api/chat/purge/

Ka saar wada hadaladaada, fariimaha, iyo isticmaalka server-xagga leh.

Biil

API isticmaalka ka soo qaadaa isku credit pool sida web app. No kala duwan API billing.

Qiimaha per-token

Qoraalka qaababku waxay ku xadgudbaan credits_per_1k_input × calaamadaha soo-gaadhista + credits_per_1k_output × soo saarka tokens. Media qaabab ku caddaan oo siman credits_per_call.

Qiimaha ugu yar

Dhammaan codka guulaysta debits ugu yaraan 10 credits in ay ka buuxaan overhead, xitaa marka la eego tirada token.

Ku fashilmaan

Image / video / hadalka shaqooyinka oo ku fashilmaan upstream si otomaatig ah credits dib u soo celiyo.

Kaarka

Dhagaxyada soo noqnoqda 402 insufficient_credits marka aad miisaaniyada ma dabooli karaan qiimaha la saadaaliyay. Qorshaha ma aha in la xoqo inta plan_active waa run oo miisaanku waa wanaagsan yahay.

Aaminka iyo xasaasiyadda

Tallaabada — per user, laga helay boggaaga Account. Jiid by tirtirka + dib u abuurista xisaabtaada (ku habboon jiid endpoint on roadmap).
Ma jiro aqoonsi isticmaale oo la gudbiyay — waxaan proxy si ay bixiyaha aan email, IP, user agent, ama ID xisaabta. Generic HTTP-Referer: yout.chat kaliya.
no-log calaamad — waxaa loo diray upstream si ay u bixiyaha qaabka waxaa la weydiiyay in aanay log / tababarka ku saabsan farriimaha aad halkaas oo heshiisyadooda taageeraan.
Waxyaabaha ku jira fariinta lama sii haysto si caadi ah — waxaannu ku qornaa UsageLedger row (token + credits + qaabka) laakiin ma aha in la weydiiyo ama jawaabta.

Qorshaha Waddo

OpenAI- la jaanqaada /v1/chat/completions shim si SDKs hadda jira shaqada aan la beddelin
Webhook callbacks si ay u shaqo warbaahinta dheer socda (ku bedelan doorasho)
Token wareegga + per-token scope
Buugaag la soo dejiyey /stream/ + abuurista shaqo retry-safe
Isku-dhafka xadka

Ku diyaarsan tahay inaad safarto?

Free tier kuu siinaysaa 50K credits in ay ciyaaraan la. Kor u qaad marka aad u baahan tahay in ka badan.

Bilaw bilaash ah Ka eeg qiimaha