Introdução
Wan 2.7 Texto para imagem transforma uma direção de arte escrita em uma imagem nova. Use quando composição, assunto, luz e hierarquia visual precisam ser desenhados a partir de um brief.
Escolha o modo do Wan 2.7 pelo material de partida
| O que você tem no início | Modo |
|---|---|
| um brief visual escrito | Wan 2.7 Texto para imagem |
| uma imagem que precisa de uma mudança dirigida | Wan 2.7 Edição de imagem |
Recursos e destaques
A edição com nove imagens desenha o que você escreveu
Dê uma referência ao image-to-image e ele desenha o briefing que você enviou, figurino e enquadramento incluídos. Nesta plataforma não há flag de conteúdo nem declaração por requisição em nenhum dos dois endpoints — a diferença está no modelo. No text-to-image ele responde a um prompt delicado com um quadro mais comportado. A cena do café desta página é text-to-image, uma camisa branca larga com chuva na janela, e é mais ou menos aí que o endpoint de texto para.
Combine até nove imagens sem pintar máscara nenhuma
O image-to-image aceita de uma a nove imagens de origem numa única requisição, então uma peça de roupa, um rosto, um ambiente e uma referência de cor podem entrar todos na mesma edição. Diga no prompt para que serve cada fonte — uma pilha sem rótulo vira média, que é o motivo mais comum de uma edição com nove imagens voltar embolada.
Ele planeja a composição antes de desenhar
O Wan 2.7 planeja o quadro antes de desenhá-lo, e isso aparece no que exige uma decisão espacial: quem está em primeiro plano, o que a mão está segurando, onde fica a fonte de luz. Prompts descritivos longos, com um sujeito claro e uma relação clara, rendem mais que pilhas de palavras-chave aqui.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva o quadro: sujeito, ação, posição de câmera, e então luz e lente. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 ou 2:3. Padrão 1:1. |
enable_thinking | Não | O modelo analisa o prompt antes de gerar. Desligado fica bem mais rápido e, com prompts detalhados, quase não muda o resultado. Valor padrão: |
num_outputs | Não | De 1 a 4, cada uma com seu próprio seed sobre o mesmo briefing. |
resolution | Não | 1k ou 2k; padrão 1k. O 2k tem quatro vezes os pixels do 1k, e o enquadramento continua seguindo |
color_palette | Não | Tema de cores opcional com 3 a 10 cores (8 é o recomendado). pelo menos 3 itens · no máximo 10 itens |
seed | Não | De 0 a 2147483647. Mantenha fixo e mude uma oração por vez: com o mesmo seed o sorteio não muda, então o que se mexeu foi só a oração. |
Preços
$0.03 / imagem
Casos de uso
Explorar um conceito visual antes da produção
Texto para imagem é o endpoint para uma imagem em que nada está definido ainda: nenhum rosto, peça de roupa ou ambiente que precise sobreviver. Escreva assunto, ação, posição da câmera, luz e lente, e peça até quatro leituras de uma vez com num_outputs; cada uma é um seed diferente sobre o mesmo brief e é cobrada como uma imagem própria.
Criar a imagem-chave de um storyboard
Gere o quadro em 3:2 ou 9:16 e depois entregue-o a um endpoint de imagem para vídeo como quadro inicial. O prompt de vídeo passa a carregar só o movimento, que é o jeito mais direto de levar um figurino e uma pose exatos para um clipe.
Definir o sistema visual de uma campanha
Mantenha um seed e um esqueleto de prompt e depois varie aspect_ratio entre 1:1, 3:2 e 9:16 para um perfil, um banner e um card de story. O orçamento de pixels é o mesmo para todas as proporções, então uma imagem mais larga é mais larga, não maior.
Guia de prompt e dicas práticas
Primeiro a composição, depois a decoração
Diga o assunto, o que ele está fazendo e onde está a câmera antes da luz, dos materiais e do estilo. O Wan 2.7 planeja a imagem antes de desenhá-la, então uma relação espacial clara vale mais que uma pilha de adjetivos.
Fixe o seed e mude uma coisa só
Quando uma imagem estiver perto, mantenha seed e mude uma única parte: o figurino, a luz, a proporção. O mesmo seed mantém o sorteio estável, então qualquer diferença que você vir é a parte que mudou; isso não garante uma imagem idêntica.
Confira a área da imagem antes de reutilizá-la
No padrão 1k, a imagem tem cerca de 1,01 a 1,05 megapixel qualquer que seja a proporção, e resolution: 2k dá cerca de quatro vezes isso. Só com texto, o modelo inventa um rosto novo a cada seed, então quando alguém precisa continuar reconhecível, passe para a edição de imagem com uma referência. Desligar enable_thinking é bem mais rápido.
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/wan-2.7/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"num_outputs": 1,
"aspect_ratio": "1:1"
}
}'
# 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.





























