طلبك الأول لواجهة API مع CheapTokens

يأخذك هذا الدليل من حساب جديد إلى طلب يعمل. تحتاج إلى عنوان بريد إلكتروني ورصيد صغير وطرفية. الواجهة البرمجية متوافقة مع OpenAI، لذا إذا كنت قد استدعيت OpenAI من قبل، فإن شيئين فقط يتغيران: عنوان URL الأساسي والمفتاح.

ما تحتاجه#

• حساب. التسجيل بالبريد الإلكتروني — بدون كلمة مرور، نرسل لك رابط تسجيل الدخول.
• رصيد. لا يوجد اشتراك: تشحن رصيدًا بالدولار الأمريكي ويُحاسب كل طلب لكل رمز بسعر النموذج الثابت.
• مفتاح API من لوحة التحكم الخاصة بك.

الخطوة 1. أنشئ حسابًا واشحن الرصيد#

افتح صفحة التسجيل، أدخل بريدك الإلكتروني واتبع الرابط من الرسالة. في لوحة التحكم اضغط شحن واختر طريقة الدفع:

• العملات المشفرة — من 5 دولارات؛ تُطبق رسوم إيداع بنسبة 5%.
• البطاقة — عبر شريك، يفرض رسومه الخاصة.

الخطوة 2. انسخ مفتاح API#

بمجرد أن يصبح رصيدك أكبر من الصفر — بعد الشحن أو مكافأة الإحالة — تنشئ لوحة التحكم مفتاح API الخاص بك وتعرضه مرة واحدة. انسخه فورًا واحفظه بعيدًا عن الكود، على سبيل المثال في متغير بيئة:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

إذا تسرب المفتاح، اضغط تدوير: تحصل على مفتاح جديد ويتوقف القديم عن العمل.

الخطوة 3. اختر نموذجًا#

تحتاج الطلبات إلى معرّف النموذج الكامل — مع البادئة قبل الشرطة المائلة، تمامًا كما تسرده الواجهة البرمجية. الكتالوج وقت الكتابة (أكتوبر 2026):

قد يتغير الكتالوج، لذا المصدر الموثوق هو الواجهة البرمجية نفسها. هذا الطلب لا يحتاج مفتاحًا:

curl https://api.cheaptokens.dev/v1/models

الخطوة 4. أرسل الطلب#

curl#

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": "Say hello in three languages"}]
  }'

تأتي الإجابة الناجحة بصيغة Chat Completions القياسية. مثال مختصر — سيختلف نصك ومعرّفاتك وأرقامك، وقد تحمل الاستجابة حقول خدمة إضافية:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• النص موجود في choices[0].message.content.
• استخدام الرموز موجود في usage: prompt_tokens — الإدخال، completion_tokens — الإخراج. هذان الرقمان هما ما يُحاسب عليه الطلب.

Python#

ثبّت SDK الرسمي باستخدام pip install openai ووجّهه إلى عنوان URL الأساسي الخاص بنا:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

ثبّت SDK باستخدام npm install openai:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

عملاء بأسلوب Anthropic#

العملاء المصممون لواجهة Anthropic Messages API يستخدمون العنوان الجذري بدون /v1 — https://api.cheaptokens.dev — ويرسلون المفتاح في ترويسة x-api-key. تضيف SDKs الخاصة بـ Anthropic المسار والترويسة بنفسها؛ أنت فقط تضبط عنوان URL الأساسي والمفتاح.

إذا حدث خطأ ما#

• 401 Invalid API key — المفتاح مكتوب بشكل خاطئ أو تم تدويره. تحقق من أنك لصقته كاملًا؛ تعرض لوحة التحكم المفتاح مرة واحدة فقط، لذا إذا فُقد، اضغط تدوير للحصول على مفتاح جديد.
• 402 — الرصيد مستنفد، أو أُرسل الطلب بدون ترويسة Authorization.
• 400 Model "…" not found — استخدم معرّف النموذج الكامل من /v1/models، بما في ذلك البادئة قبل الشرطة المائلة.
• 404 — تحقق من العنوان: يحتاج عملاء بأسلوب OpenAI إلى /v1 في نهاية عنوان URL الأساسي.

مزيد من الحالات والحلول: أخطاء الاتصال الشائعة وكيفية إصلاحها.

كم يكلف#

يُحاسب كل طلب على رموز الإدخال والإخراج بشكل منفصل، بسعر النموذج لكل مليون رمز. الأسعار الحالية — نفس البيانات الموجودة في صفحة الأسعار:

الخطوة التالية: اربط وكيل برمجة، على سبيل المثال Cline، أو تعلم تقدير تكلفة وكيل الذكاء الاصطناعي.

هل توصي بـ CheapTokens لمطورين آخرين؟ مع برنامج الإحالة تحصل على نسبة من عمليات شحن رصيدهم.