Документация по интеграции ThAPI

Начинайте быстро

Установите библиотеки из примера, используйте поддерживаемую среду и задайте STALI_API_KEY в окружении. Замените пример модели доступной моделью с нужным протоколом.

read -r -s -p "STALI_API_KEY: " STALI_API_KEY
export STALI_API_KEY
printf '\n'
curl -fsS https://thapi.cloud/v1/models -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}"

Примеры cURL предназначены для Bash в macOS/Linux или WSL/Git Bash. Python запрашивает ключ, если STALI_API_KEY не задан; Node.js читает переменную окружения.

curl -N https://thapi.cloud/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Viết hàm quicksort bằng Python" }
    ]
  }'

Примеры генерации контента отправляют реальные запросы и могут повлечь расходы. До запуска проверьте единицы тарификации и минимальную плату за запрос.

Установить стали-кли

Требуется Node.js 18 или новее. Установите API CLI, затем запустите api-cli и введите ключ в мастере настройки. Проверяйте конфигурацию через api-cli doctor; запросы чата или ping также могут быть платными.

# Рекомендуется для Windows, macOS и Linux; нужен Node.js >= 18
npm install -g stali-cli@latest

# Альтернативный установщик: npm, резерв GitHub + Bun:
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | bash

# Только установка, без запуска мастера:
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | STALI_CLI_NO_RUN=1 bash

stali

Подключение приложений

Найдите инструкцию для инструмента и протокола.

Создание и редактирование изображений

JSON-интерфейсы для создания изображений, исходных данных, результатов и стоимости.

Создание видео

Создавайте видео по тексту и изображениям, отслеживайте прогресс и скачивайте MP4 через Videos API.

Чтение изображений

Проверьте форматы и жизненный цикл задач.

Заголовок ответа

Сохраните x-thapi-request-id, если он есть, и время ошибки. Не включайте API-ключи и конфиденциальные данные в отчеты.

Поиск неисправностей

Учитывайте Retry-After, используйте экспоненциальную задержку со случайным разбросом и ограничьте число попыток и общее время. Если видеозадача могла быть создана, сначала проверьте ее ID.