Messages: stateless текст

POST/v1/messages

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

Авторизация

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

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

x-api-keystring

Альтернатива для клиентов формата Messages: ключ в заголовке x-api-key.

Заголовки

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

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

anthropic-version"2023-06-01"

Тело запроса

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

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

messagesobject[]обязательныйэлементов 1–1000

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

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

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

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

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

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

Вариант 1

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

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

max_tokensintegerобязательный1 … 32768

systemstring

temperaturenumber0 … 1

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

Ответы

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

application/json

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

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

role"assistant"обязательный

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

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

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

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

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

modelstring

stop_reasonstring

Значения: "end_turn" "max_tokens"

billingobject

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

statusstring

estimated_cost_microrubinteger0 … 9007199254740991

cost_microrubinteger | null

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/messages" \ --header "Authorization: Bearer $KVANTORA_API_KEY" \ --header "Idempotency-Key: $REQUEST_ID" \ --header "Content-Type: application/json" \ --data '{ "model": "<public_api_id>", "messages": [ { "role": "user", "content": "Привет" } ], "max_tokens": 1 }'

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

const response = await fetch('https://api.kvantora.ai/v1/messages', { 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>", "messages": [ { "role": "user", "content": "Привет" } ], "max_tokens": 1 }), }); console.log(await response.json());

{ "id": "<string>", "type": "message", "role": "assistant", "model": "<public_api_id>", "content": [ { "type": "text", "text": "Привет" } ], "stop_reason": "end_turn", "usage": {}, "billing": { "status": "<string>", "estimated_cost_microrub": 0, "cost_microrub": 0 } }