Source: https://ailoot.ai/docs/he/api/responses/
Canonical: https://ailoot.ai/docs/he/api/responses/
Language: he

[API](https://ailoot.ai/docs/he/) 

# Responses

[Markdown](https://ailoot.ai/docs/he/api/responses/index.md)

הפורמט החדש של OpenAI: קלט אחד, פלט עם טיפוסים מוגדרים, כלים והסקה. Codex CLI משתמש בו.

POST`https://api.ailoot.ai/v1/responses`

Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "instructions": "השב בקצרה.",
    "input": "מה ההבדל בין TCP ל-UDP?"
  }' 
```

```python
from openai import OpenAI
import os

client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
resp = client.responses.create(
    model="gpt-6.1-sol",
    instructions="השב בקצרה.",
    input="מה ההבדל בין TCP ל-UDP?",
)
print(resp.output_text)
```

```js
import OpenAI from "openai";

const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY });
const resp = await client.responses.create({
  model: "gpt-6.1-sol",
  instructions: "השב בקצרה.",
  input: "מה ההבדל בין TCP ל-UDP?",
});
console.log(resp.output_text);
```

200 OK

```json
{
  "id": "resp_67f1…",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "TCP מבטיח מסירה וסדר, UDP אינו מבטיח זאת, אך הוא מהיר יותר…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## אימות

| פרמטר | סוג | חובה | תיאור |
| --- | --- | --- | --- |
| `Authorization` | header | חובה | המפתח בפורמט `Bearer sk-…`. אפשר להשתמש גם בכותרות `x-api-key` או `x-goog-api-key`. |

## גוף הבקשה

| פרמטר | סוג | חובה | תיאור |
| --- | --- | --- | --- |
| `model` | string | חובה | מזהה מודל בפורמט Responses. בקטלוג יש 53 כאלה: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. מודלי Gemini אינם זמינים בפורמט הזה. |
| `input` | string \| array | חובה | טקסט הבקשה או מערך של הודעות וחלקים (טקסט, תמונות). |
| `instructions` | string | רשות | הוראת מערכת. |
| `stream` | boolean | רשות | זרם אירועי SSE; האירוע האחרון הוא `response.completed`. הטקסט בתשלום מגיע כבלוק אחד לאחר חישוב העלות. |
| `max_output_tokens` | integer | רשות | מספר הטוקנים המרבי בתשובה, כולל ההסקה. אם לא צוין, Ailoot מגדיר 4096 (או פחות, אם מגבלת התשובה של המודל נמוכה יותר). לתשובות ארוכות יש להגדיר מגבלה במפורש. בקשות עם `previous_response_id` ועם הכלים המובנים `web_search` או `code_interpreter` מתחשבות, כשמדובר בבקשות טקסט חדשות, באומדנים נפרדים של ההקשר השמור ושל עבודת הכלים; הן אינן מחושבות אוטומטית לפי עלות חלון הקלט כולו. רזרבות שהתקבלו בעבר שומרות על התנאים המקוריים. עבור תמונות, וידאו ושמע בפלט נשמרת כרזרבה מלוא עלות התוצאה. אם הרזרבה המחושבת חורגת מהיתרה הזמינה או ממגבלת המפתח, במודל ובמתודה נתמכים Ailoot עשוי להקטין את `max_tokens` (`max_output_tokens` ב-Responses) לכמות שאפשר לשלם עבורה, אך לא מתחת ל-256 טוקנים, או למינימום של המתודה אם הוא גבוה יותר, ומדווח על כך בכותרת `X-Ailoot-Max-Tokens-Capped`. האפשרות להקטין נבדקת עבור מודל הטקסט המסוים והמתודה. היא חלה על נתיבי טקסט נתמכים של Gemini בפורמט המקורי של Gemini ובפורמט Anthropic Messages; `deepseek-ai/deepseek-v4.1-flash`, `meta/llama-3.2-11b-vision-instruct`, `meta/muse-glimmer-30b`, `nvidia/ising-calibration-1.5-31b`, `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning`, `nvidia/nemotron-3-super-120b-a12b`, `nvidia/nemotron-3-ultra-550b-a55b`, `nvidia/nemotron-3.5-content-safety`, `nvidia/nemotron-3.5-lightning-30b-a3b`, `nvidia/riva-translate-4b-instruct-v1.1`, `nvidia/riva-translate-4b-instruct-v2`, `poolside/laguna-xs-2.1`, `z-ai/glm-5.3-flash` — בפורמטים Chat Completions ו-Messages (במקומות שבהם המודל תומך בהם). **פלט** — לצורך הרזרבה לבקשת טקסט חדשה, הוא מוערך לפי האורך הטיפוסי של התשובה והתנאים המוסכמים. את המגבלה המבוקשת מגדירים באמצעות `max_tokens` (`max_output_tokens` ב-Responses). המגבלה המבוקשת אינה זהה אוטומטית למספר הטוקנים שעל פיו חושבה הרזרבה, ואינה מבטיחה את אורך התשובה בפועל במודל שאין בו הגבלה אמינה. הערך ההתחלתי 4096 חל רק על הנתיבים המתאימים; הכלל המסוים תלוי במודל ובמתודה. |
| `reasoning` | object | רשות | `{"effort": "low" \| "medium" \| "high"}` עבור מודלי הסקה. |
| `tools` | array | רשות | פונקציות שהמודל יכול לקרוא להן. |
| `text` | object | רשות | פורמט התשובה, לדוגמה `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | רשות | מידת האקראיות של התשובה, אם המודל תומך בה. |

## תשובה

| פרמטר | סוג | חובה | תיאור |
| --- | --- | --- | --- |
| `output` | array |  | רכיבי התשובה: הודעות (`message`), הסקה וקריאות לפונקציות. ב-SDK נוח להשתמש ב- `output_text`. |
| `status` | string |  | `completed`, `incomplete` (הגעה למגבלה) או `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.[פנייה לתמיכה](mailto:support@ailoot.ai)

## Ailoot · החברה ופורטפוליו הפרויקטים שלה





Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.





החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.





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