النماذج

يأخذ الحقل model اسم النموذج الدقيق. والقائمة الكاملة مع الأسعار ودعم الذاكرة المؤقتة موجودة في صفحة الكتالوج.

• تستخدم المعرّفات vendor/model (بأسلوب OpenRouter)، مثل anthropic/claude-opus-5؛ ويُقبل claude-opus-5 كاسم بديل للمُدخل بفوترة مماثلة.
• يثبّت model:alias قناة واحدة، مثل openai/gpt-5.6-sol:yellow. ويسرد GET /v1/models معرّفًا واحدًا لكل نموذج؛ ويعيد ?variants=1 القائمة الكاملة.

معظم القنوات هي سجلات أسعار سوقية: يقدّم العديد من البائعين النموذج نفسه بأسعار مختلفة. يُنفَّذ طلبك عند أرخص عرض يقبله، وتُحتسب عليك تكلفة ذلك التنفيذ مضافًا إليها عمولتنا. لذلك يكون السعر لكل رمز نطاقًا لا رقمًا واحدًا — فهو يعتمد على الرتبة التي نُفِّذ منها الطلب.

ينشر GET /api/catalog و GET /v1/pricing ذلك النطاق لكل نموذج (pricing) ولكل قناة (channels[])، مأخوذًا من السلم نفسه الذي يخدمه GET /api/model-ladder?model=<model> مع أعداد عروضه.

"pricing": {
  "basis": "fill",
  "unit": "USD per 1M tokens",
  "priceFrom":    { "input": 0.465, "output": 2.325 },
  "priceTypical": { "input": 0.5,   "output": 2.5 },
  "priceTo":      { "input": 1.5,   "output": 7.5 },
  "minChargePerRequest": 0.0000125,
  "ladder": "/api/model-ladder?model=claude-opus-5.5",
  "ladderUpdatedAt": "2026-09-25T08:45:01.522Z",
  "ladderStale": false
},
"channels": [
  { "address": "claude-opus-5.5:claude-code", "isDefault": true,
    "inputUsd": 0.465, "outputUsd": 2.325,
    "basis": "fill", "pool": "cc/claude-opus-5-5",
    "priceFrom": { "input": 0.465, "output": 2.325 },
    "priceTypical": { "input": 0.5, "output": 2.5 },
    "priceTo": { "input": 1.5, "output": 7.5 },
    "maxPriceCeiling": { "input": 0.6, "output": 3 },
    "minChargePerRequest": 0.0000125 }
]

لمعظم النماذج عدة متغيّرات عامة. يُختار المتغيّر الافتراضي تلقائيًا (تتبع الأولوية إعدادات حسابك أو مفتاحك). لتثبيت متغيّر محدّد لطلب ما، أضِف اسمه المستعار بعد نقطتين إلى اسم النموذج:

"model": "gpt-6.1-sol"           // default variant (auto)
"model": "gpt-6.1-sol:yellow"    // explicit public variant
"model": "claude-opus-5.5"     // use an id from the catalog

طلب مثال بمتغيّر صريح:

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:yellow",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# :yellow — pin a public variant for this request

استخدم الأسماء المستعارة من الكتالوج فقط. اللواحق المتاحة:

يمكنك جلب القائمة الكاملة لمعرّفات النماذج المتاحة برمجيًا:

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

إلى جانب id/object/created/owned_by، يحمل كل مدخل type (chat، embedding، rerank، image، video، audio، music، 3d)، وarchitecture.input_modalities / output_modalities وendpoints — أي إلى أين يُرسَل الطلب لذلك النموذج.

• تحتوي القائمة الافتراضية على طُرز المحادثة والتضمين وإعادة الترتيب فقط، بحيث لا يعرض مُنتقي الطُرز في بيئة التطوير طُرازًا لا يدعم المحادثة.
• تُعرض نماذج الوسائط (صورة، فيديو، صوت، موسيقى، 3D) عند الطلب: ?type=image (أو قائمة: ?type=image,video)، ?output_modalities=image؛ و?modality= و?category= مرادفان لـ type.
• كل شيء دفعة واحدة: ?all=true أو ?type=all أو GET /v1/models/all. وتُدرج الوسائط مع متغيّراتها (model:alias) — وهو بالضبط المعرّف الذي يجب إرساله.
• يعيد GET /v1/models/{id} نموذجًا واحدًا؛ وأي معرّف غير معروف يُنتج 404 مع code: "model_not_found".

curl "https://getvibeapi.com/v1/models?type=image,video" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

يُنشر كل نموذج يُضاف إلى الكتالوج، وكذلك منشوراتنا عن المستجدات، في موجز مفتوح — من دون الحاجة إلى مفتاح. اقرأه باستخدام قارئ RSS أو وكيل، ليتمكن الوكيل من تغيير نهجه مع تغيّر النماذج. يحتفظ الموجز بالسجل الكامل، صفحةً بصفحة، ويتضمن كل حدث ما يحتاج إليه الوكيل لاستدعاء النموذج فورًا.

• /rss.xml (واسمه البديل /feed.xml) بتنسيق RSS 2.0؛ أما /feed.json فبتنسيق JSON Feed 1.1 مع كتلة _meta على مستوى الموجز وكتلة _catalog لكل حدث.
• الصفحات: 50 حدثًا لكل صفحة، و?limit= حتى 100، بدءًا بالأحدث. الصفحة التالية (الأقدم) هي next_url في JSON Feed و<atom:link rel="next"> في RSS (وفق RFC 5005، مع rel="first" وrel="previous" أيضًا). تتضمن الروابط مؤشرًا، لذا فإن نشر نموذج أثناء تنقّلك بين الصفحات لا يغيّر موضع أي حدث سبق أن قرأته. استخدم الروابط كما تُعاد.
• عوامل التصفية: ?kind=text|image|video|audio|music|3d|news و?since=YYYY-MM-DD — تقتصر النتائج على الأحداث بدءًا من ذلك اليوم بتوقيت UTC، بما فيه ذلك اليوم. تعمل عوامل التصفية مع تقسيم النتائج إلى صفحات، وتُحتفظ بها في الروابط.
• يتضمن حدث model_added العنوان، وتاريخ ظهور النموذج في الكتالوج، ورابطًا إلى صفحة النموذج، ووصفًا، ويتضمن في _catalog: المعرّفات العامة التي تُرسل بوصفها model (من دون صيغ مسارات :alias ومن دون أسماء المورّدين)، ونقاط النهاية، وأنماط الإدخال والإخراج، ونافذة السياق والحد الأقصى للإخراج، والقدرات (الأدوات، وJSON / الإخراج المنظّم، والرؤية، والاستدلال ومستوياته، والتخزين المؤقت)، والسعر المبدئي المعلن بعملة USD مع وحدته، وللوسائط كل معلمة طلب مع قيمها المسموح بها، وطلبًا جاهزًا (curl وJSON)، ورابطًا إلى الوثائق. أما حدث news فهو منشور عن المستجدات.
• لا يتغير guid الخاص بالحدث مطلقًا. لا يتضمن الموجز نتائج إنشاء مسجلة، بل يتضمن طلبًا نموذجيًا فقط.
• استطلع التحديثات مرة كل بضع دقائق على الأكثر: لكل صفحة ETag وLast-Modified خاصان بها؛ أرسل If-None-Match / If-Modified-Since، وستستجيب الصفحة التي لم تتغير بالرمز 304 من دون جسم استجابة. لجلب المستجدات فقط، احتفظ بتاريخ آخر حدث عالجته واطلب ?since= باستخدامه.

curl -sS "https://getvibeapi.com/feed.json?since=2026-10-01&limit=100"
curl -sS -i https://getvibeapi.com/feed.json -H 'If-None-Match: "<ETag from the previous response>"'   # -> 304