Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Чат

Создать чат

Запрашивает типовой ответ для данного разговора в чате. Поддерживает как потоковый, так и непотоковый режимы с одной OpenAI-совместимой формой запроса/ответа для каждой модели и поставщика.

POST/api/v1/chat/completions

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

modelобязательно

string

Используемая модель с указанием поставщика, например. «опенай/gpt-4.1». Короткие идентификаторы из распространенных семейств моделей (например, «gpt-4o») автоматически преобразуются в полный канонический идентификатор («openai/gpt-4o»); значения, уже находящиеся в канонической форме, остаются без изменений. Нераспознанный короткий идентификатор не перезаписывается принудительно — вместо этого разрешение модели выдает явную ошибку «модель не найдена».

minLength: 1

Example: "openai/gpt-4.1"

messagesобязательно

Message[]

Массив сообщений диалога, хотя бы одно. У каждого есть роль (система/пользователь/помощник/инструмент) и контент.

minLength: 1

models

string[]

Список резервных моделей — пробуется по порядку, используется только после того, как исчерпана собственная группа кандидатов основной модели.

stream

boolean

true передает ответ как SSE; Если значение опущено или имеет значение false, возвращается один ответ JSON.

temperature

number

Температура отбора проб: чем выше, тем более случайным, чем ниже, тем более детерминированным.

0–2

max_tokens

integer

Максимальное количество токенов, которые может сгенерировать ответ.

max_completion_tokens

integer

Псевдоним max_tokens с идентичной семантикой.

top_p

number

Порог выборки ядра.

0–1

top_k

integer

Ограничивает выборку K токенами с наибольшей вероятностью.

frequency_penalty

number

Наказывает токены в зависимости от того, как часто они уже появлялись.

-2.0–2.0

presence_penalty

number

Наказывает токены в зависимости от того, появились ли они вообще, независимо от количества.

-2.0–2.0

repetition_penalty

number

Коэффициент штрафа за повторение — отдельный механизм от штрафа за частоту/присутствие.

min_p

number

Минимальный порог вероятности относительно наиболее вероятного токена.

0–1

top_a

number

Другой механизм выборки с динамическим отсечкой, масштабирующий порог по квадрату максимальной вероятности.

seed

integer

Детерминированная начальная выборка; не все поставщики гарантируют воспроизводимость.

n

integer

Количество завершений, которые необходимо сгенерировать.

stop

string | string[]

Последовательности, при которых генерация прекращается, до 4.

tools

Tool[]

Список определений инструментов/функций, которые может вызывать модель.

tool_choice

string | object

Определяет, будет ли модель принудительно вызывать инструмент.

parallel_tool_calls

boolean

Разрешить ли параллельные вызовы инструментов, когда инструменты предоставляются. По умолчанию правда. Только для моделей семейства OpenAI — автоматически удаляется, если целевая модель не является собственной моделью OpenAI, это не ошибка.

response_format

object

Ограничивает формат вывода, например. {type:"json_object"} или {type:"json_schema"} со схемой JSON.

logit_bias

object

Сопоставляет идентификаторы токенов со значениями смещения [-100, 100], добавленными перед выборкой. Только для моделей семейства OpenAI — автоматически удаляется, если целевая модель не является собственной моделью OpenAI, это не ошибка.

logprobs

boolean

Возвращает вероятности журнала каждого выходного токена. Только для моделей семейства OpenAI — автоматически удаляется, если целевая модель не является собственной моделью OpenAI, это не ошибка.

top_logprobs

integer

Количество токенов, которые с наибольшей вероятностью вернутся на позицию (требуется logprobs: true). Только для моделей семейства OpenAI — автоматически удаляется, если целевая модель не является собственной моделью OpenAI, это не ошибка.

0–20

user

string

Идентификатор конечного пользователя для мониторинга и обнаружения злоупотреблений. На биллинг не влияет. Только для моделей семейства OpenAI — автоматически удаляется, если целевая модель не является собственной моделью OpenAI, это не ошибка.

reasoning

object

Объект управления мышлением модели рассуждения (например, {effort, max_tokens}).

reasoning_effort

string

Плоское сокращение для рассуждения.усилие.

lowmediumhigh

image_config

object

Параметры создания/редактирования изображения (используются, когда модальности включают изображение).

modalities

string[]

Запрошенные методы вывода. Включая маршруты изображений через путь отправки генерации изображений.

textimage

plugins

object[]

Массив плагинов (например, {id:"web"} для включения веб-поиска). Поддерживается только на некоторых модельных маршрутах, в других местах не действует; вариант модели :online автоматически вводит {id:"web"}, также только на вспомогательные маршруты.

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

Примеры ответов

Успех. BazaarLink нормализует ровно два поля — модель и удаление поля поставщика — и пересылает остальную часть ответа восходящего потока как есть, включая такие поля, как Native_finish_reason, system_fingerprint и аргументация, которые присутствуют только тогда, когда их заполняет этот конкретный поставщик. Usage.cost является исключением: всегда рассчитываемая сумма BazaarLink, а не значение, передаваемое из восходящего потока.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}