اسرد النماذج باستخدام GET /v1/models للعثور على معرّف النموذج الدقيق

يعيد كودك خطأ 404 على اسم نموذج بدا صحيحًا في مثال شخص آخر. اسأل الـ API نفسه: طلب GET واحد إلى https://api.cheaptokens.dev/v1/models يسرد النماذج التي يمكنك استدعاؤها، مع حدود السياق والإخراج الخاصة بها. انسخ المعرّف من تلك الإجابة، لا من الذاكرة، وتحقق من الحد قبل أن تضبط max_tokens.

تصف صفحة التوثيق (CheapTokens docs، تم التحقق في 28 أكتوبر 2026) GET /v1/models بأنها قائمة النماذج القابلة للاستدعاء مع حدود السياق والإخراج. وبجانبها يوجد GET /v1/models/{model} لنموذج واحد وGET /v1/capabilities. أما المحادثة نفسها فتمر عبر POST /v1/chat/completions (متوافق مع OpenAI) أو POST /v1/messages (متوافق مع Anthropic).

لماذا يملك النموذج نفسه معرّفًا مختلفًا في كل مكان#

لنفترض أنك وجدت درسًا تعليميًا لمزوّد آخر. يستخدم model: "deepseek-chat"، فتلصقه بجانب عنوان URL الأساسي لـ CheapTokens، ويفشل الطلب. لا شيء خطأ في مفتاحك. يسمّي المزوّدون النموذج نفسه بأسماء مختلفة: بادئة مثل deepseek-ai/، أو لاحقة إصدار مثل -0731، أو كتابة بحروف كبيرة مختلفة. لا يقبل الـ API إلا السلسلة الدقيقة التي يسردها، ولن يعمل أيضًا اسم قصير مأخوذ من تسمية سعرية.

هذا هو السبب الكامل للبحث عن المعرّف مرة واحدة. وإذا أردت القصة الكاملة لكيفية ظهور معرّف خاطئ على الشاشة، فإن API 401 or 404 error: wrong key, base URL or model id يستعرضها. هذا الدليل هو الخطوة السابقة: اعثر على المعرّف الصحيح حتى لا ترى ذلك الخطأ أبدًا.

اسأل الـ API: طلب واحد#

اختر التبويب الذي تستخدمه. كلاهما يرسل الطلب نفسه. في كلا المثالين يأتي المفتاح من متغير البيئة CHEAPTOKENS_API_KEY (المفتاح موجود في dashboard بمجرد توفر رصيد في الرصيد).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

تطبع نسخة Python الـ JSON الخام عن قصد. اقرأه مرة واحدة بعينيك: أنت تبحث عن معرّفات النماذج، وبجانبها حدود السياق والإخراج. انسخ كل معرّف من المخرجات كاملًا.

المعرّفات الثلاثة وحدودها#

تسرد التوثيق هذه النماذج القابلة للاستدعاء (تم التحقق في 28 أكتوبر 2026). أرسل السلسلة بتنسيق الكود في بداية كل سطر كـ model:

• zai-org/GLM-5.3-Flash — سياق 390K، حتى 8,192 رمز إخراج.
• deepseek-ai/DeepSeek-V4-Flash-0731 — سياق 380K، حتى 32,768 رمز إخراج.
• MiniMaxAI/MiniMax-M2.7 — سياق 180K، حتى 8,192 رمز إخراج.

رقمان يهمّان في معظم القرارات. السياق هو مقدار ما يمكن للنموذج استيعابه في طلب واحد، أي موجّهك وإجابته معًا. وحد الإخراج هو أطول إجابة واحدة. إذا كانت هذه الكلمات جديدة عليك، فإن how to read AI model names وwhy an answer stops mid-sentence يشرحانها بلغة بسيطة.

اختر نموذجًا أوليًا لمهمتك#

لا تحتاج إلى دراسة قياس مرجعي طويلة للبدء. سؤالان يحسمان معظم الخيارات الأولى: ما حجم مدخلاتك، وكم يجب أن تكون الإجابة طويلة؟ انقر على الحالة الأقرب إلى حالتك.

تشترك الثلاثة في رصيد واحد وسعر واحد في أي وقت من اليوم، دون ساعات ذروة، لذا فإن التبديل لاحقًا يكلفك سلسلة واحدة متغيرة. وبالمقارنة مع OpenRouter، فإن كل واحد من الثلاثة أرخص إجمالًا، مع احتساب الإدخال والإخراج معًا. إليك كيف يبدو عبء العمل: لنفترض أنك تشغّل مساعدًا صغيرًا يرسل 2,000 رمز إدخال ويستقبل 500 رمز، 1,000 مرة يوميًا. الجدول المباشر أدناه يسعّر ذلك بالضبط.

الأسعار الحالية لكل رمز لكل نموذج موجودة على pricing page، وmodel pages تتعمق في كل واحد منها. وإذا أردت مقارنة جنبًا إلى جنب حسب المهمة، فهناك GLM vs DeepSeek vs MiniMax: which model to choose.

اضبط max_tokens من الحد، ثم أرسل الطلب#

زلة شائعة: تطلب تقريرًا طويلًا من نموذج حده 8,192، فتتوقف الإجابة في منتصفها. الحد الذي رأيته في القائمة هو السقف لـ max_tokens. ابقَ عنده أو دونه.

إليك طلبًا بالمعرّف الكامل من القائمة. يطلب إجابة طويلة من النموذج الذي يسمح بذلك:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

جديد على أول استدعاء؟ Your first API request with CheapTokens يغطي تنسيق الإجابة وحقل usage.

لتثبيت الروتين، رتّب الخطوات:

إذا فشل الطلب رغم ذلك#

ابدأ بالسلسلة. معرّف نموذج يختلف بحرف واحد هو السبب المعتاد لخطأ 404، لذا الصقه مرة أخرى من القائمة بدلًا من إعادة كتابته. أما 402 فيعني أن الرصيد نفد، وحد المعدل هو 120 طلبًا في الدقيقة لكل مفتاح API. تعود الأخطاء بتنسيق JSON القياسي لـ OpenAI/Anthropic، لذا تحللها حزم SDK كالمعتاد. للاطلاع على الشرح الكامل، راجع API 401 or 404 error.

الـ API متوافق مع OpenAI وAnthropic عند https://api.cheaptokens.dev/v1؛ وتستخدم حزم SDK الخاصة بـ Anthropic وClaude Code عنوان URL الجذري https://api.cheaptokens.dev دون /v1. مزيد من تفاصيل الإعداد موجودة في docs.