Pular para o conteúdo principal

Linha de comando

Gere imagens e vídeo direto do terminal

O comando spicyapi permite ver modelos, consultar um preço exato, iniciar uma geração e baixar o resultado, sem escrever código. Comandos pagos sempre param e pedem confirmação antes.

Criar uma chave de APIGuia completo na documentação

Para que serve a CLI

É o jeito mais rápido de testar um modelo: digite um comando, veja o preço exato, diga sim e receba o arquivo. Sem projeto, sem código.

  1. Você digita um comandoTerminal ou PowerShell
  2. spicyapiMostra o preço exato e pergunta antes
  3. Seu resultadoUm link de download, ou JSON para scripts
Navegar, consultar preços e baixar é grátis. Só criar ou repetir uma tarefa gasta dinheiro.

Ideal para

  • Testar modelos rápidoCompare modelos e preços antes de alguém escrever código.
  • Scripts de shellEnvie a saída de --json para o jq, jobs agendados ou etapas de CI.
  • Agentes de programaçãoAgentes rodam comandos e leem o resultado em JSON.

Configure em dois minutos

  1. Passo 1

    Instale o Node.js 22.13 ou mais recente

    Rode node -v. Se aparecer uma versão mais antiga, instale a versão LTS em nodejs.org e reabra o terminal.

    terminal
    node -v
  2. Passo 2

    Coloque sua chave em SPICY_API_KEY

    A CLI lê a chave só do ambiente. Ela nunca é aceita como argumento nem impressa, então não vaza pelo histórico do shell.

    export SPICY_API_KEY="sk-spicy-..."   # paste your own key
  3. Passo 3

    Rode com npx ou instale uma vez

    O npx roda a versão mais recente sem instalar nada. Instale globalmente se for usar todo dia.

    npx @spicyapi/cli status

Sua primeira imagem pelo terminal

Encontre um modelo que você pode chamar, confira o preço exato e então crie a tarefa e espere o resultado. Coloque a entrada em um arquivo para evitar problemas com aspas no shell.

  1. Passo 1

    Encontre um modelo

    Liste os modelos de imagem que você pode chamar, com os preços.

    models list
    spicyapi models list --modality image --json
  2. Passo 2

    Confira o preço

    Coloque seu prompt em um arquivo e veja o custo exato. Nada é cobrado.

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

    Crie e espere

    A CLI mostra o preço, pede o seu sim e espera o resultado.

    tasks create
    spicyapi tasks create \
  --model MODEL_ID_FROM_CATALOG \
  --input-file input.json \
  --wait
  4. Passo 4

    Baixe

    Salve o arquivo pelo link do resultado antes que ele expire.

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

O que você pode fazer

Só dois comandos gastam dinheiro, e os dois mostram o preço e esperam o seu sim.

  1. Explorar

    01
    • spicyapi status

      Verificar se a SpicyAPI está acessível

      Grátis
    • spicyapi models list

      Listar os modelos disponíveis, com preços

      Grátis
    • spicyapi models get <model>

      Mostrar as configurações exatas que um modelo aceita

      Grátis
    • spicyapi balance

      Consultar seu saldo

      Grátis

  2. Preço

    02
    • spicyapi tasks quote

      Ver o preço exato antes de começar

      Grátis

  3. Gerar

    03
    • spicyapi tasks create

      Iniciar uma geração de imagem ou vídeo

      Pede confirmação antes de cobrar
    • spicyapi tasks wait <task-id>

      Aguardar uma geração terminar

      Grátis
    • spicyapi tasks get <task-id>

      Mostrar uma geração e os links do resultado

      Grátis

  4. Arquivos

    04
    • spicyapi files upload <path>

      Enviar uma imagem, vídeo ou áudio como entrada

      Grátis
    • spicyapi files download-url <task-id>

      Gerar um novo link de download para um resultado

      Grátis

Feita também para scripts e agentes de IA

Adicione --json a qualquer comando para receber o resultado completo em JSON; os erros saem como uma linha JSON no stderr e, em caso de falha, o código de saída é diferente de zero. Agentes de programação podem rodar a CLI diretamente ou usar o servidor MCP para uma integração mais rica.

MCP e agentesAbrir pacoteVer código-fonte
--json
spicyapi --json tasks get <task-id> > task.json

Corrija os erros mais comuns

A maioria dos problemas de primeira viagem é um destes três. Cada card mostra o que você vê e a única coisa a mudar.

  • $

    command not found: spicyapi

    A instalação global não está no seu PATH. Rode npx @spicyapi/cli, ou reinstale com npm install -g @spicyapi/cli.

  • chave

    Chave não definida

    SPICY_API_KEY só vale na janela em que você a definiu. Defina de novo, ou adicione ao perfil do seu shell.

  • node

    Node.js desatualizado

    A CLI exige o Node.js 22.13 ou mais recente. Confira com node -v e instale a versão LTS atual.

Perguntas frequentes