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": "Vastaa lyhyesti.",
    "input": "Miten TCP eroaa UDP:stä?"
  }' 

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="Vastaa lyhyesti.",
    input="Miten TCP eroaa UDP:stä?",
)
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: "Vastaa lyhyesti.",
  input: "Miten TCP eroaa UDP:stä?",
});
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 takaa toimituksen ja järjestyksen, UDP ei, mutta on nopeampi…" }
      ]
    }
  ],
  "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 }
}

Todennus

• Authorizationheaderpakollinen

  Avain muodossa Bearer sk-…. Myös seuraavat otsakkeet käyvät: x-api-key tai x-goog-api-key.

Pyynnön runko

• modelstringpakollinen

  Responses-muotoa tukevan mallin ID. Luettelossa on 53: GPT, Claude, DeepSeek, Qwen, Kimi, GLM, MiniMax ja Grok. Gemini-mallit eivät ole saatavilla tässä muodossa.

• inputstring | arraypakollinen

  Pyynnön teksti tai viestien ja osien taulukko (teksti, kuvat).

• instructionsstringvalinnainen

  Järjestelmäohje.

• streambooleanvalinnainen

  SSE-tapahtumavirta; viimeinen tapahtuma on response.completed. Maksullinen teksti saapuu yhtenä lohkona hinnan laskemisen jälkeen.

• max_output_tokensintegervalinnainen

  Vastauksen tokenien enimmäismäärä, päättely mukaan lukien. Jos sitä ei anneta, Ailoot asettaa arvoksi 4096 (tai vähemmän, jos mallin vastausraja on pienempi). Määritä raja erikseen pitkille vastauksille. Kenttää previous_response_id ja sisäänrakennettuja työkaluja web_search tai code_interpreter käyttävissä uusissa tekstipyynnöissä huomioidaan erilliset arviot tallennetusta kontekstista ja työkalujen käytöstä; niissä ei automaattisesti siirrytä koko syöteikkunan kustannukseen. Aiemmin hyväksytyt varaukset säilyttävät alkuperäiset ehtonsa. Kuville, videolle ja äänelle tulosteena varataan tuloksen koko kustannus. Jos laskettu varaus ei mahdu käytettävissä olevaan saldoon tai avaimen rajaan, Ailoot voi tuetulla mallilla ja metodilla pienentää parametrin max_tokens (max_output_tokens Responsesissa) arvon maksettavissa olevaan määrään, mutta ei alle 256 tokenin tai kyseisen metodin korkeamman vähimmäismäärän, ja ilmoittaa siitä otsakkeessa X-Ailoot-Max-Tokens-Capped. Pienentämismahdollisuus tarkistetaan kyseiselle tekstimallille ja metodille. Sitä sovelletaan tuettuihin Geminin tekstireitteihin mallin omassa Gemini-muodossa ja Anthropic Messages -muodossa; 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- ja Messages-muodoissa (siellä, missä malli tukee niitä). Tuloste arvioidaan uuden tekstipyynnön varausta varten tyypillisen vastauspituuden ja hyväksyttyjen ehtojen perusteella. Pyydetty raja asetetaan parametrilla max_tokens (max_output_tokens Responsesissa). Pyydetty raja ei automaattisesti vastaa tokenimäärää, jonka perusteella varaus on laskettu, eikä takaa todellista vastauspituutta mallilla, jolla ei ole luotettavaa rajoitusta. Lähtöarvoa 4096 käytetään vain sitä koskevilla reiteillä; tarkka sääntö riippuu mallista ja metodista.

• reasoningobjectvalinnainen

  {"effort": "low" | "medium" | "high"} päättelymalleille.

• toolsarrayvalinnainen

  Funktiot, joita malli voi kutsua.

• textobjectvalinnainen

  Vastauksen muoto, esimerkiksi {"format": {"type": "json_schema", ...}}.

• temperaturenumbervalinnainen

  Vastauksen satunnaisuus, jos malli tukee sitä.

Vastaus

• outputarray

  Vastauksen elementit: viestit (message), päättely ja funktiokutsut. SDK:ssa on kätevää käyttää output_text.

• statusstring

  completed, incomplete (raja saavutettu) tai failed.

• usageobject

  input_tokens, output_tokens, total_tokens.