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

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

# Responses

[Markdown](https://ailoot.ai/docs/ar/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`)، واستدلال، واستدعاءات دوال. من الملائم استخدام `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 إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.