أول طلب API في VS Code: ملف .http، والمفتاح من .env

يمكنك إرسال طلبك الأول إلى CheapTokens دون مغادرة VS Code: ثبّت إضافة REST Client، واكتب ملف .http، واحتفظ بالمفتاح في .env بجانبه واضغط Ctrl+Alt+R. تُفتح الإجابة في لوحة بجانب الملف، والنص وعدد الرموز حقلان يمكنك العثور عليهما بنظرة واحدة.

إذا كان لديك محرر مفتوح بالفعل، فهذا أفضل من تثبيت تطبيق آخر فقط لتقول "Hello" لنموذج. ويبقى الطلب في ملف نصي عادي، فيمكنك إعادة تشغيله غدًا أو إيداعه (بدون المفتاح) لزميل. الطرق الأخرى لإرسال الطلب نفسه موجودة في First request with HTTPie وYour first API request with CheapTokens.

ثبّت الإضافة وضع المفتاح في .env#

REST Client هي الإضافة humao.rest-client. في VS Code اضغط F1، واكتب ext install، وابحث عن rest-client وثبّتها. (تم التحقق مقابل README الخاص بالإضافة في 9 نوفمبر 2026.)

الآن المفتاح. يصف README {{$dotenv NAME}}: يقرأ قيمة من ملف .env موجود في المجلد نفسه الذي يحتوي على ملف .http الخاص بك. هذا بالضبط ما نريده، لأن المفتاح لا يظهر أبدًا في ملف الطلب. أنشئ مجلدًا للتجربة وضع فيه ملفين.

.env:

CHEAPTOKENS_API_KEY=paste-your-key-here

.gitignore:

.env

أنشئ المفتاح في حسابك على CheapTokens والصقه بدلًا من العنصر النائب. سبب أهمية سطر التجاهل، وما يجب فعله إذا وقع مفتاح في إيداع، موجود في Store an API key safely.

اكتب ملف .http#

أنشئ first.http في المجلد نفسه. الصيغة قصيرة: سطر طلب (POST URL HTTP/1.1، الطريقة اختيارية وتكون GET افتراضيًا)، وأسطر ترويسات Name: value حتى أول سطر فارغ، ثم الجسم بعد سطر فارغ. تُفصل الطلبات بسطر من ثلاثة # أو أكثر.

### First request
POST https://api.cheaptokens.dev/v1/chat/completions
Authorization: Bearer {{$dotenv CHEAPTOKENS_API_KEY}}
Content-Type: application/json

{
  "model": "zai-org/GLM-5.3-Flash",
  "messages": [{ "role": "user", "content": "Hello" }]
}

ثلاثة أمور تستحق الانتباه. العنوان هو قاعدة واجهة CheapTokens، https://api.cheaptokens.dev/v1، زائد /chat/completions. والنموذج مكتوب بمعرّفه الكامل، zai-org/GLM-5.3-Flash: نموذج بسياق 390K يمكنه كتابة حتى 8,192 رمزًا لكل إجابة. والمفتاح مجرد عنصر نائب {{$dotenv …}}، لذا فإن إيداع هذا الملف آمن.

إذا لم يلتقط إعدادك ملف .env، يصف README أيضًا {{$processEnv NAME}}، الذي يقرأ متغيرًا من بيئة جهازك بدلًا من ذلك.

أرسله واعثر على الإجابة#

انقر "Send Request" فوق سطر الطلب، أو اضغط Ctrl+Alt+R (Cmd+Alt+R على macOS). يمكنك أيضًا النقر بزر الفأرة الأيمن أو استخدام F1. تُفتح الاستجابة في لوحة منفصلة. إذا كنت تفضّل تبويب محرر عاديًا يمكنك البحث فيه وطيّه، فاضبط rest-client.previewResponseInUntitledDocument على true في الإعدادات.

الاستجابة هي JSON القياسي لإكمالات الدردشة. موضعان يهمان في اليوم الأول:

• choices[0].message.content هو نص الإجابة. وبجانبه، يخبرك finish_reason بسبب توقف النموذج. length يعني أن الإجابة قُطعت بسبب حد الرموز.
• usage يحمل أعداد الرموز لهذا الطلب: الرموز التي أرسلتها والرموز التي كتبها النموذج. هذا ما تدفع مقابله، فانظر إليه في كل مرة.

لتكوين إحساس بالتكلفة: لنقل إنك ترسل هذا الطلب 100 مرة بنحو 1,000 رمز داخل و300 خارج (افتراض للمثال، وليس قياسًا).

يعرض الجدول السعر الحي لهذا الحمل على كل نموذج، مع عمود OpenRouter للمقارنة. "Hello" صغيرة تكلف أقل بكثير.

بدّل النموذج في سطر واحد#

الجزء العملي في الملف النصي العادي: غيّر سطرًا واحدًا وأرسل مرة أخرى. استبدل معرّف النموذج بـ deepseek-ai/DeepSeek-V4-Flash-0731 (سياق 380K، حتى 32,768 رمزًا لكل إجابة، سعر واحد في أي وقت من اليوم، وأرخص إجمالًا من OpenRouter عند حساب الإدخال والإخراج معًا) واضغط Ctrl+Alt+R مرة أخرى. الجسم نفسه، والمفتاح نفسه، وإجابة مختلفة، وusage مختلف.

أتريد الاحتفاظ بكليهما؟ الصق طلبًا ثانيًا أسفل سطر ### بمعرّف النموذج الآخر. يحصل كل طلب على رابط Send Request خاص به، فيمكنك تشغيلهما واحدًا تلو الآخر والمقارنة. غير متأكد من معرّف؟ List models with GET /v1/models يعرض السلاسل الدقيقة.

إذا لم يعمل#

بالنسبة للأولين، يشرح API 401 or 404: wrong key, base URL or model id الفحوصات خطوة بخطوة. تفاصيل الطلب الكاملة موجودة في CheapTokens docs، والأسعار الحالية على pricing page.

هذه هي سير العمل كله: ملف واحد، ومفتاح واحد في .env، واختصار واحد. من هنا يمكنك إضافة رسالة نظام، أو تغيير max_tokens، أو تحويل الجسم نفسه إلى كود بأي لغة.