Pular para o conteúdo principal
O tool @image gera imagens a partir de um prompt via o pacote llm/imagegen, local/keyless-first e multi-provedor.

​
Seleção de backend (local primeiro)

imagegen.NewFromEnv escolhe, degradando para null quando nada está configurado:
  1. CHATCLI_IMAGE_PROVIDER=sdwebui → Stable Diffusion WebUI local (/sdapi/v1/txt2img, default http://localhost:7860). Keyless — o caminho preferido.
  2. CHATCLI_IMAGE_URL → endpoint OpenAI-compatível (/images/generations). Cobre OpenAI, LocalAI e similares.
  3. OPENAI_API_KEY → OpenAI Images API (default gpt-image-1).
  4. CHATCLI_IMAGE_PROVIDER=responses (ou openai + CHATCLI_IMAGE_API=responses) → OpenAI Responses API, onde um modelo de chat como gpt-5.5 gera a imagem via a tool image_generation.
  5. GOOGLEAI_API_KEY/GEMINI_API_KEY → Google Imagen nativo (shape próprio, :predict).
  6. XAI_API_KEY → xAI grok-image nativo (shape OpenAI, omite size).
  7. CHATCLI_IMAGE_PROVIDER=bedrock → AWS Bedrock (Nova Canvas / Titan Image / Stability via InvokeModel, reusando a cadeia de credenciais do provider de chat).
CHATCLI_IMAGE_PROVIDER fixa o backend (sdwebui|url|openai|responses|google|xai|bedrock); CHATCLI_IMAGE_API escolhe images|responses no OpenAI; CHATCLI_IMAGE_MODEL ajusta o modelo.
Duas APIs OpenAI: a Images API (família gpt-image-2/1.5/1/1-mini) e a Responses API (gpt-5.5 e gpt-5+ via tool image_generation). No Bedrock, geração de imagem é pelos modelos dedicados (Nova/Titan/Stability), não pelos modelos de chat. Provedores de chat sem API de imagem (Anthropic, Ollama-texto…) não podem ser adicionados — o endpoint não existe.

​
Modelos & configuração por comando

@image models                         # catálogo + modelos da sua conta OpenAI
/config image                         # panorama (backend, api, modelo, url)
/config image provider responses      # troca o backend
/config image api responses           # OpenAI: Images vs Responses
/config image model gpt-5.5           # define o modelo
/config image models                  # lista o catálogo
/config image reset                   # limpa os overrides
Catálogo atual (resumo): OpenAI Images gpt-image-2, gpt-image-1.5, gpt-image-1, gpt-image-1-mini; OpenAI Responses gpt-5.5, gpt-5; Google imagen-3.0-generate-002; xAI grok-2-image, grok-imagine-image-quality; Bedrock amazon.nova-canvas-v1:0, amazon.titan-image-generator-v2:0, stability.sd3-5-large-v1:0, stability.stable-image-ultra-v1:1.

​
Tool @image

<tool_call name="@image" args='{"cmd":"gen","args":{"prompt":"uma raposa em aquarela","size":"1024x1024"}}' />
<tool_call name="@image" args='{"cmd":"status"}' />
SubcomandoFunção
gen {prompt, size?, n?, out?}gera imagem(ns) e salva em arquivo; out = arquivo (1 imagem) ou diretório (várias)
statusmostra o backend efetivo
O resultado reporta o(s) caminho(s) do(s) arquivo(s) gerado(s). Veja o backend em /config (Geração de imagem (@image)).

​
Privacidade & custo

  • Stable Diffusion WebUI local é keyless e mantém tudo na sua máquina — ideal para privacidade e custo zero.
  • Backends de nuvem usam a chave do próprio usuário.
  • Confirme antes de gerar lotes grandes; mencione o custo quando aplicável.

​
Relacionado