MiniMax CLI — Guia de Habilidades do Agente

Use mmx para gerar texto, imagens, vídeo, voz, música e realizar pesquisas na web através da plataforma de IA MiniMax.

Quando Usar

Use esta habilidade quando o usuário quiser gerar ou inspecionar texto, imagens, vídeo, voz, música, resultados de pesquisa na web ou recursos da API MiniMax através do terminal CLI mmx.

Pré-requisitos

# Install
npm install -g mmx-cli

# Auth (OAuth persists to ~/.mmx/credentials.json, API key persists to ~/.mmx/config.json)
mmx auth login --api-key sk-xxxxx

# Verify active auth source
mmx auth status

# Or pass per-call
mmx text chat --api-key sk-xxxxx --message "Hello"

A região é detectada automaticamente. Substitua com --region global ou --region cn.

Flags do Agente

Sempre use estas flags em contextos não interativos (agente/CI):

Comandos

chat de texto

Conclusão de chat. Modelo padrão: MiniMax-M3. Passe --model MiniMax-M2.7 para o modelo padrão da geração anterior ao reproduzir saídas mais antigas.

mmx text chat --message <text> [flags]

# Single message (uses MiniMax-M3 by default)
mmx text chat --message "user:What is MiniMax?" --output json --quiet

# Multi-turn with system prompt
mmx text chat \
  --system "You are a coding assistant." \
  --message "user:Write fizzbuzz in Python" \
  --output json

# Pin to the previous-generation model
mmx text chat --model MiniMax-M2.7 --message "user:Hello" --output json

# From file
cat conversation.json | mmx text chat --messages-file - --output json

gerar imagem

Gera imagens através do MiniMax. Use este comando para tarefas de texto para imagem, miniaturas, arte conceitual, visuais sociais e iteração rápida de prompts. Modelo: image-01.

mmx image generate --prompt <text> [flags]

# Machine-readable response for agents
mmx image generate --prompt "A cat in a spacesuit" --output json --quiet

# Save multiple generated images to a directory
mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet

# Select region explicitly when a workflow must stay on one MiniMax endpoint family
mmx image generate --prompt "Product hero image" --region global --output json --quiet
mmx image generate --prompt "Product hero image" --region cn --output json --quiet

Notas do agente:

• Prefira --output json --quiet --non-interactive quando outra ferramenta for analisar o resultado.
• Use --dry-run antes de chamadas baseadas em API ao validar argumentos ou exemplos de CI.
• Mantenha a mídia gerada em um diretório de saída local da tarefa e valide os caminhos de arquivo ou URLs retornados antes de reutilizá-los.

gerar vídeo

Gera vídeo. O padrão atual v2 é MiniMax-H3 (2K, 4–15 segundos); os modelos legados v1 Hailuo permanecem disponíveis quando explicitamente selecionados. As solicitações usam o endpoint regional v2: https://api.minimax.io/v2/video_generation (global) ou https://api.minimaxi.com/v2/video_generation (China).

mmx video generate --prompt <text> [flags]

Para MiniMax-H3, o conteúdo da solicitação é um array ordenado de itens {type, role, ...}. O conteúdo de texto é obrigatório (até 7.000 caracteres); URLs de imagem, vídeo e áudio podem usar os papéis first_frame, last_frame, reference_image, reference_video e reference_audio. Papéis de quadro e papéis de referência são mutuamente exclusivos, e áudio de referência requer uma imagem ou vídeo. Defina --resolution 2K, --duration para um inteiro de 4 a 15, e --ratio para adaptive, 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Solicitações da China também podem definir aigc_watermark. A resposta de criação retorna task_id; consulte com GET /v2/query/video_generation/{task_id}, liste com GET /v2/query/video_generation e exclua com DELETE /v2/video_generation/{task_id}. As respostas de consulta expõem status, erro, URL de saída, resolução, duração, proporção, tipo/modalidade da tarefa e segundos de uso/contagem de imagens. O preço para vídeo MiniMax-H3 é medido por segundos de saída 2K: global USD 0,13/segundo, China CNY 0,8/segundo. Vídeo de referência de entrada é global USD 0,02/segundo e China CNY 0,8/segundo; áudio de referência é gratuito; cinco imagens de referência são gratuitas, depois global USD 0,03/imagem ou China CNY 0,2/imagem.

…