أول استدعاء للواجهة البرمجية

مبتدئ

تتيح الواجهة البرمجية لبرنامجك أنت أن يتحدّث إلى Claude. بنهاية هذا الدرس ستكون قد نفّذت طلبًا حقيقيًا، وستفهم تمامًا ما يفعله كل جزء منه.

What you'll learn

أنشئ مفتاح API واحفظه بأمان كمتغيّر بيئة
ثبّت حزمة SDK الرسمية لـ Python أو TypeScript (أو استخدم cURL الصِّرف)
أرسل أول طلب messages واقرأ ردّ Claude
افهم الحقول الأربعة الأساسية: model و max_tokens و messages و system

الرحلة كاملةً في ثلاث خطوات

كل ما يلي يندرج ضمن تسلسل بسيط واحد. احتفظ بهذه الخريطة في ذهنك أثناء تقدّمك.

Guided walkthrough1 of 3

أنشئ مفتاحًا في وحدة تحكّم Anthropic وصدّره كمتغيّر بيئة كي لا يظهر أبدًا في شيفرتك.

1. احصل على مفتاح API

أنشئ واحدًا في وحدة تحكّم Anthropic. ثم اضبطه كمتغيّر بيئة كي لا يظهر أبدًا في شيفرتك:

صدّر مفتاح API الخاص بك

export ANTHROPIC_API_KEY="sk-ant-..."

Watch out

لا تُودِع مفتاحك في نظام التحكّم بالإصدارات أبدًا. احتفظ بالمفاتيح في متغيّرات البيئة أو في مدير أسرار، لا في نظام التحكّم بالشيفرة المصدرية إطلاقًا. راجع صفحة الأمان (/docs/security).

2. ثبّت حزمة SDK

اختر لغتك. تقرأ حزمة SDK المفتاح تلقائيًا من متغيّر البيئة الذي ضبطته للتوّ.

Python
TypeScript
cURL

التثبيت (Python)

pip install anthropic

التثبيت (TypeScript)

npm install @anthropic-ai/sdk

لا شيء لتثبيته — تحتاج فقط إلى curl.

3. نفّذ الاستدعاء

كل طلب هو قائمة من messages. ويردّ النموذج بـ content. شغّل المقتطف الخاص بلغتك وسترى Claude يجيب عن السؤال.

Python
TypeScript
cURL

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

console.log(message.content[0].text);

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

ماذا حدث للتو

لقد أرسلت أربع معلومات. وإليك ما يتحكّم به كلٌّ منها:

model — أيّ نموذج Claude تستخدم. لا تُرمّزه يدويًا بشكل أعمى؛ راجع اختيار نموذج.
max_tokens — حدّ أقصى لطول الردّ (بـالرموز). إنه لا يحدّد نافذة السياق.
messages — المحادثة حتى اللحظة. الواجهة البرمجية عديمة الحالة: لمتابعة محادثة، أعِد إرسال السجلّ الكامل في كل مرة.
system (اختياري) — تعليمة على المستوى الأعلى تحدّد دور Claude في الاستدعاء.

الحقول الأربعة الأساسية

اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.

1 / 4

Pro tip

لأن الواجهة البرمجية عديمة الحالة، فإن المحادثة متعدّدة الجولات ليست سوى مصفوفة messages تتنامى: ألحِق كل ردّ وأعِد إرسال القائمة الكاملة في الاستدعاء التالي.

اختبر نفسك

0/3

بِمَ يتحكّم max_tokens؟
كيف تتابع محادثة متعدّدة الجولات عبر الواجهة البرمجية؟
أين ينبغي أن يكون مفتاح API الخاص بك؟

Key takeaways

ثلاث خطوات: احصل على مفتاح، وثبّت حزمة SDK، وأرسل طلب messages.
احفظ المفتاح في ANTHROPIC_API_KEY كي تقرأه حزمة SDK تلقائيًا ولا يدخل أبدًا إلى شيفرتك.
الطلب هو قائمة من الرسائل؛ ويعود الردّ في content.
الواجهة البرمجية عديمة الحالة: أعِد إرسال سجلّ المحادثة الكامل لمتابعة محادثة.
model و max_tokens و messages و system هي الحقول التي ستلجأ إليها أولًا.

اختر النموذج المناسب وقدّر التكلفة ← اختيار نموذج · الرموز والتسعير
بثّ الردود وأدِر محادثة ← البثّ والمحادثات متعدّدة الجولات
دع Claude يستدعي دوالّك ← استخدام الأدوات
مقتطفات جاهزة للإنتاج ← مقتطفات الواجهة البرمجية

الرحلة كاملةً في ثلاث خطوات​

1. احصل على مفتاح API​

صدّر مفتاح API الخاص بك

2. ثبّت حزمة SDK​

التثبيت (Python)

التثبيت (TypeScript)

3. نفّذ الاستدعاء​

ماذا حدث للتو​