Responses: stateless текст

POST/v1/responses

Требуемое право: text. Неизвестные поля и неподдерживаемые формы отклоняются до резервирования. Совместимость ограничена этой схемой.

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Заголовки

Idempotency-Keystringобязательныйдлина 1–200

Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

Тело запроса

application/json · обязательное

modelstringобязательныйдлина 1–200

inputstring | object[]обязательный

Вложенные поля

Один из вариантов

Вариант 1

rolestringобязательный

Значения: "system" "developer" "user" "assistant"

contentstring | object[]обязательный

Вложенные поля

Один из вариантов

Вариант 1

type"input_text"обязательный

textstringобязательный

type"message"

instructionsstring

max_output_tokensintegerпо умолчанию 2048 · 1 … 32768

temperaturenumber0 … 2

streamfalseпо умолчанию false

storefalseпо умолчанию false

Ответы

200Успешный ответ

application/json

idstringобязательный

object"response"обязательный

modelstringобязательный

statusstringобязательный

Значения: "completed" "incomplete"

outputobject[]обязательный

usageobjectобязательный

billingobject

Вложенные поля

statusstring

estimated_cost_microrubinteger0 … 9007199254740991

cost_microrubinteger | null

storefalse

202Исход уточняется; резерв сохраняется

application/json

Обработка или сверка ещё не завершена. Сохраняйте исходный Idempotency-Key и тело. Резерв удерживается. Не создавайте новый запрос взамен этого.

Тип: object

ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный

Вложенные поля

codestringобязательный

messagestringобязательный

request_idstring

typestring

curl --request POST \ --url "https://api.kvantora.ai/v1/responses" \ --header "Authorization: Bearer $KVANTORA_API_KEY" \ --header "Idempotency-Key: $REQUEST_ID" \ --header "Content-Type: application/json" \ --data '{ "model": "<public_api_id>", "input": "Привет" }'

import os import requests response = requests.post( "https://api.kvantora.ai/v1/responses", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", "Idempotency-Key": os.environ["REQUEST_ID"], }, json={ "model": "<public_api_id>", "input": "Привет", }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/responses', { method: 'POST', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'Idempotency-Key': process.env.REQUEST_ID, 'Content-Type': 'application/json', }, body: JSON.stringify({ "model": "<public_api_id>", "input": "Привет" }), }); console.log(await response.json());

{ "id": "<string>", "object": "response", "model": "<public_api_id>", "status": "completed", "output": [ {} ], "usage": {}, "billing": { "status": "<string>", "estimated_cost_microrub": 0, "cost_microrub": 0 }, "store": false }