Справочник API tAI

Эндпоинт

Всё в этом API проходит через один URL:

# Base URL
https://api.artfical.com/v1

Есть один эндпоинт для завершений, POST /v1/chat/completions, и один эндпоинт только для чтения списка моделей, GET /v1/models. Это вся поверхность API. Нет отдельного эндпоинта для каждой модели, нет отдельного эндпоинта для потоковой передачи и обычного ответа (один и тот же URL обрабатывает оба случая, переключаясь по полю в теле запроса), и нет отдельного эндпоинта для ходов с вызовом инструментов. Если вы уже работали с Chat Completions API от OpenAI, инференс-эндпоинтами GitHub или любым из многочисленных провайдеров, предоставляющих совместимый с OpenAI формат, всё это покажется знакомым. Такое сходство сделано намеренно: если направить существующий OpenAI-совместимый клиент (официальный пакет openai для Python или Node, LangChain, LlamaIndex, агента вроде OpenCode или собственную тонкую обёртку) на https://api.artfical.com/v1 с ключом API tAI, всё должно заработать почти без изменений кода.

Кратчайший путь к первому запросу

Нужны три вещи: рабочее пространство на console.artfical.com, API-ключ, созданный на странице ключей API этого рабочего пространства, и любой HTTP-клиент. Вот самый короткий вариант, через curl:

# Замените tai-sk-... на ваш собственный ключ
curl https://api.artfical.com/v1/chat/completions \
  -H "Authorization: Bearer tai-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tai-4.1",
    "messages": [{"role": "user", "content": "Merhaba, kendini tanıt."}]
  }'

Этот единственный запрос — уже полноценная рабочая интеграция. Всё остальное в этом разделе: потоковая передача, вызов инструментов, ввод изображений, управление сэмплированием — необязательный слой поверх этого же формата, а не другой API, который нужно изучать заново. На странице Chat Completions подробно разобраны полный запрос и ответ; страница Аутентификация описывает, как сам ключ выдаётся, ограничивается по области действия и обновляется.

Как устроен этот раздел

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

Для кого этот раздел

Этот раздел написан для тех, кто пишет код, напрямую обращающийся к API, будь то бэкенд-сервис, скрипт или агентный фреймворк вроде OpenCode, который рассматривает tAI как одного из нескольких взаимозаменяемых OpenAI-совместимых провайдеров. Предполагается, что вы умеете делать HTTP-запросы и читать JSON, но не требуется никакого предварительного знакомства с tAI. Если вы, наоборот, ищете информацию о том, как пользоваться tAI через сам чат-продукт, это описано в основной документации tAI, а не в этом разделе. Если вы ищете информацию о том, как оценивается безопасность tAI и какими средствами защиты оснащён продукт, это раздел Безопасность. Этот же раздел посвящён именно HTTP API для разработчиков: что вы отправляете, что получаете в ответ и что означает каждое поле и заголовок.

О стабильности

Форматы запросов и ответов, описанные в этом разделе, — это те форматы, которые мы намерены поддерживать стабильными. Появление новых полей со временем — это нормально, по мере роста API стоит этого ожидать; а вот изменение смысла или исчезновение уже задокументированного поля без замены — то, чего мы не делаем походя. Если что-то действительно является временным решением или может измениться, соответствующая страница прямо об этом говорит, а не оставляет вас узнавать об этом на практике. Если поле или поведение нигде в этом разделе не упомянуто, считайте, что оно не входит в поддерживаемый контракт, даже если вы случайно наблюдаете его в ответе, — оно может измениться или исчезнуть без предупреждения.