Introdução
O Z-Image Spicy transforma um brief sem censura ou comum em uma única imagem nas dimensões que você mesmo define. É um nível dedicado sem censura, e não um modelo genérico com ajustes afrouxados: entre a requisição e o modelo não há indicador de maturidade, declaração nem verificador.
O Z-Image Spicy é o nível sem censura da linha Z-Image: largura e altura exatas em pixels até 1536, um campo de prompt sem limite de tamanho, um expansor de prompt opcional que vem desligado e nenhum filtro de conteúdo em todo o caminho.
Recursos e destaques
Um nível dedicado a imagens sem censura
O Z-Image Spicy 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.
A redação intencional continua sendo parte da direção de arte
Guarde o brief aprovado junto com o resultado escolhido. Assim, uma variação posterior pode mudar uma decisão visual sem alterar em silêncio a intenção ou os limites da requisição.
Revise a composição onde ela vai ser usada
Avalie assunto, pose, cena e luz no lugar em que a imagem vai ser usada. Uma miniatura plausível não basta se a imagem escolhida perder a relação visual necessária na entrega.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Sem limite de caracteres. pelo menos 1 caracteres |
width | Não | Largura de saída em pixels, de 256 a 1536, definida de forma independente da altura. |
height | Não | Altura de saída em pixels, de 256 a 1536, definida de forma independente da largura. |
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
| Especificação | Preço |
|---|---|
| $0.01235 / imagem |
| $0.0133 / imagem |
Casos de uso
Começar por um brief escrito
Use este endpoint para briefs sem censura ou comuns que precisam de um tamanho exato em pixels. Defina width e height entre 256 e 1536, deixe enable_prompt_expansion desligado para que a redação chegue como foi escrita e fixe seed quando um visual funcionar.
Prompts que outras APIs de imagem recusam
Redações sem censura que endpoints com filtro rejeitam passam sem mudanças, e com a expansão desligada nada as reescreve no caminho. O mesmo ciclo de vida de tarefa de qualquer outro modelo aqui: criar, consultar, baixar do armazenamento da plataforma.
Peças no tamanho exato do posicionamento
Arte de card em 832x1216, um cabeçalho em 1536x512, uma miniatura quadrada em 512x512 — tudo do mesmo endpoint, tudo nativo em vez de recortado, o que mantém o assunto onde o layout espera.
Séries de retrato e moda
Luz dura atravessando persianas, linho amassado, renda e seda no tamanho que você escolher. Fixe um seed quando um visual funcionar e então leve o mesmo assunto por vários ambientes e figurinos para montar uma série que pareça um único ensaio.
Guia de prompt e dicas práticas
Escreva o briefing completo, expansão desligada
Não há limite de caracteres, então descreva por inteiro figurino, direção da luz, visual de filme e paleta. A imagem publicada saiu de: “Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.”
Diga o tamanho da imagem em pixels
Defina largura e altura pelo posicionamento em vez de escolher uma proporção — 1024x1536 para um retrato, 1536x640 para um cabeçalho, 512x512 para uma miniatura. Os dois lados aceitam qualquer valor de 256 a 1536.
Adapte o exemplo incluído
Comece pelo exemplo publicado com height: 1536 e width: 1024. Troque o assunto e a direção criativa, mas mantenha o contrato de entrada deste modo.
Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.
O prompt por trás da imagem de referência deste endpoint, em 1024x1536 e com a expansão desligada para que a redação chegasse intacta ao modelo. A imagem mostrada foi produzida no nível Turbo da mesma linha como referência de estilo.
Confira o resultado antes de iterar
1536 pixels é o teto de cada lado, então este não é o nível para uma peça em tamanho de impressão — gere aqui e amplie em outro lugar se precisar de uma imagem grande. Pares de dimensões extremos vão além do que o modelo compõe bem; 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: ligá-lo pode generalizar a redação exata que você escolheu. Este endpoint não tem prompt negativo nem entrada de imagem.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"enable_prompt_expansion": false
}
}'
# 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.












