Introdução
O Qwen Image 2.1 LoRA Edição aplica os seus próprios pesos LoRA enquanto revisa de uma a dez imagens de referência. É a mesma configuração de pesos personalizados do endpoint de texto para imagem, só que apontada para um trabalho que você já tem em vez de para um quadro em branco.
Não há revisão dos pesos que você carrega nem filtro de conteúdo sobre o resultado.
Escolha o modo do Qwen Image 2.1 LoRA pelo material de partida
| Material de partida | Modo |
|---|---|
| Imagens de origem mais os seus próprios pesos | Qwen Image 2.1 LoRA Edição de imagem |
| Um briefing mais os seus próprios pesos | Qwen Image 2.1 LoRA Texto para imagem |
| Edição sem pesos personalizados | Qwen Image 2.1 Edição de imagem |
Recursos e destaques
Leve um LoRA de personagem para um trabalho já em andamento
Um LoRA com que você só consegue começar algo novo é bem menos útil do que um que você aplica a um quadro já aprovado. Este endpoint aceita os dois: até dez referências e até três arquivos de pesos na mesma requisição.
Pesos e referências resolvem metades diferentes da consistência
As referências seguram a composição, o cenário e o quadro específico; o LoRA segura a identidade em todos os quadros. Usar os dois é mais estável do que apostar pesado em um só.
Sem censura dos dois lados
Sem revisão dos pesos, sem filtro na saída, e uma origem continua como está a menos que a instrução diga o contrário.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Esta família não tem prompt negativo, então as exclusões também moram aqui. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a dez imagens de referência. O modelo não atribui papéis por conta própria, então diga no prompt o que cada fonte entrega. pelo menos 1 itens · no máximo 10 itens |
aspect_ratio | Não | Compõe o quadro antes da geração, em vez de recortar depois. São quinze opções, das faixas 3:1 e 21:9 às colunas 1:3 e 9:21. |
resolution | Não | Define o tamanho da saída e o preço: 1k por padrão, 1.5k no meio, 2k onde a textura da pele e o tecido se sustentam. Itere em 1k e promova o quadro escolhido para 2k. |
loras | Não | Até três arquivos de pesos, cada um {path, scale}. Valor padrão: |
output_format | Não | JPEG por padrão; PNG para composição, WebP para ir direto a uma página. Não muda o preço nem o resultado da geração. |
seed | Não | Estabiliza o sorteio para que uma série fique na mesma vizinhança. |
Preços
| Especificação | Preço |
|---|---|
| $0.042 / imagem |
| $0.078 / imagem |
| $0.15 / imagem |
Casos de uso
Aplicar um LoRA de personagem a fotos que você já aprovou
A parte cara de um ensaio raramente é a geração — é chegar a um quadro que todo mundo aprovou. Este endpoint deixa você guardar esse quadro e mudar quem está nele: mande a composição aprovada como referência, carregue o LoRA de personagem e deixe os pesos carregarem a identidade enquanto a luz, a encenação e o enquadramento ficam exatamente onde estavam.
Trazer um acervo antigo para o estilo atual da casa
Aponte um LoRA de estilo para trabalhos gerados meses atrás. Mande os quadros antigos como referências, carregue os pesos de estilo em um scale moderado e rode tudo de novo, para que uma foto de arquivo e uma nova convivam na mesma página sem emenda aparente.
Cena adulta montada a partir de uma referência sua
Comece de uma figura que você mesmo gerou e acrescente a segunda pessoa, o figurino, a contenção ou o cenário. Instruções são cumpridas como foram escritas e pesos sem censura carregam sem revisão, então a cena pode ser montada por etapas em vez de apostada em um prompt só.
Trocas de figurino e de locação com a pessoa fixa
Duas referências — uma carregando a pessoa, outra carregando a roupa ou o ambiente — mais um LoRA de personagem, e um prompt que diz qual origem é qual. Troque o cômodo, mantenha o rosto; troque a roupa, mantenha os dois.
Guia de prompt e dicas práticas
Diga o que cada referência entrega antes de dizer o que muda
O modelo não deduz papéis pela ordem nem pelo nome do arquivo. Escreva: "a primeira imagem é a mulher, a segunda é o cômodo em que ela está, a terceira é o casaco." Sem essa frase, uma requisição com várias referências mistura as fontes em vez de editar com elas, e o resultado parece um artefato de média, não um erro que você consiga depurar.
Não deixe o prompt e o LoRA descreverem a mesma coisa
Quando um LoRA de personagem está carregado, descreva a cena, a ação e a luz — não o rosto. Repetir características que os pesos já codificam puxa a geração para dois lados e costuma produzir algo que não se parece com nenhum deles. Deixe o LoRA ser dono da identidade e o prompt, dono de tudo em volta.
Ponha as proteções na instrução, porque não há prompt negativo
Diga com todas as letras o que precisa sobreviver à edição: "mantenha-a exatamente como na origem, sem acrescentar nada ao figurino" ou "não mude o comprimento do cabelo." Um modelo de edição entregue ao próprio julgamento vai arrumar coisas que você não pediu para arrumar e, em trabalho sem censura, essa arrumação é o modo de falha inteiro.
Calcule o preço da requisição antes de enviar, não depois
Duas coisas movem o custo aqui ao mesmo tempo: a quantidade de referências e o nível de resolução, com o adicional do LoRA por cima. Dez referências com três LoRAs em 2k é a combinação mais cara que esta família aceita. A estimativa anterior ao envio é o que vale — leia-a nas requisições grandes em vez de supor que só o nível define o preço.
Confirme que um LoRA novo muda alguma coisa antes de confiar um lote a ele
Pesos construídos para outra arquitetura base podem carregar sem nenhum erro e ter quase nenhum efeito visível. Rode um prompt deliberadamente evidente contra os pesos novos, confirme que a saída mudou e só então coloque o lote na fila.
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/qwen-image-2.1-lora/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
