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âmetro | Tipo | Obrigatório | Descrição |
|---|
--prompt <text> | string | Sim | Descrição da imagem |
--model <model> | string | Não | ID do modelo (padrão: qwen-image-3.0) |
--size <W*H> | string | Não | Tamanho da imagem: proporção (3:4, 16:9, 1:1) ou pixels (2048*2048) |
--n <count> | number | Não | Número de imagens por solicitação (padrão: 1, máximo: 6) |
--seed <n> | number | Não | Semente aleatória para geração reprodutível |
--negative-prompt <text> | string | Não | Prompt negativo para excluir conteúdo indesejado |
--prompt-extend <bool> | boolean | Não | Habilitar 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> | boolean | Não | Habilitar marca d'água (true/false). Omita o sinalizador para usar a configuração do Perfil ou o padrão da CLI (true). |
--async | switch | Não | Retornar ID da tarefa assíncrona sem esperar |
--concurrent <n> | number | Não | Executar N solicitações simultâneas (padrão: 1) |
--out-dir <dir> | string | Não | Baixar imagens para diretório |
--out-prefix <prefix> | string | Não | Prefixo de nome de arquivo (padrão: image) |
--poll-interval <seconds> | number | Não | Intervalo 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âmetro | Tipo | Obrigatório | Descrição |
|---|
--image <url> | array | Sim | URL da imagem de origem ou caminho de arquivo local (repetível para mesclagem de múltiplas imagens) |
--prompt <text> | string | Sim | Texto da instrução de edição |
--model <model> | string | Não | ID do modelo (padrão: qwen-image-3.0) |
--size <W*H> | string | Não | Tamanho da imagem de saída: proporção (3:4, 16:9) ou pixels (2048*2048) |
--n <count> | number | Não | Número de imagens (padrão: 1, máximo: 6) |
--seed <n> | number | Não | Semente aleatória para resultados reprodutíveis |
--negative-prompt <text> | string | Não | Prompt negativo para excluir conteúdo indesejado |
--function <name> | string | Não | Função wanx*-imageedit (padrão: description_edit). Exemplos: stylization_all, description_edit |
--prompt-extend <bool> | boolean | Não | Habilitar extensão de prompt (true/false). Omissão do sinalizador para usar o padrão da CLI (true). |
--watermark <bool> | boolean | Não | Habilitar 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> | string | Não | Baixar imagens para diretório |
--out-prefix <prefix> | string | Não | Prefixo de nome de arquivo (padrão: edited) |
--async | switch | Não | Retornar ID da tarefa assíncrona sem esperar |
--concurrent <n> | number | Não | Executar N solicitações simultâneas (padrão: 1) |
--poll-interval <seconds> | number | Não | Intervalo 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.