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

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

# Responses

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

Format baharu OpenAI: satu input, output berjenis, alat dan penaakulan. 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 ringkas.",
    "input": "Apakah perbezaan antara TCP dengan 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 ringkas.",
    input="Apakah perbezaan antara TCP dengan 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 ringkas.",
  input: "Apakah perbezaan antara TCP dengan 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 penghantaran dan susunan, UDP tidak, tetapi lebih pantas…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}
```

## Pengesahan

| Parameter | Jenis | Wajib | Penerangan |
| --- | --- | --- | --- |
| `Authorization` | header | wajib | Kunci dalam bentuk `Bearer sk-…`. Pengepala berikut juga boleh digunakan `x-api-key` atau `x-goog-api-key`. |

## Badan permintaan

| Parameter | Jenis | Wajib | Penerangan |
| --- | --- | --- | --- |
| `model` | string | wajib | ID model berformat Responses. Terdapat 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 tatasusunan mesej dan bahagian (teks, imej). |
| `instructions` | string | pilihan | Arahan sistem. |
| `stream` | boolean | pilihan | Aliran peristiwa SSE; peristiwa terakhir ialah `response.completed`. Teks berbayar diterima sebagai satu blok selepas kos dikira. |
| `max_output_tokens` | integer | pilihan | 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. |
| `reasoning` | object | pilihan | `{"effort": "low" \| "medium" \| "high"}` untuk model penaakulan. |
| `tools` | array | pilihan | Fungsi yang boleh dipanggil oleh model. |
| `text` | object | pilihan | Format respons, contohnya `{"format": {"type": "json_schema", ...}}`. |
| `temperature` | number | pilihan | Tahap rawak respons, jika disokong oleh model. |

## Respons

| Parameter | Jenis | Wajib | Penerangan |
| --- | --- | --- | --- |
| `output` | array |  | Elemen respons: mesej (`message`), penaakulan, panggilan fungsi. Dalam SDK, lebih mudah menggunakan `output_text`. |
| `status` | string |  | `completed`, `incomplete` (mencapai had) atau `failed`. |
| `usage` | object |  | `input_tokens`, `output_tokens`, `total_tokens`. |

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.[Hubungi sokongan](mailto:support@ailoot.ai)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.