hujjatlar
API

Responses

Markdown

OpenAI’ning yangi formati: bitta kirish, turlangan chiqish, vositalar va fikrlash. Uni Codex CLI ishlatadi.

To‘liq qo‘llanma
POSThttps://api.ailoot.ai/v1/responses
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",
    "instructions": "Qisqa javob bering.",
    "input": "TCP UDP dan nimasi bilan farq qiladi?"
  }' 
200 OK
{
  "id": "resp_67f1…",
  "object": "response",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "TCP yetkazib berish va tartibni kafolatlaydi, UDP esa yo‘q, lekin tezroq…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Avtorizatsiya

  • Authorizationheadermajburiy

    Kalit quyidagi ko‘rinishda: Bearer sk-…. Quyidagi sarlavhalar ham mos keladi: x-api-key yoki x-goog-api-key.

So‘rov tanasi

  • modelstringmajburiy

    Responses formatidagi model ID’si. Katalogda bunday modellardan 53 ta bor: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Gemini modellari bu formatda mavjud emas.

  • inputstring | arraymajburiy

    So‘rov matni yoki xabarlar va qismlar massivi (matn, rasmlar).

  • instructionsstringixtiyoriy

    Tizim ko‘rsatmasi.

  • streambooleanixtiyoriy

    SSE hodisalar oqimi; oxirgi hodisa — response.completed. Pullik matn narx hisoblangach bitta blok ko‘rinishida keladi.

  • max_output_tokensintegerixtiyoriy

    Fikrlashni ham o‘z ichiga olgan javob tokenlarining maksimal soni. Ko‘rsatilmasa, Ailoot 4096 ni qo‘yadi (yoki modelning javob limiti kichikroq bo‘lsa, kamroq). Uzoq javoblar uchun limitni aniq belgilang. Quyidagi parametr ishlatilgan so‘rovlar: previous_response_id hamda quyidagi ichki vositalardan foydalanadigan so‘rovlar: web_search yoki code_interpreter — yangi matn so‘rovlari bo‘lsa, ular uchun saqlangan kontekst va vositalar ishining alohida baholari hisobga olinadi; zaxira avtomatik ravishda butun kirish oynasi narxiga tenglashtirilmaydi. Avval qabul qilingan zaxiralarning dastlabki shartlari saqlanadi. Chiqishdagi rasmlar, video va audio uchun natijaning to‘liq narxi zaxiralanadi. Hisoblangan zaxira mavjud balans yoki kalit limitiga sig‘masa, qo‘llab-quvvatlanadigan model va metod uchun Ailoot quyidagi limitni kamaytirishi mumkin: max_tokens (max_output_tokens Responses’da) — mablag‘ yetadigan hajmgacha, lekin 256 tokendan yoki ushbu metodning undan yuqori minimumidan past bo‘lmagan qiymatgacha. Bu haqda quyidagi sarlavhada xabar beriladi: X-Ailoot-Max-Tokens-Capped. Limitni kamaytirish imkoniyati aniq matn modeli va metod uchun tekshiriladi. U Gemini’ning nativ Gemini va Anthropic Messages formatlaridagi qo‘llab-quvvatlanadigan matn yo‘nalishlariga tatbiq etiladi; 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 va Messages formatlarida (model ularni qo‘llab-quvvatlagan joylarda). Chiqish yangi matn so‘rovi zaxirasi uchun odatiy javob uzunligi va qabul qilingan shartlar asosida baholanadi. So‘ralgan limit quyidagi parametr orqali belgilanadi: max_tokens (max_output_tokens Responses’da). So‘ralgan limit zaxira hisobida ishlatilgan tokenlar soniga avtomatik ravishda teng bo‘lmaydi va ishonchli cheklovi bo‘lmagan modelning haqiqiy javob uzunligini kafolatlamaydi. Dastlabki 4096 qiymati faqat tegishli yo‘nalishlarda qo‘llanadi; aniq qoida model va metodga bog‘liq.

  • reasoningobjectixtiyoriy

    {"effort": "low" | "medium" | "high"} fikrlaydigan modellar uchun.

  • toolsarrayixtiyoriy

    Model chaqirishi mumkin bo‘lgan funksiyalar.

  • textobjectixtiyoriy

    Javob formati, masalan {"format": {"type": "json_schema", ...}}.

  • temperaturenumberixtiyoriy

    Javobning tasodifiyligi, agar model uni qo‘llab-quvvatlasa.

Javob

  • outputarray

    Javob elementlari: xabarlar (message), fikrlash, funksiya chaqiruvlari. SDK’da quyidagi qiymatni olish qulay: output_text.

  • statusstring

    completed, incomplete (limitga yetgan) yoki failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Savollaringiz qoldimi? Request ID va tavsifni yuboring — tushunishga yordam beramiz.Yordam xizmatiga yozish