Source: https://ailoot.ai/docs/id/api/responses/ Canonical: https://ailoot.ai/docs/id/api/responses/ Language: id [API](https://ailoot.ai/docs/id/) # Responses [Markdown](https://ailoot.ai/docs/id/api/responses/index.md) Format baru OpenAI: satu input, output bertipe, alat, dan penalaran. Digunakan oleh 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": "Jawab secara singkat.", "input": "Apa perbedaan TCP dan 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="Jawab secara singkat.", input="Apa perbedaan TCP dan 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: "Jawab secara singkat.", input: "Apa perbedaan TCP dan 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 menjamin pengiriman dan urutan data; UDP tidak, tetapi lebih cepat…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## Autentikasi | Parameter | Tipe | Wajib | Deskripsi | | --- | --- | --- | --- | | `Authorization` | header | wajib | Kunci dalam format `Bearer sk-…`. Header yang juga dapat digunakan: `x-api-key` atau `x-goog-api-key`. | ## Isi permintaan | Parameter | Tipe | Wajib | Deskripsi | | --- | --- | --- | --- | | `model` | string | wajib | ID model dengan format Responses. Ada 53 dalam katalog: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax, Grok. Model Gemini tidak tersedia dalam format ini. | | `input` | string \| array | wajib | Teks permintaan atau array pesan dan bagian (teks, gambar). | | `instructions` | string | opsional | Instruksi sistem. | | `stream` | boolean | opsional | Aliran peristiwa SSE; peristiwa terakhir — `response.completed`. Teks berbayar dikirim sekaligus setelah biaya dihitung. | | `max_output_tokens` | integer | opsional | Jumlah maksimum token respons, termasuk penalaran. Jika tidak ditentukan, Ailoot menetapkan 4096 (atau lebih rendah jika batas respons model lebih rendah). Untuk respons panjang, tetapkan batas secara eksplisit. Permintaan dengan `previous_response_id` dan alat bawaan `web_search` atau `code_interpreter` menggunakan perkiraan tersendiri atas konteks yang tersimpan dan penggunaan alat untuk permintaan teks baru; biaya seluruh jendela input tidak otomatis diterapkan. Penahanan saldo yang telah disetujui sebelumnya tetap mengikuti ketentuan awalnya. Untuk output gambar, video, dan audio, saldo sebesar biaya penuh hasil ditahan. Jika jumlah saldo yang harus ditahan berdasarkan perhitungan melebihi saldo yang tersedia atau batas kunci, untuk model dan metode yang didukung Ailoot dapat menurunkan `max_tokens` (`max_output_tokens` dalam Responses) hingga sesuai dana yang tersedia, tetapi tidak kurang dari 256 token atau minimum metode tersebut jika lebih tinggi, dan memberitahukannya melalui header `X-Ailoot-Max-Tokens-Capped`. Kemungkinan penurunan diperiksa untuk kombinasi model teks dan metode tertentu. Ini berlaku bagi rute teks Gemini yang didukung dalam format asli 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 didukung oleh model). **Output** untuk penahanan saldo pada permintaan teks baru diperkirakan berdasarkan panjang respons tipikal dan ketentuan yang telah disetujui. Batas yang diminta ditetapkan melalui `max_tokens` (`max_output_tokens` dalam Responses). Batas yang diminta tidak otomatis sama dengan jumlah token yang menjadi dasar perhitungan saldo yang ditahan, dan tidak menjamin panjang respons aktual jika model tidak memiliki pembatasan yang andal. Nilai awal 4096 hanya berlaku pada rute yang sesuai; aturan tepatnya bergantung pada model dan metode. | | `reasoning` | object | opsional | `{"effort": "low" \| "medium" \| "high"}` untuk model penalaran. | | `tools` | array | opsional | Fungsi yang dapat dipanggil model. | | `text` | object | opsional | Format respons, misalnya `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | opsional | Tingkat keacakan respons, jika model mendukungnya. | ## Respons | Parameter | Tipe | Wajib | Deskripsi | | --- | --- | --- | --- | | `output` | array | | Elemen respons: pesan (`message`), penalaran, panggilan fungsi. Dalam SDK, praktis menggunakan `output_text`. | | `status` | string | | `completed`, `incomplete` (mencapai batas) atau `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | Masih ada pertanyaan? Kirim Request ID dan penjelasannya — kami akan membantu.[Hubungi dukungan](mailto:support@ailoot.ai) ## Ailoot · Perusahaan dan portofolio proyeknya Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan. Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.