שיחה ראשונה עם ה-API ב-curl.

להירשם ל-Anthropic Console

הקונסולה היא העמוד שבו מנהלים את ה-API. גשו אל console.anthropic.com, פתחו חשבון, וטענו קרדיט ראשוני - בדרך כלל 5 דולר מספיקים לעשרות אלפי בקשות ניסיוניות.

ליצור API key

בקונסולה, פתחו את הלשונית API Keys ולחצו Create Key. המפתח יוצג פעם אחת בלבד, אז העתיקו אותו מיד למקום בטוח - מנהל סיסמאות הוא הבחירה המומלצת.

export ANTHROPIC_API_KEY="sk-ant-...your-key-here..."

לשלוח את הבקשה הראשונה

הקריאה הבסיסית היא POST לכתובת api.anthropic.com/v1/messages עם שלוש כותרות חובה: המפתח, גרסת ה-API, וסוג התוכן.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "שלום, מי אתה?"}
    ]
  }'

שלושה שדות חובה ב-JSON: model - איזה מודל לקרוא, max_tokens - תקרת אורך לתשובה, ו- messages - מערך ההודעות.

לקרוא את התשובה

התשובה היא JSON. השדה החשוב ביותר הוא content[0].text - שם נמצא הטקסט שהמודל יצר.

{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-5",
  "content": [
    {
      "type": "text",
      "text": "שלום! אני קלוד, עוזר AI של אנתרופיק..."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 42
  }
}

שדה usage חשוב - הוא מראה כמה טוקנים נצרכו בקלט ובפלט. אלה המספרים שיחויבו על הפנייה.

לנהל שיחה מרובת תורים

ה-API חסר זיכרון. כל פנייה עומדת בפני עצמה. אם רוצים להמשיך שיחה, צריך לשלוח שוב את כל ההיסטוריה - גם את ההודעות שלכם וגם את התשובות של המודל בתוך אותו מערך messages.

{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "שלום, מי אתה?"},
    {"role": "assistant", "content": "אני קלוד, עוזר AI..."},
    {"role": "user", "content": "מי בנה אותך?"}
  ]
}

אחרי שעוברים את זה ידנית פעם אחת, יותר נקי לעבור ל-SDK. אבל ראיתם את המנגנון הבסיסי - וזה תמיד שווה.