API

متوافق مع OpenAI. كل نموذج.

وجّه حزمة OpenAI SDK الحالية لديك إلى https://api.yout.chat/v1 باستخدام مفتاح Yout.chat الخاص بك وتصبح كل النماذج الكبرى ملكك. مجمّع رصيد واحد، فاتورة واحدة، بلا عقود لكل نموذج.

عنوان URL الأساسي: https://api.yout.chat/v1 · المصادقة: Authorization: Bearer <your-key>

بديل جاهز للاستبدال

إذا كان الكود الخاص بك يتواصل بالفعل مع OpenAI API، فما عليك سوى تغيير شيئين.

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/

مهمة توليد فيديو. ~1.2M رصيد لـ Veo بطول 5-second. يُعاد الرصيد تلقائياً عند الفشل.

POST/api/media/speech/

تحويل النص إلى كلام. تُعيد job_uuid; المخرجات هي عنوان URL صوتي موقّع بمجرد اكتمالها.

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

استطلاع مهمة توليد: status, output_url, error, credits_cost.

POST/api/chat/share/

أنشئ لقطة عامة للقراءة فقط. تُعيد عنوان /c/<slug> URL.

POST/api/chat/purge/

امسح محادثاتك ورسائلك وسجل الاستخدام من جانب الخادم.

الفوترة

يسحب استخدام API من مجمّع الرصيد نفسه الذي يستخدمه تطبيق الويب. لا توجد فوترة منفصلة لـ API.

التسعير لكل رمز

تتقاضى النماذج النصية credits_per_1k_input × رموز الإدخال + credits_per_1k_output × رموز الإخراج. تتقاضى نماذج الوسائط رسماً ثابتاً credits_per_call.

الحد الأدنى للرسوم

يخصم كل استدعاء ناجح 10 أرصدة على الأقل لتغطية التكاليف العامة، بغض النظر عن عدد الرموز.

استرداد عند الفشل

تستردّ مهام الصورة/الفيديو/الكلام التي تفشل في الجهة العليا الأرصدة تلقائياً. تُفوتر حالات فشل بث النص فقط على ما تم إنتاجه.

السحب على المكشوف

تُعيد الاستدعاءات 402 insufficient_credits عندما يعجز رصيدك عن تغطية التكلفة المقدّرة. لا تُقيّد سرعة الخطط طالما أن plan_active صحيح والرصيد موجب.

المصادقة & الخصوصية

  • رمز Bearer — لكل مستخدم، موجود في صفحة حسابك. يمكنك التدوير عبر حذف حسابك وإعادة إنشائه (نقطة نهاية تدوير مناسبة على خارطة الطريق).
  • لا تُمرّر أي معرّفات للمستخدم — نوجّه الطلبات إلى المزوّدين دون بريدك الإلكتروني أو عنوان IP أو وكيل المستخدم أو معرّف الحساب. عام HTTP-Referer: yout.chat فقط.
  • no-log إشارة — تُرسَل إلى الجهة العليا حتى يُطلب من مزوّدي النماذج عدم تسجيل مطالباتك أو التدرّب عليها حيثما تدعم عقودهم ذلك.
  • لا يُحفظ محتوى الرسائل افتراضياً — نكتب صفّ UsageLedger (رموز + أرصدة + نموذج) لكن ليس المطالبة أو الاستجابة.

خارطة الطريق

  • متوافق مع OpenAI /v1/chat/completions طبقة وسيطة لكي تعمل حِزم SDK الحالية دون تغيير
  • استدعاءات Webhook لمهام الوسائط طويلة الأمد (تحل محل الاستطلاع)
  • تدوير الرموز + نطاقات لكل رمز
  • مفاتيح عدم التكرار على /stream/ + إنشاء مهام آمن لإعادة المحاولة
  • أدوات تحكّم ذاتية في حدود المعدل

جاهز للإطلاق؟

تمنحك الطبقة المجانية 50K رصيد للتجربة. ارتقِ عندما تحتاج المزيد.