Integrações

CLI

Gere imagens, vídeos e edições direto do terminal ou de qualquer script. Assíncrono com --wait, saída --json para automação, upload automático de arquivos locais.

Instalação

bash

npm install -g @caranguejo/cli

bash

curl -fsSL https://caranguejo.art/install.sh | sh

bash

pnpm add -g @caranguejo/cli

Autenticação

bash

# cole sua chave ck_live_… (Conta → Apps & API)
caranguejo auth login
# ou via variável de ambiente (CI):
export CARANGUEJO_API_KEY=ck_live_xxxxxxxx

Comandos

Comando	Descrição
`auth login \| status \| logout`	Gerencia a chave salva (`~/.caranguejo/config.json`)
`models list [--type image\|video\|tool]`	Lista o catálogo de modelos e tools
`models get <slug>`	Capacidades e campos de um modelo
`generate <slug> [opções]`	Geração genérica (qualquer modelo/tool)
`generate image --prompt …`	Atalho para imagem (gpt-image-2)
`upload <arquivo>`	Hospeda um arquivo e imprime a URL pública
`generations list \| get <id>`	Suas gerações via API
`balance`	Saldo de créditos

Opções de generate: --prompt, --image/--start-frame/--end-frame/--audio (url ou arquivo local, auto-upload), --aspect, --duration, --quality, --resolution, --param chave=valor (repetível), --wait, --json.

Exemplos

Imagem

bash

caranguejo generate image --prompt "um caranguejo numa praia neon, cinematográfico" \
  --quality high --resolution 2K --size 3:2 --wait

Vídeo (imagem→vídeo)

bash

# descubra os modelos de vídeo disponíveis
caranguejo models list --type video
# gere a partir de uma foto local (upload automático)
caranguejo generate <video-model-slug> --prompt "gire o produto 360°" \
  --start-frame ./produto.png --duration 5 --aspect 9:16 --wait

Tool (upscale)

bash

caranguejo generate upscale --image ./foto.jpg --param scale=4 --wait

Automação (JSON)

bash

URL=$(caranguejo generate image --prompt "logo de caranguejo" --wait --json \
  | jq -r '.output.images[0].url')
echo "$URL"