Introdução
O Z-Image Spicy Pro transforma um brief sem censura ou comum em uma única imagem nas dimensões que você define, com teto de 2560 pixels por lado. É um nível dedicado sem censura: sem indicador de maturidade, sem declaração, sem verificador entre a requisição e o modelo.
O Z-Image Spicy Pro é o nível sem censura de grande formato da linha Z-Image: largura e altura definidas de forma independente até 2560 pixels, um campo de prompt sem limite de tamanho, um expansor de prompt opcional que vem desligado e nenhum filtro de conteúdo.
Recursos e destaques
Um nível dedicado a imagens sem censura
O Z-Image Spicy Pro foi pensado para briefs visuais sem censura, e não como uma rota genérica com restrições afrouxadas. Deixe claros o contexto pretendido, o assunto e o tratamento visual, e depois confira o resultado em relação ao brief e à política aplicável.
Mais espaço para imagens de entrega
O nível Pro é para trabalhos que precisam de uma imagem final mais detalhada do que uma primeira passada de conceito. Avalie detalhes como material, luz e composição no posicionamento de entrega previsto, e não numa miniatura ampliada.
Preserve a redação intencional
Quando a redação de um brief sem censura importa, guarde a formulação aprovada junto com o resultado. Uma reescrita exploratória pode mudar a intenção da requisição, então compare cada variação posterior com as restrições originais.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Sem limite de caracteres. Descrição concreta de direção de luz, tecido, paleta e lente é bem aproveitada neste tamanho; adjetivos empilhados não. pelo menos 1 caracteres |
width | Não | Largura de saída em pixels, de 256 a 2560, padrão 1024. |
height | Não | Altura de saída em pixels, de 256 a 2560, padrão 1024. O quadro grande é opt-in — deixar este campo no padrão é o motivo mais comum de um resultado voltar menor do que o esperado. |
enable_prompt_expansion | Não | Reescreve um prompt curto em um mais longo antes da geração. Valor padrão: |
seed | Não | Passe o mesmo seed com o mesmo prompt e as mesmas dimensões para o sorteio ficar igual entre duas execuções; isso as torna comparáveis, mas não garante uma imagem idêntica. |
Preços
$0.019 / imagem
Casos de uso
Começar por um brief escrito
Use este endpoint para briefs sem censura ou comuns que precisam de uma imagem grande: width e height vão de 256 a 2560 e têm 1024 como padrão, então defina o tamanho de entrega de forma explícita. Deixe enable_prompt_expansion desligado e a redação chega como foi escrita.
Editorial sem censura em tamanho cheio
Retratos em high-key, composições em primeira pessoa e editoriais de moda gerados em 1728x2560, para a imagem ir direto para o layout. Sem uma passada de ampliação que invente detalhe de pele que nunca foi renderizado.
Prompts que outras APIs de imagem recusam
A redação sem censura passa sem mudanças com a expansão desligada, e a requisição é igual à de qualquer outro modelo aqui — criar a tarefa, consultar, baixar o arquivo do armazenamento da plataforma. Nada no trabalho sem censura segue outro caminho no código.
Rascunhos próximos da impressão
2560x1440 e 2048x2560 dão pixels suficientes para um rascunho que vai ser projetado ou impresso pequeno. Abaixo desse teto nada precisa de um ampliador, que é onde a maioria dos fluxos sem censura perde textura.
Guia de prompt e dicas práticas
Escreva o brief completo com a expansão desligada
Descreva a iluminação, o tecido, a pose e o cenário em termos concretos. O exemplo Pro desta página usa uma blusa de cetim preto, calça de seda e um abajur quente de hotel em 1728 × 2560. O briefing abaixo é o prompt registrado para essa imagem; ao adaptá-lo, observe o cetim, o acabamento em renda e as mãos como detalhes a conferir.
Compare no tamanho de entrega
Escolha primeiro as dimensões de entrega. Os tamanhos aceitos têm atualmente o mesmo preço por imagem, então um rascunho de 1024 × 1024 não reduz o custo da chamada. Mantenha seed e dimensões fixos ao mudar uma parte do briefing. Planeje o orçamento pelo número de variações. Uma seed de 0 pede um novo resultado aleatório.
Adapte o exemplo incluído
Comece pelo exemplo Pro registrado com width: 1728, height: 2560 e seed: 4217. A expansão fica desligada por padrão. Mude quarto, luz ou roupa um de cada vez e salve o prompt escolhido junto com a imagem.
Photograph of an adult woman in her thirties lying back across a hotel bed in an opaque black satin bralette with a thin scalloped lace trim along the edges and high-waisted black silk trousers, one arm above her head, looking at the camera with a slow smile. Low warm bedside lamp, city lights through the window, 50mm, soft film grain, editorial lingerie campaign.
O exemplo combina uma luminária de cabeceira baixa e quente com as luzes da cidade lá fora. Compare rosto, mão levantada, bordas de renda e separação do cetim preto e da calça de seda no tamanho final.
Confira o resultado antes de iterar
2560 pixels por lado é o teto; as duas dimensões têm 1024 como padrão, então uma imagem grande precisa ser pedida de forma explícita. Pares extremos — um lado muito longo contra um curto — vão além do que o modelo compõe bem, então mantenha o lado maior em no máximo cerca do dobro do menor, a não ser que o espaço vazio seja intencional. Deixar enable_prompt_expansion desligado é o caminho mais confiável para briefs sem censura. Aqui não há prompt negativo, entrada de imagem nem campo de formato de saída.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-spicy-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
