API

OpenAI-rekin bateragarria, modelo guztietan.

Zure lehendik dagoen OpenAI SDK hona zuzendu https://api.yout.chat/v1 Zure Yout.chat gakoarekin eta modelo nagusi guztiak zureak dira. Kreditu-biltegi bat, faktura bat, modelo bakoitzeko kontraturik ez.

Oinarrizko URLa: https://api.yout.chat/v1 · Autentifikazioa: Authorization: Bearer <your-key>

Ordezkaritza goitibeherakoa

OpenAI API-arekin hitz egiten baduzu, bi gauza bakarrik aldatu behar dituzu.

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)

Aldatu gabe dago OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, eta OpenAI forma duen beste edozein gauza.

Amaierako puntuak

Amaierako puntu guztiek onartzen dute Authorization: Bearer <key>. Saioko cookie-ek web aplikazioan funtzionatzen dute.

POST/v1/chat/completions

OpenAI-compatible. Pasatu stream: true SSE-ren kreditu-kontua. Kredituak atomikoki debitatu dira.

Eskaera-gorputzak
{
  "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
}
Erantzuna (ez-korrontea)
{
  "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-rekin bateragarri diren modeloen zerrenda. Honako modelo aktibo guztiak: id, context_window, eta token bakoitzeko kreditu-kostua.

POST/api/chat/stream/

Korrontearen amaiera-puntua natiboa — JSON forma sinpleagoa OpenAI baino, web aplikazioak erabiltzen du. Prefer /v1/chat/completions hirugarrenen SDK bateragarritasuna.

GET/api/chat/models/

Ereduen katalogo aberatsagoa zereginen etiketekin, modalitateekin, pro- soilik banderarekin. Erabili hau zure UIan.

GET/api/chat/limit/

Zure uneko kuotak - kreditu-balantzea + planaren egoera, edo anon eguneko ordainsaria.

GET/api/chat/keys/

API gako aktiboak zerrendatzen ditu (maskaratuta).

POST/api/chat/keys/

Sortu API gako izendatua. Token osoa behin itzultzen da - gorde.

Eskaera-gorputzak
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

Gako bat errebokatzea. Gakoa erabiltzen duten lehendik dauden saioek 401 hurrengo deian.

POST/api/media/image/

Irudiaren sorrera-lana. Itzuli job_uuid; zulo /api/media/jobs/<uuid>/.

POST/api/media/video/

Bideoa sortzea. ~1.2M kreditu 5 segundoko Veo-rako. Kredituak automatikoki itzuliko dira huts egiten badute.

POST/api/media/speech/

Testu-hizketa. Itzuli job_uuid; irteera audio-URL sinatu bat da, amaitzean.

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

Sortze-lan bat galdekatu: status, output_url, error, credits_cost.

POST/api/chat/share/

Sortu irakurtzeko soilik den snapshot publiko bat. /c/<slug> URLa.

POST/api/chat/purge/

Ezabatu zure solasaldiak, mezuak eta erabilera-liburutegia zerbitzari-aldetik.

Fakturazio-zerbitzua

APIaren erabilera web aplikazioaren kreditu-multzo berberatik ateratzen da. Ez dago APIaren fakturazio bereizirik.

Token bakoitzeko prezioa

Testu-modeloak kargatzen credits_per_1k_input × sarrerako tokenak + credits_per_1k_output × irteerako tokenak. Multimedia modeloek kostu finkoa kobratzen dute credits_per_call.

Gutxieneko karga

100

Hutsegitearen itzulketa

Igoeran huts egiten duten irudi/bideo/hizketa-lanek automatikoki itzultzen dituzte kredituak. Testu-korrontearen huts-egoerek soilik ekoiztua izan dena fakturatzen dute.

Gainkarga

Deiak itzultzen 402 insufficient_credits zure balantzeak estimatutako kostua estali ezin duenean. Planak ez dira murrizten plan_active egiazkoa da eta balantzea positiboa da.

Autentifikazioa eta pribatutasuna

  • Token eramantzailea — erabiltzaile bakoitzeko, zure Kontuaren orrian aurkitzen da. Biratu ezabatuz + zure kontua berriro sortuz (biratu amaiera-puntua bide-orriaren bidez).
  • Ez da erabiltzaile-identifikatzailerik birbidali — zure posta elektronikoa, IPa, erabiltzaile-agentea edo kontu-IDa gabe proxy-a eskaintzen diegu hornitzaileei. Generikoa HTTP-Referer: yout.chat bakarrik.
  • no-log seinalea — goi-mailakoa bidali da, modelo-hornitzaileei eskatu zaielako ez saioa hastea/entrenatzea zure eskaeretan, haien kontratuek hori onartzen badute.
  • Mezu-edukirik ez da lehenespenez iraungitzen — idazten dugu UsageLedger errenkada (token + kreditu + modeloa), baina ez galdera edo erantzuna.

Bide-orria

  • OpenAI-rekin bateragarria /v1/chat/completions shim, lehendik dauden SDKek aldatu gabe funtziona dezaten
  • Webhook-en atzera-deiak exekutatzen ari diren multimedia-lanak (hautaketa ordezkatu)
  • Token biraketa + token bakoitzeko eremuak
  • Idempotentzia-teklak aktibatuta /stream/ + saiatu berriro lanaren sorrera segurua
  • Autozerbitzu-abiadura-mugaren kontrolak

Bidaiatzeko prest?

Libreko maila 50K kreditu ematen dizkizu jolasteko. Goratu gehiago behar duzunean.