Skip to main content

Geração e Edição de Imagens

Referência de comandos da CLI Bailian para geração e edição de imagens.

Um único comando invoca as capacidades de geração e edição de imagens do Bailian a partir do terminal.
Anexe --help a qualquer comando para obter detalhes completos dos parâmetros, por exemplo: bl image generate --help. Todos os parâmetros que aceitam uma URL de arquivo também aceitam um caminho local — a CLI faz o upload automático para armazenamento temporário (válido por 48 horas), portanto você nunca precisa hospedar arquivos como URLs. Os detalhes dos comandos nesta página são verificados com o bl 2.8.0.

Referência de comandos

bl image generate

Gerar imagens (Qwen-Image / wan2.x). Requer autenticação com chave de API. Uso
bl image generate --prompt <text> [flags]
ParâmetroTipoObrigatórioDescrição
--prompt <text>stringSimDescrição da imagem
--model <model>stringNãoID do modelo (padrão: qwen-image-3.0)
--size <W*H>stringNãoTamanho da imagem: proporção (3:4, 16:9, 1:1) ou pixels (2048*2048)
--n <count>numberNãoNúmero de imagens por solicitação (padrão: 1, máximo: 6)
--seed <n>numberNãoSemente aleatória para geração reprodutível
--negative-prompt <text>stringNãoPrompt negativo para excluir conteúdo indesejado
--prompt-extend <bool>booleanNãoHabilitar extensão de prompt (true/false). Omissão do sinalizador: true para qwen-image sincronizado; parâmetro omitido em modelos assíncronos (padrão da API).
--watermark <bool>booleanNãoHabilitar marca d'água (true/false). Omita o sinalizador para usar a configuração do Perfil ou o padrão da CLI (true).
--asyncswitchNãoRetornar ID da tarefa assíncrona sem esperar
--concurrent <n>numberNãoExecutar N solicitações simultâneas (padrão: 1)
--out-dir <dir>stringNãoBaixar imagens para diretório
--out-prefix <prefix>stringNãoPrefixo de nome de arquivo (padrão: image)
--poll-interval <seconds>numberNãoIntervalo de polling durante espera (padrão: 3)
Exemplo: Gerar uma imagem a partir de um prompt de texto
bl image generate --prompt "A cat in a spacesuit on Mars"
  • --model auto (ou um modelo padrão auto na configuração) roteia modelos AIGC automaticamente pelo MCP desenvolvido pela Bailian e usa apenas os parâmetros suportados pelas ferramentas MCP. Parâmetros incompatíveis, como --seed, --watermark e --async, falham com erro de uso em vez de recorrer ao REST.

bl image edit

Editar uma imagem existente com instruções de texto (Qwen-Image / Wan 2.7). Requer autenticação com chave de API. Uso
bl image edit --image <url> --prompt <text> [flags]
ParâmetroTipoObrigatórioDescrição
--image <url>arraySimURL da imagem de origem ou caminho de arquivo local (repetível para mesclagem de múltiplas imagens)
--prompt <text>stringSimTexto da instrução de edição
--model <model>stringNãoID do modelo (padrão: qwen-image-3.0)
--size <W*H>stringNãoTamanho da imagem de saída: proporção (3:4, 16:9) ou pixels (2048*2048)
--n <count>numberNãoNúmero de imagens (padrão: 1, máximo: 6)
--seed <n>numberNãoSemente aleatória para resultados reprodutíveis
--negative-prompt <text>stringNãoPrompt negativo para excluir conteúdo indesejado
--function <name>stringNãoFunção wanx*-imageedit (padrão: description_edit). Exemplos: stylization_all, description_edit
--prompt-extend <bool>booleanNãoHabilitar extensão de prompt (true/false). Omissão do sinalizador para usar o padrão da CLI (true).
--watermark <bool>booleanNãoHabilitar marca d'água (true/false). Omita o sinalizador para usar a configuração do Perfil ou o padrão da CLI (true).
--out-dir <dir>stringNãoBaixar imagens para diretório
--out-prefix <prefix>stringNãoPrefixo de nome de arquivo (padrão: edited)
--asyncswitchNãoRetornar ID da tarefa assíncrona sem esperar
--concurrent <n>numberNãoExecutar N solicitações simultâneas (padrão: 1)
--poll-interval <seconds>numberNãoIntervalo de polling durante espera (padrão: 3)
Exemplo: Editar uma imagem usando uma instrução de texto
bl image edit --image ./photo.png --prompt "Replace the background with a beach"
  • --model auto roteia modelos AIGC automaticamente pelo MCP desenvolvido pela Bailian e usa apenas os parâmetros suportados pelas ferramentas MCP. Parâmetros incompatíveis falham com erro de uso em vez de recorrer ao REST. A edição automática aceita apenas um --image.