Completions (Legacy)

Legacy endpoint для completion-style запросов.

POST /v1/completions

Устаревший API

Этот endpoint сохранён для совместимости. Для новых проектов рекомендуется использовать Chat Completions.

Описание

Создаёт completion на основе prompt (текстовый ввод без ролей). Поддерживается ограниченным числом моделей.

Заголовки

Заголовок	Обязательный	Описание
Authorization	Да	Bearer YOUR_API_KEY
Content-Type	Да	application/json

Тело запроса

{
  "model": "gpt-4o",
  "prompt": "Напиши стихотворение о весне:",
  "max_tokens": 200,
  "temperature": 0.7
}

Параметры

Параметр	Тип	Обязательный	Описание
model	string	Да	ID модели
prompt	string/array	Да	Текст для completion
max_tokens	integer	Нет	Максимум токенов
temperature	number	Нет	Случайность (0.0-2.0)
top_p	number	Нет	Nucleus sampling
stop	string/array	Нет	Стоп-последовательности
stream	boolean	Нет	Потоковая передача
suffix	string	Нет	Суффикс после completion
echo	boolean	Нет	Включить prompt в ответ

Ответ

{
  "id": "cmpl-abc123",
  "object": "text_completion",
  "created": 1706745600,
  "model": "gpt-4o",
  "choices": [
    {
      "text": "\n\nВесна пришла, и солнце светит ярко,\nПрирода пробуждается от сна...",
      "index": 0,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 45,
    "total_tokens": 53
  }
}

Пример

cURL

curl https://api.aipomogator.ru/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o",
    "prompt": "Переведи на английский: Привет, мир!",
    "max_tokens": 50
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.aipomogator.ru/v1"
)

response = client.completions.create(
    model="gpt-4o",
    prompt="Переведи на английский: Привет, мир!",
    max_tokens=50
)

print(response.choices[0].text)

Миграция на Chat Completions

Вместо:

{
  "model": "gpt-4o",
  "prompt": "Напиши стихотворение о весне:"
}

Используйте:

{
  "model": "gpt-4o",
  "messages": [
    {"role": "user", "content": "Напиши стихотворение о весне"}
  ]
}

Поддерживаемые модели

Не все модели поддерживают completion API. Рекомендуется использовать Chat Completions для максимальной совместимости.