Z-Image Spicy e Spicy Pro: projete o quadro antes de gerar

Escolha Z-Image Spicy para imagens geradas por texto de até 1536 pixels por lado, a partir de $0.01235 por imagem. Escolha Spicy Pro quando um lado precisar passar de 1536, até 2560 pixels, por $0.019. Ambas são tarefas de texto para imagem sem censura. Nenhuma aceita imagem de referência, então use um editor separado quando um rosto aprovado precisa permanecer igual.

As duas aceitam briefings sem censura exatamente como foram escritos, com a expansão de prompt desligada; nos nossos testes de setembro de 2026, o Spicy perdeu parte da cena uma vez no pedido mais exigente, e o Pro não (detalhes: o Z-Image é sem censura?). Abaixo: uma bailarina adulta fictícia totalmente vestida com um leque coral, primeiro um retrato e depois uma imagem larga de anúncio.

Escolha a tela e o preço juntos

Envie width e height; não existe o campo aspect_ratio. Telas úteis: 960 × 1200 para um cartão 4:5, 864 × 1536 para um quadro de story 9:16, 1536 × 864 para 16:9, tudo dentro do Spicy padrão. Escolha o Pro para 2560 × 1440 ou qualquer quadro com 1600 pixels de largura: o Spicy recusa uma largura de 1600, e cortar apenas a largura para 1536 muda a proporção silenciosamente.

A cobrança é por imagem, não por pixel, então um quadro Pro de 2560 × 2560 custa os mesmos $0.019 que um quadrado de 1024, e um rascunho pequeno não economiza nada. Uma tela diferente também muda a imagem mesmo com a mesma seed, então faça o rascunho no tamanho que você vai entregar. Mantenha o lado maior dentro de cerca de duas vezes o lado menor, a menos que o espaço vazio seja justamente o objetivo.

Teste primeiro o retrato no Playground

1. Abra a página do Z-Image Spicy e fique na aba Playground, na visão Form. Entre com uma conta com saldo para executar.
2. Coloque Width em 960 e Height em 1200, deixe Prompt expansion desligada e informe uma Seed como 314159.
3. Cole o prompt abaixo em Prompt e execute o modelo; verifique o leque, as mãos e os sapatos antes de usar o resultado.

A página irmã de texto para imagem do Z-Image, não a página do Spicy: a visão Form com o campo Prompt e o botão Run.

Imagem editorial de moda natural de uma bailarina adulta fictícia de 32 anos, ensaiando sozinha em um estúdio silencioso. Ela veste uma blusa azul-cobalto de manga longa, uma saia marfim e sapatos de ensaio simples. Corpo inteiro em um leve quarto de volta, os dois sapatos apoiados no chão de madeira. Uma mão segura o cabo de um leque coral aberto e dobrável ao lado do ombro, com a pegada visível e o leque longe do rosto. A outra mão fica relaxada. Parede ocre lisa, luz lateral suave, espaço generoso acima do leque e abaixo dos sapatos. Sem letras, sem espelhos, sem pessoas extras nem leques adicionais.

Sem campo de prompt negativo, as exclusões vão no prompt, então a última frase é a salvaguarda. As palavras que definem o leque, a mão e o quadro trabalham mais do que uma sequência de adjetivos de "obra-prima". Mantenha a primeira pose parada o bastante para ver qual mão segura o objeto; explore um movimento de dança completo só depois que o conceito de figurino funcionar.

Ilustração, não um resultado do modelo-alvo: a pegada visível no eixo de abertura do leque é a relação que este prompt pede.

Para comparar candidatos, mude uma cláusula e execute de novo com uma seed diferente a cada vez. O corpo da requisição no Playground é o mesmo JSON que a API aceita, então uma configuração que funciona aqui é copiada direto para o código. Para o Pro, abra a página do Z-Image Spicy Pro e use os mesmos campos com limites maiores.

Depois execute pelo código

Instale o SDK do Python (pip install spicyapi), defina SPICY_API_KEY no ambiente do seu servidor e execute:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="alibaba/z-image-spicy/text-to-image",
    input_data={
        "prompt": "Natural editorial fashion image of one fictional adult dancer aged 32, rehearsing alone in a quiet studio. She wears a cobalt long-sleeved blouse, an ivory skirt and simple rehearsal shoes. Complete body in a gentle quarter turn, both shoes resting on the wooden floor. One hand holds the handle of one open coral folding fan beside her shoulder, with the grip visible and the fan away from her face. Her other hand hangs relaxed. Plain ochre wall, soft side light, generous room above the fan and below the shoes. No lettering, mirrors, extra people or additional fans.",
        "width": 960,
        "height": 1200,
        "enable_prompt_expansion": False,
        "seed": 314159,
    },
    idempotency_key=str(uuid.uuid4()),
)

print("Task", task["taskId"], flush=True)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"{task['taskId']} ended as {final['state']}: {final.get('errorCode')}")
assets = output_assets(final)
if not assets or any(
    not asset.get("url") or asset.get("pending") or asset.get("unavailable")
    for asset in assets
):
    raise RuntimeError(f"{task['taskId']} has no complete downloadable output; look up this task before retrying")
print(assets[0]["url"])  # copy the image to your own storage now

Criar, esperar, baixar, repetir e códigos de erro estão no guia de tarefas e na referência do SDK do Python. Os resultados expiram, então veja retenção e entrega antes de construir sobre o link retornado.

Ou deixe um Agent executar

Quando um assistente deve fazer as gerações, as três ferramentas oficiais mostram o preço e pedem confirmação antes de uma chamada paga.

• CLI. Coloque o mesmo objeto input em input.json e então:

``bash spicyapi tasks create --model alibaba/z-image-spicy/text-to-image --input-file input.json --wait ``

Veja a documentação da CLI; npx @spicyapi/cli funciona sem instalação.

• Servidor MCP. Adicione o servidor MCP ao seu assistente e então pergunte: "Run Z-Image Spicy at 960 by 1200 with this prompt, prompt expansion off." Ele chama spicyapi_task_create, que aguarda sua confirmação do preço, e depois spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instala o Agent Skill, que faz um assistente de código ler o esquema do modelo ao vivo em vez de adivinhar campos.

Torne a imagem larga uma composição nova e deliberada

Mude para width: 1536, height: 864. No prompt do retrato, substitua "Corpo inteiro em um leve quarto de volta, os dois sapatos apoiados no chão de madeira." pelas duas primeiras frases abaixo e "espaço generoso acima do leque e abaixo dos sapatos" pela terceira:

Coloque a bailarina inteira no lado esquerdo de quem vê, em um leve quarto de volta, com os dois sapatos apoiados no chão de madeira. Mantenha o leque totalmente aberto longe da borda da imagem. Reserve o terço direito como uma parede ocre visualmente tranquila para o texto do evento adicionado separadamente.

Esta é uma nova imagem gerada por texto, não uma edição do retrato, e a mesma seed não vai levar o rosto aprovado de uma tela para outra. Quando a identidade precisar coincidir, mantenha o retrato escolhido e use um editor de imagem capaz de usar referências ou um processo comum de recorte e composição para o banner.

Depois adicione o título, a data e o local reais na sua ferramenta de design; uma parede vazia é um pedido de composição, não a promessa de um texto gerado escrito corretamente. Se a parede sair estreita demais, mova o texto para fora da imagem em vez de cobrir o leque.

Corrija estas falhas antes de passar para o Pro

O Pro não corrige anatomia nem composição; revise o briefing primeiro e só suba quando um lado tiver de passar de 1536.

Expansão e seeds

Deixe a expansão de prompt desligada. Ela reescreve o prompt antes da geração e pode generalizar uma formulação que você escolheu de propósito, e isso importa mais para briefings voltados a adultos. Ligue-a apenas para um conceito de uma linha, em que você aceitará uma cena diferente; ela acrescenta $0.00095 por imagem no Spicy padrão e nada no Pro.

A página do modelo diz que uma seed omitida (ou 0) gera um resultado aleatório, mas repetir um pedido sem seed devolveu a mesma imagem nos dois níveis nos nossos testes, então envie uma seed diferente para cada candidato. Uma seed mantém uma geração comparável, mas não garante uma imagem idêntica, então salve os arquivos que você escolher em vez de confiar em um número para recriá-los.

Ilustração, não um resultado do modelo-alvo: as impressões físicas substituem a análise de conceitos de retrato.

Orçamento e decisão

Quatro candidatos do Spicy padrão com a expansão desligada custam $0.0494; quatro candidatos do Pro custam $0.076. Comece no Spicy para tudo o que couber em 1536 pixels; pague pelo Pro quando o posicionamento exigir um lado maior e corrija o briefing, não a versão, quando a anatomia ou a composição estiverem erradas.