الانتقال من OpenRouter إلى CheapTokens: base_url والمفتاح ومعرّف النموذج

تطبيقك يستدعي OpenRouter بالفعل عبر OpenAI SDK، وتريد أن يستدعي CheapTokens بدلاً منه. تُغيّر ثلاث قيم — base_url، ومفتاح API، ومعرّف model — وتحذف ترويستين اختياريتين. يبقى باقي الكود كما هو.

فيما يلي الأسطر الدقيقة لـ Python وJavaScript وcurl، وطريقة سريعة للتأكد من نجاح التبديل، وجدول يوضح أي نموذج يناسب أي مهمة. إذا لم تكن قد أرسلت طلبًا إلى CheapTokens من قبل، فإن دليل أول طلب API يغطي الحساب والمفتاح؛ والتوثيق يحتوي على المرجع الكامل.

ما الذي يتغيّر فعليًا#

يُهيّئ دليل البدء السريع في OpenRouter (تم التحقق منه في 27 أكتوبر 2026) عميل OpenAI بعنوان base URL https://openrouter.ai/api/v1 ويسمّي النماذج بصيغة provider/model-name. يتحدث CheapTokens بنفس صيغة OpenAI Chat Completions على https://api.cheaptokens.dev/v1. لذا فإن فئة العميل وchat.completions.create وطريقة قراءتك للإجابة لا تتغيّر.

هذا تبديل واحد لكل سطر:

• base URL — https://api.cheaptokens.dev/v1 بدلاً من عنوان OpenRouter؛
• مفتاح API — مفتاح من حسابك في CheapTokens، يُقرأ من متغير بيئة؛
• معرّف النموذج — معرّف CheapTokens الكامل، مثل deepseek-ai/DeepSeek-V4-Flash-0731. خُذ المعرّفات من توثيق CheapTokens: مزوّدون مختلفون يسمّون النموذج نفسه بأسماء مختلفة، والمعرّفات القصيرة من ملصقات الأسعار غير مقبولة.

وحذف واحد. ترويستا HTTP-Referer وX-OpenRouter-Title في OpenRouter اختياريتان وتغذّيان لوحات المتصدرين في OpenRouter فقط. احذفهما من default_headers / defaultHeaders؛ لست بحاجة إليهما هنا.

الكود بعد التبديل#

نفس الطلب، ثلاث بيئات تشغيل. اختر التي يستخدمها تطبيقك.

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': 'Reply with one word: ready'}],
    max_tokens=20,
)
print(resp.choices[0].message.content)

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: 'Reply with one word: ready' }],
  max_tokens: 20,
});
console.log(resp.choices[0].message.content);

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": "Reply with one word: ready"}], "max_tokens": 20}'

شيء آخر قبل تشغيله. إذا كان طلبك يحمل حقولًا خاصة بـ OpenRouter — قوائم التوجيه أو الاحتياط، وتفضيلات المزوّد، ومعرّفات نموذج ~alias — فهي تنتمي إلى OpenRouter. أبقِ الطلب على حقول Chat Completions القياسية: model، messages، temperature، max_tokens، stream.

تحقّق من نجاحه#

الرد ليس دليلًا كافيًا. اطبع ثلاثة أشياء بجانبه: أي نموذج أجاب، ولماذا توقف، وكم كلّف بالتوكنات.

print(resp.model)
print(resp.choices[0].finish_reason)
print(resp.usage.prompt_tokens, resp.usage.completion_tokens)

finish_reason من stop يعني أن النموذج أنهى من تلقاء نفسه. length يعني أن max_tokens قطع الإجابة. usage يعرض توكنات الإدخال والإخراج بشكل منفصل، وهما الرقمان اللذان تتكوّن منهما فاتورتك — نفس الرقمين اللذين كنت تتابعهما على OpenRouter.

أي نموذج يحل محل ماذا#

اختر النموذج حسب المهمة، لا حسب الاسم الذي استخدمته على OpenRouter. الحقائق أدناه من قائمة أسعار CheapTokens التي تم التحقق منها في 27 أكتوبر 2026؛ رصيد واحد يغطي النماذج الثلاثة ولا يتغيّر السعر حسب وقت اليوم.

لست متأكدًا أي صف يناسبك؟ ابدأ من ما يفعله التطبيق:

كم يكلّف نفس حجم الحركة#

لنفترض أن بوتك يرسل 1,000 طلب، كل منها نحو 500 توكن إدخال و300 توكن إخراج. هذا افتراض — استبدله بأرقامك من usage. الجدول أدناه حيّ: أسعارنا وعمود OpenRouter مأخوذان من قائمة الأسعار الحالية، مع احتساب الإدخال والإخراج معًا.

على DeepSeek-V4-Flash تبلغ تلك الطلبات الـ 1,000 $0.0375. الأسعار الكاملة على صفحة الأسعار؛ وفكرة ما تُحاسب عليه موجودة في توكنات الإدخال مقابل الإخراج.

إذا لم يعمل#

بعد التبديل، تغطي ثلاثة أخطاء معظم المشكلات. طابق الرسالة مع السبب:

مقال استكشاف أخطاء 401 و404 يستعرض كلًا منهما مع الرسائل الدقيقة، وما هو base_url يشرح لماذا يكسر شرطة مائلة واحدة خاطئة المسار.

قبل الإطلاق#