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 singkat.",
    "input": "Apa perbedaan TCP dan UDP?"
  }' 

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)

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);

{
  "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

• Authorizationheaderwajib

  Kunci dalam format Bearer sk-…. Header yang juga dapat digunakan: x-api-key atau x-goog-api-key.

Isi permintaan

• modelstringwajib

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

• inputstring | arraywajib

  Teks permintaan atau array pesan dan bagian (teks, gambar).

• instructionsstringopsional

  Instruksi sistem.

• streambooleanopsional

  Aliran peristiwa SSE; peristiwa terakhir — response.completed. Teks berbayar dikirim sekaligus setelah biaya dihitung.

• max_output_tokensintegeropsional

  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.

• reasoningobjectopsional

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

• toolsarrayopsional

  Fungsi yang dapat dipanggil model.

• textobjectopsional

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

• temperaturenumberopsional

  Tingkat keacakan respons, jika model mendukungnya.

Respons

• outputarray

  Elemen respons: pesan (message), penalaran, panggilan fungsi. Dalam SDK, praktis menggunakan output_text.

• statusstring

  completed, incomplete (mencapai batas) atau failed.

• usageobject

  input_tokens, output_tokens, total_tokens.