dokumentasi
API

Responses

Markdown

Format baharu OpenAI: satu input, output berjenis, alat dan penaakulan. Digunakan oleh Codex CLI.

Panduan lengkap
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": "Jawab secara ringkas.",
    "input": "Apakah perbezaan antara TCP dengan UDP?"
  }' 
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 menjamin penghantaran dan susunan, UDP tidak, tetapi lebih pantas…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Pengesahan

  • Authorizationheaderwajib

    Kunci dalam bentuk Bearer sk-…. Pengepala berikut juga boleh digunakan x-api-key atau x-goog-api-key.

Badan permintaan

  • modelstringwajib

    ID model berformat Responses. Terdapat 53 dalam katalog: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Model Gemini tidak tersedia dalam format ini.

  • inputstring | arraywajib

    Teks permintaan atau tatasusunan mesej dan bahagian (teks, imej).

  • instructionsstringpilihan

    Arahan sistem.

  • streambooleanpilihan

    Aliran peristiwa SSE; peristiwa terakhir ialah response.completed. Teks berbayar diterima sebagai satu blok selepas kos dikira.

  • max_output_tokensintegerpilihan

    Bilangan maksimum token respons, termasuk penaakulan. Jika tidak dinyatakan, Ailoot menetapkan 4096 (atau kurang jika had respons model lebih rendah). Untuk respons panjang, nyatakan had secara jelas. Permintaan dengan previous_response_id dan dengan alat terbina dalam web_search atau code_interpreter bagi permintaan teks baharu menggunakan anggaran berasingan untuk konteks tersimpan dan kerja alat; kosnya tidak secara automatik menjadi kos seluruh tetingkap input. Rizab yang diterima sebelum ini mengekalkan syarat asal. Bagi output imej, video dan audio, kos penuh hasil dirizabkan. Jika rizab yang dikira tidak dapat ditampung oleh baki tersedia atau had kunci, bagi model dan kaedah yang disokong Ailoot boleh mengurangkan max_tokens (max_output_tokens dalam Responses) kepada jumlah yang mampu dibayar, tetapi tidak kurang daripada 256 token atau minimum lebih tinggi bagi kaedah itu, dan memaklumkannya dalam pengepala X-Ailoot-Max-Tokens-Capped. Kebolehan mengurangkan had disemak bagi model teks dan kaedah berkenaan. Ia terpakai pada laluan teks Gemini yang disokong dalam format asal Gemini dan format 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 — dalam format Chat Completions dan Messages (jika model menyokongnya). Output bagi rizab permintaan teks baharu dianggarkan mengikut panjang respons lazim dan syarat yang dipersetujui. Had yang diminta ditetapkan melalui max_tokens (max_output_tokens dalam Responses). Had yang diminta tidak secara automatik sama dengan bilangan token yang digunakan untuk mengira rizab dan tidak menjamin panjang sebenar respons bagi model tanpa had yang boleh dipercayai. Nilai asal 4096 hanya digunakan pada laluan yang berkenaan; peraturan khusus bergantung pada model dan kaedah.

  • reasoningobjectpilihan

    {"effort": "low" | "medium" | "high"} untuk model penaakulan.

  • toolsarraypilihan

    Fungsi yang boleh dipanggil oleh model.

  • textobjectpilihan

    Format respons, contohnya {"format": {"type": "json_schema", ...}}.

  • temperaturenumberpilihan

    Tahap rawak respons, jika disokong oleh model.

Respons

  • outputarray

    Elemen respons: mesej (message), penaakulan, panggilan fungsi. Dalam SDK, lebih mudah menggunakan output_text.

  • statusstring

    completed, incomplete (mencapai had) atau failed.

  • usageobject

    input_tokens, output_tokens, total_tokens.

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.Hubungi sokongan