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 } }