Modellix

Visão Geral

Modellix é uma plataforma de Modelo como Serviço (Model-as-a-Service) para geração ou transcrição de imagens, vídeos e áudio por IA. Esta habilidade ensina os agentes a usar o fluxo de trabalho oficial modellix-cli (doctor → model run --wait → task download).

Pacote upstream: https://github.com/Modellix/modellix-plugin/tree/main/skills/modellix (Layout de Plugins Abertos; árvore de habilidades em skills/modellix/).

Quando Usar Esta Habilidade

• Gerar imagens a partir de prompts de texto
• Gerar ou editar vídeos a partir de texto ou imagens
• Gerar áudio a partir de texto, transcrever áudio ou transformar uma voz em outra
• Chamar modelos Modellix através de uma API/CLI unificada
• O usuário menciona Modellix, Seedream, Seedance, Nano Banana, Whisper, Qwen Audio, CosyVoice ou provedores similares através do Modellix

Como Funciona

1. Autenticar com MODELLIX_API_KEY ou modellix-cli auth login
2. Executar modellix-cli doctor --json
3. Usar modelos padrão quando não especificados (T2I: google/nano-banana-2-lite, T2V: bytedance/seedance-2.0-mini-t2v, I2I: google/nano-banana-2-lite-edit, I2V: bytedance/seedance-2.0-fast-i2v, V2V: bytedance/seedance-2.0-fast-v2v, TTS: alibaba/qwen-audio-3.0-tts-flash, STT: openai/whisper-1, STS: alibaba/cosyvoice-clone)
4. Submeter com modellix-cli model run --wait --json
5. Persistir saídas com modellix-cli task download

Exemplos

Texto para Imagem

modellix-cli model run \
  --model-slug google/nano-banana-2-lite \
  --body '{"prompt":"A cinematic sunset over a futuristic city"}' \
  --wait --timeout 5m --json

Texto para Vídeo

modellix-cli model run \
  --model-slug bytedance/seedance-2.0-mini-t2v \
  --body '{"prompt":"Ocean waves under a cloudy sunset"}' \
  --wait --timeout 10m --json

Texto para Áudio

modellix-cli model run \
  --model-slug alibaba/qwen-audio-3.0-tts-flash \
  --body '{"text":"There is a large garden behind my house.","voice":"longanhuan_v3.6"}' \
  --wait --timeout 5m --json

Áudio para Texto

modellix-cli model run \
  --model-slug openai/whisper-1 \
  --body '{"url":"https://example.com/meeting.mp3"}' \
  --wait --timeout 5m --json

Áudio para Áudio

modellix-cli model run \
  --model-slug alibaba/cosyvoice-clone \
  --body '{"model":"cosyvoice-v3.5-plus","url":"https://example.com/reference.wav","text":"There is a large garden behind my house."}' \
  --wait --timeout 5m --json

Melhores Práticas

• Preferir a CLI model run --wait em vez de polling manual
• Antes de uma submissão paga, divulgar o provedor, modelo, prompt ou mídia de origem que sairá da máquina, o custo esperado e o caminho da saída; obter aprovação explícita do usuário
• Preferir o uso de chave de API com escopo de sessão; executar modellix-cli auth login apenas quando o usuário aprovar o armazenamento persistente de credenciais locais
• Não tentar novamente submissões pagas cegamente após resultados desconhecidos — verificar task history
• Confirmar o destino e a política de sobrescrita antes de task download; nunca substituir um arquivo existente sem aprovação explícita
• Baixar resultados antes que expirem; URLs de resultados hospedados são mantidos por cerca de 7 dias
• Obter esquemas de requisição de model describe docs_url ou https://docs.modellix.ai/llms.txt

Notas de Segurança e Proteção

• Requer uma chave de API Modellix; nunca imprimir segredos em logs
• Prompts e mídia de origem carregada saem da máquina para processamento api.modellix.ai e do CDN Modellix
• Geração paga consome o saldo da conta e não deve ser submetida ou retentada sem a aprovação descrita acima

Limitações

• Requer uma conta Modellix, acesso à rede, uma chave de API válida e saldo de conta suficiente.
• A disponibilidade de modelos, esquemas de requisição, preços, cotas, moderação e tempo de geração são controlados pelo Modellix e podem mudar.
• Saídas geradas requerem revisão humana para qualidade, direitos, privacidade e conformidade com políticas antes da publicação.
• Esta habilidade documenta apenas o fluxo de trabalho da CLI; não define um fallback REST nem garante que uma tarefa remota concluída seja baixada com sucesso.