API

سازگار با OpenAI. هر مدلی.

SDK موجود OpenAI خود را به https://api.yout.chat/v1 با کلید Yout.chat خود نشانه‌گذاری کنید و هر مدل بزرگی از آن شماست. یک منبع اعتبار، یک صورتحساب، بدون قراردادهای جداگانه برای هر مدل.

آدرس پایه: https://api.yout.chat/v1 · احراز هویت: Authorization: Bearer <your-key>

جایگزین بدون تغییر

اگر کد شما از قبل با API OpenAI صحبت می‌کند، فقط دو چیز را تغییر می‌دهید.

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)

بدون تغییر با OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, و هر چیز دیگری که از ساختار OpenAI پیروی می‌کند کار می‌کند.

اندپوینت‌ها

همه اندپوینت‌ها این را می‌پذیرند Authorization: Bearer <key>. کوکی‌های نشست برای برنامه وب کار می‌کنند.

POST/v1/chat/completions

سازگار با OpenAI. ارسال کنید stream: true برای SSE. اعتبار به صورت اتمیک کسر می‌شود.

بدنه درخواست
{
  "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
}
پاسخ (بدون استریم)
{
  "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. هر مدل فعال با id, context_window, و هزینه اعتبار به ازای هر توکن.

POST/api/chat/stream/

اندپوینت استریم بومی — ساختار JSON ساده‌تر از OpenAI، که توسط برنامه وب استفاده می‌شود. ترجیح دهید /v1/chat/completions برای سازگاری با SDKهای شخص ثالث.

GET/api/chat/models/

فهرست غنی‌تر مدل‌ها همراه با برچسب‌های وظیفه، نوع رسانه و نشانه فقط حرفه‌ای. این را در رابط کاربری خود استفاده کنید.

GET/api/chat/limit/

سهمیه فعلی شما — موجودی اعتبار + وضعیت پلن، یا سهمیه روزانه ناشناس.

GET/api/chat/keys/

فهرست کلیدهای API فعال شما (پنهان‌شده).

POST/api/chat/keys/

ساخت یک کلید API نام‌گذاری‌شده. توکن کامل یک بار بازگردانده می‌شود — آن را ذخیره کنید.

بدنه درخواست
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

ابطال یک کلید. نشست‌های موجودی که از آن استفاده می‌کنند این را دریافت می‌کنند 401 در فراخوانی بعدی.

POST/api/media/image/

کار تولید تصویر. بازمی‌گرداند job_uuid; نظرسنجی /api/media/jobs/<uuid>/.

POST/api/media/video/

کار تولید ویدیو. حدود ۱.۲M اعتبار برای Veo ۵ ثانیه‌ای. در صورت شکست، اعتبار به طور خودکار بازپرداخت می‌شود.

POST/api/media/speech/

تبدیل متن به گفتار. بازمی‌گرداند job_uuid; خروجی پس از تکمیل یک آدرس صوتی امضاشده است.

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

نظرسنجی یک کار تولید: status, output_url, error, credits_cost.

POST/api/chat/share/

ساخت یک تصویر لحظه‌ای عمومی فقط‌خواندنی. بازمی‌گرداند یک /c/<slug> آدرس.

POST/api/chat/purge/

پاک کردن مکالمات، پیام‌ها و دفتر مصرف شما در سمت سرور.

صورتحساب

مصرف API از همان منبع اعتبار برنامه وب کسر می‌شود. صورتحساب جداگانه‌ای برای API وجود ندارد.

قیمت‌گذاری به ازای هر توکن

مدل‌های متنی هزینه می‌گیرند credits_per_1k_input × توکن‌های ورودی + credits_per_1k_output × توکن‌های خروجی. مدل‌های رسانه‌ای یک هزینه ثابت می‌گیرند credits_per_call.

حداقل هزینه

هر فراخوانی موفق دست‌کم ۱۰ اعتبار برای پوشش هزینه‌های جانبی کسر می‌کند، صرف‌نظر از تعداد توکن‌ها.

بازپرداخت در صورت شکست

کارهای تصویر/ویدیو/گفتار که در سمت ارائه‌دهنده شکست می‌خورند به طور خودکار اعتبار را بازپرداخت می‌کنند. شکست استریم متن فقط بابت آنچه تولید شده هزینه می‌گیرد.

کسری موجودی

فراخوانی‌ها این را بازمی‌گردانند 402 insufficient_credits زمانی که موجودی شما نمی‌تواند هزینه برآوردشده را پوشش دهد. تا زمانی که plan_active درست باشد و موجودی مثبت باشد، پلن‌ها محدود نمی‌شوند.

احراز هویت & حریم خصوصی

  • توکن Bearer — به ازای هر کاربر، در صفحه حساب شما یافت می‌شود. با حذف + بازسازی حساب خود، آن را بچرخانید (اندپوینت چرخش مناسب در نقشه راه است).
  • هیچ شناسه کاربری ارسال نمی‌شود — ما بدون ایمیل، IP، عامل کاربر یا شناسه حساب شما به ارائه‌دهندگان پراکسی می‌کنیم. فقط یک HTTP-Referer: yout.chat عمومی.
  • no-log سیگنال — به بالادست ارسال می‌شود تا از ارائه‌دهندگان مدل خواسته شود در جایی که قراردادهایشان اجازه می‌دهد، پرامپت‌های شما را ثبت یا روی آن‌ها آموزش ندهند.
  • به طور پیش‌فرض هیچ محتوای پیامی ذخیره نمی‌شود — ما یک UsageLedger ردیف (توکن‌ها + اعتبار + مدل) می‌نویسیم اما نه پرامپت یا پاسخ را.

نقشه راه

  • سازگار با OpenAI /v1/chat/completions لایه میانی تا SDKهای موجود بدون تغییر کار کنند
  • فراخوانی‌های وب‌هوک برای کارهای رسانه‌ای طولانی‌مدت (جایگزین نظرسنجی)
  • چرخش توکن + محدوده‌های دسترسی به ازای هر توکن
  • کلیدهای ایدمپوتنسی روی /stream/ + ساخت کار ایمن در برابر تلاش مجدد
  • کنترل‌های خودخدمت محدودیت نرخ

آماده انتشار هستید؟

سطح رایگان ۵۰K اعتبار برای آزمایش به شما می‌دهد. هر زمان به بیشتر نیاز داشتید ارتقا دهید.