ДОКУМЕНТАЦИЯ ДЛЯ РАЗРАБОТЧИКОВ · API V1

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

Подключите приложение, отправьте первый запрос или изучите протокол. Перед интеграцией проверьте актуальные модели и цены.

1

Tạo API Key

Lấy khoá bảo mật dạng sk-stk-... từ ví tài khoản để xác thực các request.

Mở Quản lý Key →
2

Chọn Base URL

Dùng https://apistack.vn cho Anthropic / Claude Code hoặc https://apistack.vn/v1 cho OpenAI SDK.

Xem chi tiết URL →
3

Chạy thử Request

Sao chép mã cURL hoặc mẫu Python / Node.js bên dưới để nhận phản hồi AI tức thì.

Xem mã mẫu ↓

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

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

Подготовка SDK и проверка API-ключа

Установите библиотеку для своего языка. Введите ключ скрытым вводом в Bash или PowerShell, затем вызовите GET /v1/models для проверки аутентификации и получения ID моделей. Этот запрос не генерирует ИИ-контент.

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

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

curl -N https://apistack.vn/v1/messages \
  -H "x-api-key: ${API_KEY:?Hãy đặt 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 Stack и введите ключ в мастере настройки. Проверяйте конфигурацию через API Stack doctor; запросы чата или ping также могут быть платными.

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

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

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

API Stack
Открыть полное руководство

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

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

← Все приложения

Жизненный цикл запроса

От API-запроса до расчёта

Запрос

Укажите endpoint, модель и тело по примеру. Храните API-ключ в переменных окружения или серверном хранилище секретов.

Выберите этап для подробностей. Схема объясняет процесс и не показывает состояние реального запроса.

Базовые URL

Выберите URL для SDK и протокола.

Anthropic https://apistack.vn

OpenAI https://apistack.vn/v1

Открыть полное руководство

Аутентификация

Защищайте ключи и используйте нужные заголовки.

Открыть полное руководство

Эндпоинты и протоколы

Сопоставляйте эндпоинт с возможностями модели.

Открыть полное руководство

Изображения, аудио и видео

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

Открыть полное руководство

Потоковые ответы

Обрабатывайте события, usage и конечные ошибки.

Открыть полное руководство

Оплата

Различайте токены, запросы и минимальную плату.

У некоторых моделей есть минимальная плата за вызов. Она может применяться и к короткому запросу; малое число токенов не означает бесплатный вызов.

Открыть полное руководство

Ошибки и повторы

Исследуйте ошибки по коду и ID запроса.

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

Посмотреть статус модели в разделе цен

Открыть полное руководство

Ограничения и тайм-ауты

Учитывайте прием запросов и тайм-ауты.

Открыть полное руководство

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

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

Открыть полное руководство

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

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

Открыть полное руководство

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

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

Открыть полное руководство

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

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

Открыть полное руководство

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

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

Открыть полное руководство

Примеры проходят проверку исходного кода и локальные проверки; это не подтверждает работу во всех версиях приложений. До эксплуатации проверьте настройки, небольшой запрос и usage.

Support