~/ Документация API / completions

POST/completions

Классическое текстовое дополнение (legacy). Принимает строку prompt вместо массива сообщений.

https://api.aiadapter.ru/api/v1/completions

Параметры тела

modelstringrequiredМодель

Идентификатор модели из каталога.

promptstringrequiredПромпт

Текст, который модель продолжит.

max_tokensЛимит ответа

Ограничивает максимальное число токенов, которое модель сгенерирует в ответе. Это потолок длины именно ответа, не считая токенов запроса; сумма запроса и ответа не может превышать размер контекстного окна. Если лимит мал, ответ может оборваться на середине. Параметр также влияет на стоимость, так как выходные токены тарифицируются отдельно.

temperatureТемпература

Управляет случайностью выбора следующего токена. Значение около 0 делает ответы почти детерминированными и предсказуемыми — модель каждый раз выбирает наиболее вероятное продолжение. Более высокие значения (0.7–1.0 и выше) повышают разнообразие и «креативность», но и риск ошибок и бессвязности. Для фактических задач и кода обычно берут низкую температуру, для генерации идей и текстов — выше.

stopСтоп-последовательности

Список строк, при появлении которых генерация немедленно останавливается. Сами стоп-строки в ответ не включаются, что удобно для обрезания вывода по разделителю или маркеру конца. Часто используется в структурированных промптах и при ролевой разметке диалога. Можно задать несколько последовательностей одновременно.

Пример

curl https://api.aiadapter.ru/api/v1/completions \
  -H "Authorization: Bearer sk-aa-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"anthropic/claude-opus-4.8","prompt":"Жили-были"}'

import requests

r = requests.post(
    "https://api.aiadapter.ru/api/v1/completions",
    headers={"Authorization": "Bearer sk-aa-v1-..."},
    json={
    "model": "anthropic/claude-opus-4.8",
    "prompt": "Жили-были"
},
)
print(r.json())

const res = await fetch("https://api.aiadapter.ru/api/v1/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-aa-v1-...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"model":"anthropic/claude-opus-4.8","prompt":"Жили-были"}),
});
console.log(await res.json());

Ответ HTTP 200

{
  "id": "gen-def456",
  "object": "text_completion",
  "model": "anthropic/claude-opus-4.8",
  "choices": [
    {
      "index": 0,
      "text": " дед да баба…",
      "finish_reason": "length"
    }
  ],
  "usage": {
    "prompt_tokens": 4,
    "completion_tokens": 16,
    "total_tokens": 20,
    "cost_rub": 0.03
  }
}