Source: https://ailoot.ai/docs/fi/api/responses/ Canonical: https://ailoot.ai/docs/fi/api/responses/ Language: fi [API](https://ailoot.ai/docs/fi/) # Responses [Markdown](https://ailoot.ai/docs/fi/api/responses/index.md) OpenAIn uusi muoto: yksi syöte, tyypitetty tuloste, työkalut ja päättely. Codex CLI käyttää sitä. 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": "Vastaa lyhyesti.", "input": "Miten TCP eroaa UDP:stä?" }' ``` ```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="Vastaa lyhyesti.", input="Miten TCP eroaa UDP:stä?", ) 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: "Vastaa lyhyesti.", input: "Miten TCP eroaa UDP:stä?", }); 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 takaa toimituksen ja järjestyksen, UDP ei, mutta on nopeampi…" } ] } ], "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } } ``` ## Todennus | Parametri | Tyyppi | Pakollinen | Kuvaus | | --- | --- | --- | --- | | `Authorization` | header | pakollinen | Avain muodossa `Bearer sk-…`. Myös seuraavat otsakkeet käyvät: `x-api-key` tai `x-goog-api-key`. | ## Pyynnön runko | Parametri | Tyyppi | Pakollinen | Kuvaus | | --- | --- | --- | --- | | `model` | string | pakollinen | 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. | | `input` | string \| array | pakollinen | Pyynnön teksti tai viestien ja osien taulukko (teksti, kuvat). | | `instructions` | string | valinnainen | Järjestelmäohje. | | `stream` | boolean | valinnainen | SSE-tapahtumavirta; viimeinen tapahtuma on `response.completed`. Maksullinen teksti saapuu yhtenä lohkona hinnan laskemisen jälkeen. | | `max_output_tokens` | integer | valinnainen | 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. | | `reasoning` | object | valinnainen | `{"effort": "low" \| "medium" \| "high"}` päättelymalleille. | | `tools` | array | valinnainen | Funktiot, joita malli voi kutsua. | | `text` | object | valinnainen | Vastauksen muoto, esimerkiksi `{"format": {"type": "json_schema", ...}}`. | | `temperature` | number | valinnainen | Vastauksen satunnaisuus, jos malli tukee sitä. | ## Vastaus | Parametri | Tyyppi | Pakollinen | Kuvaus | | --- | --- | --- | --- | | `output` | array | | Vastauksen elementit: viestit (`message`), päättely ja funktiokutsut. SDK:ssa on kätevää käyttää `output_text`. | | `status` | string | | `completed`, `incomplete` (raja saavutettu) tai `failed`. | | `usage` | object | | `input_tokens`, `output_tokens`, `total_tokens`. | Onko vielä kysyttävää? Lähetä Request ID ja kuvaus — autamme selvittämään asian.[Ota yhteyttä tukeen](mailto:support@ailoot.ai) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.