Перейти к основному контенту

Командная строка

Генерируйте изображения и видео из терминала

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

Создать API-ключПолное руководство в документации

Для чего нужен CLI

Это самый быстрый способ попробовать модель: введите команду, увидите точную цену, подтвердите — и файл у вас. Без проекта и без кода.

  1. Вы вводите командуТерминал или PowerShell
  2. spicyapiПоказывает точную цену и спрашивает
  3. Ваш результатСсылка для скачивания или JSON для скриптов
Просмотр, расчёт цены и скачивание бесплатны. Деньги списываются только при создании или повторе задачи.

Подходит для

  • Быстрые пробы моделейСравнивайте модели и цены, пока никто не написал ни строки кода.
  • Shell-скриптыПередавайте вывод --json в jq, плановые задания или шаги CI.
  • Агенты для программированияАгенты запускают команды и читают результат в JSON.

Настройка за две минуты

  1. Шаг 1

    Установите Node.js 22.13 или новее

    Выполните node -v. Если выводится более старая версия, установите LTS с nodejs.org и заново откройте терминал.

    terminal
    node -v
  2. Шаг 2

    Положите ключ в SPICY_API_KEY

    CLI читает ключ только из переменной окружения. Он не принимается аргументом и никогда не выводится, поэтому не попадёт в историю командной оболочки.

    export SPICY_API_KEY="sk-spicy-..."   # paste your own key
  3. Шаг 3

    Запускайте через npx или установите один раз

    npx запускает последнюю версию без установки. Если пользуетесь ежедневно, установите CLI глобально.

    npx @spicyapi/cli status

Первое изображение из терминала

Найдите доступную модель, проверьте точную цену, затем создайте задачу и дождитесь результата. Входные данные лучше положить в файл — так не будет проблем с кавычками в оболочке.

  1. Шаг 1

    Найдите модель

    Выведите список моделей изображений, которые можно вызвать, с ценами.

    models list
    spicyapi models list --modality image --json
  2. Шаг 2

    Узнайте цену

    Положите промпт в файл и получите точную стоимость. Ничего не списывается.

    tasks quote
    echo '{ "prompt": "A cinematic night portrait" }' > input.json
spicyapi tasks quote --model MODEL_ID_FROM_CATALOG --input-file input.json
  3. Шаг 3

    Создайте и дождитесь

    CLI покажет цену, спросит подтверждение и дождётся результата.

    tasks create
    spicyapi tasks create \
  --model MODEL_ID_FROM_CATALOG \
  --input-file input.json \
  --wait
  4. Шаг 4

    Скачайте файл

    Сохраните файл по ссылке на результат, пока она не истекла.

    download
    curl -L -o result.png "PASTE_THE_URL_HERE"

Что можно делать

Деньги тратят только две команды, и обе показывают цену и ждут вашего «да».

  1. Обзор

    01
    • spicyapi status

      Проверяет, доступен ли SpicyAPI

      Бесплатно
    • spicyapi models list

      Выводит доступные вам модели с ценами

      Бесплатно
    • spicyapi models get <model>

      Показывает точные настройки, которые принимает модель

      Бесплатно
    • spicyapi balance

      Показывает ваш баланс

      Бесплатно

  2. Цена

    02
    • spicyapi tasks quote

      Называет точную цену до запуска

      Бесплатно

  3. Генерация

    03
    • spicyapi tasks create

      Запускает генерацию изображения или видео

      Спрашивает перед списанием
    • spicyapi tasks wait <task-id>

      Ждёт завершения генерации

      Бесплатно
    • spicyapi tasks get <task-id>

      Показывает генерацию и ссылки на результат

      Бесплатно

  4. Файлы

    04
    • spicyapi files upload <path>

      Загружает изображение, видео или аудиофайл как входные данные

      Бесплатно
    • spicyapi files download-url <task-id>

      Выдаёт новую ссылку для скачивания результата

      Бесплатно

Подходит и для скриптов, и для ИИ-агентов

Добавьте --json к любой команде, чтобы получить полный результат в JSON: ошибки выводятся одной JSON-строкой в stderr, а при сбое код возврата отличен от нуля. Агенты для программирования могут запускать CLI напрямую или подключить MCP-сервер для более глубокой интеграции.

MCP и агентыОткрыть пакетИсходный код
--json
spicyapi --json tasks get <task-id> > task.json

Частые ошибки и как их исправить

Почти все проблемы на старте — одна из этих трёх. На каждой карточке: что вы видите и что нужно изменить.

  • $

    command not found: spicyapi

    Глобальная установка не попала в PATH. Запускайте npx @spicyapi/cli или переустановите: npm install -g @spicyapi/cli.

  • ключ

    Ключ не задан

    SPICY_API_KEY действует только в том окне, где вы его задали. Задайте заново или добавьте в профиль оболочки.

  • node

    Устаревший Node.js

    Для CLI нужен Node.js 22.13 или новее. Проверьте командой node -v и поставьте текущую LTS-версию.

Частые вопросы