أول طلب إلى واجهة API متوافقة مع OpenAI في Postman

لديك مفتاح API وتريد أن ترى ما يمر فعليًا عبر الشبكة قبل أن تكتب سطرًا واحدًا من الكود. Postman مناسب تمامًا لذلك: تملأ عنوان URL ومفتاحًا وجسم JSON، وتضغط Send، فتظهر الإجابة أسفل النموذج مباشرة. بالنسبة إلى CheapTokens يكون الطلب POST https://api.cheaptokens.dev/v1/chat/completions مع مفتاح Authorization: Bearer وجسم JSON يحدد اسم النموذج.

تتبع الخطوات أدناه وثائق Postman الرسمية (الإصدار v12، أحدث إصدار على موقع الوثائق، تم التحقق منه في 31 أكتوبر 2026). إذا كنت تفضل الطرفية، فالطلب نفسه موجود في طلبك الأول لواجهة API مع CheapTokens.

جهّزه في أربع خطوات#

تحتاج فقط إلى بضعة أشياء: عنوان URL الأساسي، ومفتاحك، ومعرّف النموذج، ورسالة واحدة. يحتفظ Postman بالأولين في متغيرات، لذا لا يُلصق المفتاح في الطلب نفسه أبدًا.

بعض التفاصيل لكل خطوة.

أنشئ الطلب. انقر أيقونة Add في الشريط الجانبي الأيسر واختر HTTP. تكون القائمة المنسدلة للطريقة مضبوطة افتراضيًا على GET، فبدّلها إلى POST وأدخل عنوان URL. تُكتب متغيرات Postman بالشكل {{variable_name}}؛ وتستخدم الوثائق {{base_url}} كمثال. عرّف base_url كـ https://api.cheaptokens.dev/v1 فيصبح حقل URL هو {{base_url}}/chat/completions. يخزّن Postman المتغيرات كنصوص، وهذا مناسب هنا.

أضف المفتاح. افتح تبويب Authorization، واختر Bearer Token في القائمة المنسدلة Auth Type، وضع {{api_key}} في حقل Token. يرسله Postman كترويسة Authorization بصيغة Bearer. توصي الوثائق بهذا تحديدًا: احتفظ بالرمز في متغير وأشِر إليه بالاسم. ولماذا تهم هذه العادة، تجده في تخزين مفتاح API بأمان.

اكتب الجسم. في تبويب Body اختر raw، ثم JSON في القائمة المنسدلة. بالنسبة إلى الأجسام الخام يضبط Postman ترويسة Content-Type المطابقة بنفسه، لذا لا تضيفها أنت. الصق هذا:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

معرّف النموذج هو gateway_id الكامل من وثائق CheapTokens؛ ولا يُقبل اسم مختصر مثل deepseek-flash. يحدّ max_tokens من طول الإجابة، لذا لا يمكن أن يطول الاختبار الأول. تفصيل آخر في Postman: تُزال تعليقات // و /* */ في جسم JSON قبل الإرسال، فيمكنك إضافة ملاحظات على الجسم لزميلك.

اضغط Send واقرأ الاستجابة#

إذا كان كل شيء صحيحًا، يعرض جزء الاستجابة كائن JSON بصيغة OpenAI Chat Completions. موضعان مهمان:

• choices[0].message.content هو نص الإجابة.
• usage يحتوي على prompt_tokens (ما أرسلته) و completion_tokens (ما كتبه النموذج). هذا ما تُحاسَب عليه، فانظر إليه في الطلب الأول نفسه.

تحقق أيضًا من choices[0].finish_reason. تعني stop أن النموذج أنهى من تلقاء نفسه؛ وتعني length أن الإجابة بلغت max_tokens وقُطعت. إذا رأيت ذلك، فارفع الحد أو اقرأ هل قُطعت إجابة الذكاء الاصطناعي؟ إصلاح finish_reason "length".

جرّبه قبل أن تفتح الإجابة:

كم يكلّف الطلب الأول#

لنفترض أن الطلب أعلاه يستخدم نحو 30 رمزًا للإدخال وأن الإجابة تستهلك نحو 100 رمز للإخراج (مثال وليس قياسًا؛ حقل usage لديك يعرض الأرقام الحقيقية). على DeepSeek-V4-Flash يكون ذلك $0.00001 بالسعر الحالي، والسعر نفسه في أي ساعة. الأسعار لكل مليون رمز موجودة في الجدول المباشر على صفحة الأسعار.

يمكن لطلب Postman نفسه تجربة نموذج آخر. استبدل سطر model فقط، مثلًا بـ zai-org/GLM-5.3-Flash (سياق 390K، وحتى 8,192 رمز إخراج)، واضغط Send مرة أخرى. رصيد واحد يغطي جميع النماذج، فلا يتغير شيء آخر: نفس URL، ونفس المفتاح.

إذا لم يعمل#

يعرض Postman رمز الحالة بجانب الاستجابة. هذه هي الأسباب المعتادة:

هناك أمران خاصان بـ Postman يستحقان التحقق. إذا حصلت على 401 أو بدا عنوان URL خاطئًا، فتحقق من أن base_url و api_key معرّفان في البيئة التي اخترتها. وإذا بدا المفتاح صحيحًا لكنك ما زلت تحصل على 401، فافتح تبويب Authorization مرة أخرى: يجب أن يكون Auth Type هو Bearer Token وليس No Auth. المزيد عن هذه الرموز: خطأ API 401 أو 404. لست متأكدًا من المعرّف الذي تستخدمه؟ اعرض النماذج باستخدام GET /v1/models يعيدها جميعًا.

عندما ترضى عنه، اضغط Save، وأعطِ الطلب اسمًا واختر مجموعة. في المرة القادمة تعدّل حقل content فقط، أو سطر model لمقارنة الإجابات. المرجع الكامل لواجهة API موجود في وثائق CheapTokens.