zeighy/image-gen

Geração de imagens via relé

Use o script relay.sh na pasta desta skill (a mesma pasta deste SKILL.md). Ele lê a URL e o token do relé do arquivo relay.env ao lado (ou de IMAGE_RELAY_URL / IMAGE_RELAY_TOKEN se definidos), chama o relé e salva as imagens como arquivos. Execute com bash, usando o caminho completo.

Nunca imprima, exiba ou mostre o token ou o relay.env, e nunca coloque o token em uma linha de comando.

Gerar

bash /caminho/para/image-gen/relay.sh generate "Uma raposa aquarela em uma floresta nevada" --aspect 16:9

Opções:

• --aspect R: um de 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
• --n N: número de imagens (1-4)
• --model M: apenas se o usuário pedir um modelo específico; execute relay.sh models para listar os permitidos
• --out DIR: onde salvar (padrão: /mnt/user-data/outputs quando existe, caso contrário o diretório atual)

As linhas de saída são parecidas com saved: /caminho/abc123.jpg (512345 bytes, relay file: abc123.jpg). Mostre ou anexe os arquivos salvos ao usuário. Mantenha os nomes relay file para edições posteriores.

Aguardando resultados

A geração pode levar minutos, então o relé a executa como um trabalho em segundo plano. relay.sh generate submete o trabalho e verifica a cada ~30 segundos (o intervalo que o relé solicita) por até 90 segundos. Se a imagem estiver pronta, você receberá as linhas saved: como de costume.

Se ele imprimir pending: job <id> ..., o trabalho ainda está em execução no relé e não foi perdido. Aguarde o número de segundos indicado (ex.: sleep 30) e então execute:

bash /caminho/para/image-gen/relay.sh result <id>

Enquanto espera, o script pode informar que o trabalho está "being checked" (o relé ainda está revisando a solicitação) ou "accepted, generating". Repita até que ele imprima linhas saved: ou um erro. Não reenvie o prompt enquanto um trabalho estiver pendente: isso geraria (e cobraria) uma segunda imagem. --wait SEGUNDOS altera quanto tempo uma chamada espera (padrão 90).

Editar ou usar imagens de referência

Passe os arquivos de imagem do usuário com --image (repetível, até 4 no total; PNG, JPEG, WebP ou GIF, máx. 10 MB cada):

bash /caminho/para/image-gen/relay.sh generate "Deixe o céu roxo, mantenha todo o resto igual" --image /caminho/para/foto.jpg

Para refinar uma imagem gerada anteriormente na conversa, passe o nome do arquivo de relé com --ref (mais rápido que reenviar; arquivos de relé expiram após 24 horas):

bash /caminho/para/image-gen/relay.sh generate "Adicione uma pequena lua no canto superior direito" --ref abc123.jpg

--ref também aceita uma URL de imagem https://.

Criação de prompts

Escreva um prompt específico que cubra o assunto, estilo, composição, iluminação e cores. Para edições, diga o que mudar e o que manter.

Erros

O script imprime error: HTTP <código> <nome_código>: <mensagem>:

• rate_limited: aguarde os segundos indicados e repita uma vez.
• model_not_allowed, invalid_aspect_ratio, invalid_n: corrija a opção e repita.
• invalid_input_images / 413: a imagem não é de um tipo suportado ou é muito grande; converta ou reduza sua resolução.
• upstream_error (ex.: "não respondeu a tempo"): o relé já tentou novamente por conta própria. Informe o usuário e reenvie uma vez; se falhar novamente, pare e reporte.
• request_rejected: o relé não aceitou a solicitação (não dá motivo). Informe o usuário que foi rejeitada; não adivinhe a causa, reescreva ou disfarce o prompt ou as imagens para contornar, nem reenvie.
• prompt_rejected: a política de conteúdo do relé bloqueou o prompt. Informe o usuário; não reformule o prompt para contornar o filtro.
• image_rejected: uma imagem de referência foi bloqueada pela política de conteúdo. Informe o usuário; não tente novamente com a mesma imagem nem tente disfarçá-la.
• no_image: nenhuma imagem foi produzida; reformule o prompt.
• job_not_found / job_lost: o ID do trabalho expirou ou o servidor o abortou; envie o prompt novamente.
• could not reach: o acesso de rede ao domínio do relé está bloqueado. Informe o usuário para permitir o domínio em Configurações → Capacidades (saída de rede).
• unauthorized: o token está ausente, errado ou expirado. Informe o usuário; não tente encontrar outro token.