תיעוד
חיבור

בקשות HTTP (curl)

Markdown

עבודה עם ה-API ללא SDK: כל שפה וכל כלי שמאפשרים לשלוח בקשת HTTP.

המדריך המלא

כל הבקשות נשלחות ל- https://api.ailoot.ai באמצעות HTTPS, עם גוף JSON (להעלאת קבצים — multipart). המפתח נמצא באחת מכותרות האימות.

המפתח במשתנה
export AILOOT_API_KEY="sk-..."

OpenAI Chat Completions

curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "הסבר בשני משפטים מהו API."}
    ]
  }' 

תשובה בזרם

הדגל -N מבטל את אגירת הפלט של curl כדי שהאירועים יוצגו מיד עם הגעתם. כל אירוע מתחיל ב- data:, והזרם מסתיים בשורה data: [DONE].

curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-pro", "stream": true,
       "messages": [{"role": "user", "content": "ספור עד חמש"}]}' 

OpenAI Responses

curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "נסח ברכה להרמת כוסית ביום ההולדת של עמית לעבודה"}' 

Anthropic 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": "שלום! מה אתה יודע לעשות?"}]
  }' 

Gemini

curl "https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "הצע שלושה שמות לבית קפה."}]}
    ]
  }' 

רשימת המודלים

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY" | jq -r '.data[].id'

כותרות התשובה

הוסיפו -i כדי לראות את הכותרות. X-Request-ID — מזהה הבקשה: הוא מופיע גם בהודעות השגיאה. X-Ailoot-Charged-USD — הסכום שחויב עבור תשובת הטקסט בתשלום. כל הכותרות מופיעות בעמוד איך זה עובד.

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