المظهر
اللغة

مرجع API — كل نقاط النهاية

القائمة الكاملة لنقاط نهاية GetVibe API مع الطريقة والمسار والوصف ونوع المصادقة. النقاط مجمّعة حسب الفئة. عنوان الأساس لـ/v1/* هو https://getvibeapi.com/v1؛ ولـ/api/* هو https://getvibeapi.com.

يتوفر مواصفة OpenAPI 3.0 قابلة للقراءة آليًا على /api/openapi — استوردها في Postman أو Swagger UI أو أي أداة متوافقة مع OpenAPI.
الكتالوجات العامة /api/catalog و/api/media-catalog متاحة دون مفتاح — استخدمها لواجهات المتاجر وحسابات الأسعار واكتشاف النماذج قبل التسجيل.

المحادثة والإكمالات

الطريقةالنقطة الطرفيةالوصفالمصادقة
POST/v1/chat/completionsنقطة نهاية دردشة متوافقة مع OpenAI.Bearer
POST/v1/messagesنقطة نهاية بصيغة Anthropic Messages. المسار الخاص بـ Claude Code وAnthropic SDK.x-api-key / Bearer
POST/v1/responses‏OpenAI Responses API. المسار الخاص بـ Codex CLI (wire_api = "responses").Bearer
POST/v1/messages/count_tokensنقطة نهاية تجريبية لعدّ الرموز خاصة بـ Anthropic SDK / Claude Code (تقدير، وليس مُرمِّزًا دقيقًا).x-api-key / Bearer

النماذج والأسعار

الطريقةالنقطة الطرفيةالوصفالمصادقة
GET/v1/modelsالنماذج المتاحة مع النوع والوسائط ونقاط النهاية. الوسائط عند الطلب: ?type=image أو ?all=true أو /v1/models/all؛ ونموذج واحد: /v1/models/{id}.Bearer
GET/v1/pricingالمصدر البرمجي المعياري للأسعار لنماذج النصوص، بما في ذلك التجاوزات المباشرة من المشغّل.Bearer
POST/v1/embeddingsتضمينات النصوص لأغراض البحث وRAG والعنقدة.Bearer
POST/v1/decisionsقيّم أسئلة محدّدة بالاسم مقابل حالة (نص->قرارات). ليست نقطة طرفية للمحادثة؛ وتُفوتر على رموز الإدخال فقط.Bearer

الوسائط

الطريقةالنقطة الطرفيةالوصفالمصادقة
POST/api/media/generateتوليد الوسائط غير المتزامن (صورة/فيديو/صوت/موسيقى/3d). يعيد jobId لتتبّع الحالة.Bearer
GET/api/media/jobs/{id}استعلم عن حالة مهمة توليد وسائط غير متزامنة.Bearer
GET/api/media/file/{id}/{idx}رابط وكيل موقّع لنتيجة (HMAC في وسيط الاستعلام sig). بدون مفتاح — للتضمين في <img>/<video>.sig (HMAC)
GET/api/media-catalogالفهرس العام لنماذج الوسائط: النوع، المتغيرات، المعاملات، fromRub، المحاور.public

الفوترة والاستخدام

الطريقةالنقطة الطرفيةالوصفالمصادقة
GET/v1/balanceالرصيد المدفوع مسبقًا المتبقي بالدولار الأمريكي.Bearer
GET/v1/generationsسجلّ الاستخدام مع route / address_as (المسار العام) وrequest_id والترقيم الصفحي.Bearer
GET/v1/generations/{id}مدخل واحد من سجل الاستخدام بالمعرّف (من استجابة /v1/generations أو الترويسة x-pv-generation-id).Bearer
GET/v1/usageإحصاءات استخدام لكل مفتاح مع حقلي route و address_as.Bearer
GET/api/key/usageملخص لكل مفتاح: الرصيد، وإنفاق اليوم/الشهر، وعدد الطلبات.Bearer / x-api-key

التوجيه

الطريقةالنقطة الطرفيةالوصفالمصادقة
ANYx-getvibe-route / x-getvibe-modelترويسات الاستجابة لعملاء الكشف/التصحيح الموثوقين فقط: الحقلان العامان :alias و address_as للمسار الفائز.response headers

المقامات

الطريقةالنقطة الطرفيةالوصفالمصادقة
GET/v1/keysقائمة مفاتيح API الخاصة بالحساب.Bearer
POST/v1/keysغير متاح عبر API. أنشئ المفاتيح وأدرها في لوحة التحكم فقط (قسم Keys).— (UI only)

الدعم

الطريقةالنقطة الطرفيةالوصفالمصادقة
POST/v1/ticketsافتح تذكرة دعم (JSON أو multipart مع لقطات شاشة). مفتاح API أو جلسة لوحة التحكم.Bearer
GET/v1/ticketsاعرض تذاكرك، الأحدث أولًا، مع ترقيم مؤشر (cursor).Bearer
GET/v1/tickets/{id}حالة التذكرة والمحادثة الكاملة مع ردود الدعم.Bearer
POST/v1/tickets/{id}/messagesأضف رسالة متابعة إلى تذكرتك.Bearer
POST/v1/tickets/{id}/closeأغلق تذكرتك.Bearer
POST/v1/technical-feedbackاسم بديل قديم لـ POST /v1/tickets للتقارير الفنية؛ بالحقول نفسها كما في السابق.Bearer

الـ webhooks

الطريقةالنقطة الطرفيةالوصفالمصادقة
GET/api/webhooksعناوين Webhook الحالية (mediaWebhookUrl، balanceWebhookUrl). لجلسة لوحة التحكم فقط.session (dashboard)
PATCH/api/webhooksعيّن أو امسح mediaWebhookUrl / balanceWebhookUrl. جلسة لوحة التحكم فقط.session (dashboard)

الفهارس العامة

الطريقةالنقطة الطرفيةالوصفالمصادقة
GET/api/catalogالفهرس العام لنماذج النصوص (دون مصادقة). يستخدمه الموقع لواجهة المتجر.public
GET/api/media-catalogالفهرس العام لنماذج الوسائط (الأنواع، الأسعار لكل وحدة، المعاملات، المحاور).public
← البدء السريعإكمالات المحادثة ←
مرجع API — كل نقاط النهاية | GetVibe API