API

Messages

פורמט Anthropic Messages. הוא משמש את Claude Code, את Anthropic SDK וסוכנים רבים.

המדריך המלא

POSThttps://api.ailoot.ai/v1/messages

Messages

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

import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # ללא /v1: ה-SDK יוסיף בעצמו /v1/messages
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "הסבר בשני משפטים מהו API."}],
)
print(msg.content[0].text)

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

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // ללא /v1
  apiKey: process.env.AILOOT_API_KEY,
});

const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "הסבר בשני משפטים מהו API." }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);

200 OK

{
  "id": "msg_01H…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "שלום! אני יודע לכתוב ולהסביר קוד, לענות על שאלות…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}

אימות

x-api-keyheaderחובה
מפתח sk-…. אפשר להשתמש גם ב- Authorization: Bearer sk-… — כך פועל Claude Code עם ANTHROPIC_AUTH_TOKEN.
anthropic-versionheaderרשות
גרסת ה-API, לדוגמה 2023-06-01. ערכות SDK שולחות אותה בעצמן.

גוף הבקשה

modelstringחובה
מזהה מודל בפורמט Messages — 776 מזהים: Claude וגם GPT, Gemini, DeepSeek, Qwen ואחרים.
messagesarrayחובה
הודעות user וכן assistant; content — מחרוזת או בלוקים (text, image, tool_use, tool_result).
max_tokensintegerחובה
מספר הטוקנים המרבי בתשובה. הוא נכלל ברזרבה; אם היתרה אינה מספיקה למגבלה המלאה, Ailoot מקטין אותה, אך לא מתחת ל-256 (1025 כאשר ההסקה מופעלת), ומדווח על המגבלה החדשה בכותרת X-Ailoot-Max-Tokens-Capped.
systemstring | arrayרשות
הוראת מערכת.
streambooleanרשות
זרם אירועי SSE (message_start, content_block_delta, …, message_stop). הטקסט בתשלום מגיע כבלוק אחד לאחר חישוב העלות.
temperaturenumberרשות
מידת האקראיות של התשובה מ-0 עד 1.
toolsarrayרשות
כלים: name, description, input_schema.
tool_choiceobjectרשות
auto, any, tool או none.
thinkingobjectרשות
{"type": "enabled", "budget_tokens": N} — הסקה במודלים התומכים בכך.
stop_sequencesarrayרשות
מחרוזות שבהן יצירת התשובה תיעצר.

תשובה

contentarray
בלוקי התשובה: text, thinking, tool_use.
stop_reasonstring
end_turn, max_tokens, stop_sequence או tool_use.
usageobject
input_tokens, output_tokens, ועבור המטמון — cache_read_input_tokens וכן cache_creation_input_tokens.

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.פנייה לתמיכה

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

import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # ללא /v1: ה-SDK יוסיף בעצמו /v1/messages api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "הסבר בשני משפטים מהו API."}], ) print(msg.content[0].text)

import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ maxRetries: 0, baseURL: "https://api.ailoot.ai", // ללא /v1 apiKey: process.env.AILOOT_API_KEY, }); const msg = await client.messages.create({ model: "claude-sonnet-5-5", max_tokens: 1024, messages: [{ role: "user", content: "הסבר בשני משפטים מהו API." }], }); console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);

{ "id": "msg_01H…", "type": "message", "role": "assistant", "model": "claude-sonnet-5-5", "content": [ { "type": "text", "text": "שלום! אני יודע לכתוב ולהסביר קוד, לענות על שאלות…" } ], "stop_reason": "end_turn", "usage": { "input_tokens": 14, "output_tokens": 52 } }