Anthropic Python SDK مع CheapTokens: Messages API

إذا كان الكود لديك يستخدم Anthropic Python SDK بالفعل، فلست مضطرًا إلى إعادة كتابته لاستدعاء نموذج آخر. يتحدث CheapTokens لغة Anthropic Messages API، لذا تغيّر إعدادات العميل وتبقي client.messages.create(...) كما هو. يأخذك هذا الدليل من مجلد فارغ إلى سكربت يطبع إجابة.

ما تحتاج إليه#

• Python 3.10 أو أحدث (متطلب الـ SDK).
• مفتاح CheapTokens API. إن لم يكن لديك واحد بعد، راجع "What is an API key and how to store it safely".
• رصيد واحد يغطي كل النماذج، ولا توجد ساعات ذروة، لذا يكلفك السكربت نفسه المبلغ نفسه في أي وقت من اليوم.

تثبيت الـ SDK#

pip install anthropic
export CHEAPTOKENS_API_KEY="your-key"

احفظ المفتاح في متغير بيئة، لا في ملف المصدر.

إنشاء العميل#

يختلف إعدادان عن إعداد Anthropic الافتراضي: المفتاح وbase_url.

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
    base_url="https://api.cheaptokens.dev",
)

يضيف الـ SDK المسار /v1/messages بنفسه، لذا فإن base_url هو المضيف بدون /v1. (نقطة النهاية بنمط OpenAI، https://api.cheaptokens.dev/v1، هي التي تستخدمها مع OpenAI SDK؛ راجع "Your first API request with CheapTokens".)

أول طلب#

message = client.messages.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain what a token is in two sentences."}
    ],
)

print(message.content[0].text)
print(message.stop_reason, message.usage.input_tokens, message.usage.output_tokens)

خذ معرّف النموذج من وثائق CheapTokens؛ فالمعرّفات تختلف بين المزوّدين. نستخدم هنا DeepSeek-V4-Flash: نافذة سياق 380K وحتى 32,768 رمزًا في إجابة واحدة، وهو ما يناسب الردود الطويلة وحلقات الوكيل.

تكون الإجابة في message.content، وهي قائمة من الكتل؛ والنص في الكتلة الأولى. يوضح usage عدد رموز الإدخال والإخراج التي استهلكها الاستدعاء، وهي ما تُحاسب عليه.

max_tokens مطلوب#

على خلاف OpenAI API، لن يعمل messages.create بدون max_tokens. فهو يحدّ طول الإجابة:

• إذا كان منخفضًا جدًا، تُقطع الإجابة. عندئذٍ يكون message.stop_reason هو "max_tokens" بدلًا من "end_turn".
• مع DeepSeek-V4-Flash يمكنك الوصول إلى 32,768 للإجابات الطويلة مثل الملفات الكاملة أو التقارير.
• تدفع مقابل الرموز المولّدة فعليًا، لا مقابل الحد الذي تضبطه.

إذا توقفت إجابة في منتصف الجملة، فاقرأ "Why does an AI answer stop mid-sentence?" للشرح الكامل.

تبديل النماذج#

لا يتغير سوى سلسلة model؛ ويبقى بقية السكربت كما هو. اختر حسب المهمة:

• DeepSeek-V4-Flash: إجابات طويلة وحلقات وكيل، سعر واحد في أي ساعة، وحتى 32,768 رمز إخراج.
• GLM-5.3-Flash: محادثات يومية رخيصة واستدعاءات برمجة، سياق 390K، وحتى 8,192 رمز إخراج.
• MiniMax-M2.7: أعمال وكيل وبرمجة منخفضة التكلفة، سياق 180K، وحتى 8,192 رمز إخراج.

تُعاد قائمة المعرّفات المتاحة بواسطة GET https://api.cheaptokens.dev/v1/models، مثل zai-org/GLM-5.3-Flash وMiniMaxAI/MiniMax-M2.7.

الأسعار الحالية لكل 1M رمز لـ MiniMax-M2.7 هي $0.05 للإدخال و$0.15 للإخراج. MiniMax-M2.7 أرخص من OpenRouter إجمالًا، مع احتساب الإدخال والإخراج معًا. إليك تكلفة طلب بـ 2,000 رمز إدخال و500 رمز إخراج على كل نموذج، مباشرة من قائمة الأسعار:

GLM-5.3-Flash وMiniMax-M2.7 أرخص من OpenRouter إجمالًا، مع احتساب الإدخال والإخراج معًا.

الخطوة التالية#

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