O modelo Wanxiang General Image Editing wan2.5 edita e funde imagens a partir apenas de instruções de texto, mantendo a consistência do assunto em todas as edições.
Visão geral do modelo
Capacidades do modelo | Exemplo de entrada | Imagem de saída |
|---|---|---|
Edição de imagem única | ![]() | ![]() Substitua o vestido floral por um vestido de renda estilo vintage com bordados delicados na gola e nos punhos. |
Fusão de múltiplas imagens | ![]() | ![]() Coloque o despertador da imagem 1 ao lado do vaso sobre a mesa de jantar na imagem 2. |
Nome do modelo | Descrição do modelo | Especificações da imagem de saída |
|---|---|---|
wan2.5-i2i-preview | Wanxiang 2.5 preview Suporta edição de imagem única e fusão de múltiplas imagens | Formato da imagem: PNG. Resolução da imagem:
|
Pré-requisitos
Antes de fazer uma chamada, obtenha uma chave de API e exporte a chave de API como uma variável de ambiente. Para fazer chamadas usando o SDK, instale o DashScope SDK.
Chamada de API HTTP
A edição de imagens leva de 1 a 2 minutos, portanto a API usa invocação assíncrona: Criar tarefa → Consultar resultado.
O tempo real de execução varia conforme o tamanho da fila e a carga do service.
Etapa 1: Criar uma tarefa e obter o ID da tarefa
Região Singapore: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Região Beijing: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Substitua {WorkspaceId} pelo seu ID do workspace real.
- Após criar a tarefa, use o
task_idretornado para consultar o resultado. Otask_idé válido por 24 horas. Não crie tarefas duplicadas. Em vez disso, use polling para recuperar o resultado. - Para orientações destinadas a iniciantes, consulte Chamar APIs com Postman ou cURL.
Parâmetros da solicitação | |
Cabeçalhos da solicitação | |
Content-Type string (Obrigatório)O tipo de conteúdo da solicitação. Deve ser application/json. | |
Authorization string (Obrigatório)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
X-DashScope-Async string (Obrigatório)Ativa o processamento assíncrono. Solicitações HTTP suportam apenas chamadas assíncronas. Deve ser enable. | |
Corpo da solicitação | |
model string (obrigatório)Nome do modelo. Modelos suportados e preços.Valor de exemplo: wan2.5-i2i-preview. | |
input object (obrigatório)Campos de entrada, como o prompt e as imagens.
Propriedades prompt string (obrigatório)Um prompt positivo descrevendo elementos e características visuais a serem incluídos na imagem gerada.Suporta chinês e inglês. Máximo: 2000 caracteres (cada caractere conta como um); o excesso é truncado.Para dicas de escrita de prompts, consulte o Guia de prompts de texto para imagem.Valor de exemplo: Um gato laranja alegre sentado, realista e detalhado.images array of string (obrigatório)Um array de URLs de imagens.
string (opcional)Um prompt negativo descrevendo elementos a serem excluídos da imagem.Suporta chinês e inglês. Máximo: 500 caracteres; o excesso é truncado.Valor de exemplo: baixa resolução, erros, melhor qualidade, baixa qualidade, incompleto, dedos extras, proporções ruins. | |
parameters object (opcional)Controla resolução, reescrita de prompt e marca d'água.
Propriedades size string (opcional)Define a resolução da imagem de saída no formato width×height. Padrão: 1280×1280.
Resoluções e proporções recomendadas
size for omitido, o padrão será 1280×1280 pixels com proporção aproximada:
integer (opcional)Número de imagens a gerar. Faixa: 1–4. Padrão: 4. Defina como 1 durante testes para controlar custos.watermark boolean (opcional)Adiciona uma marca d'água "AI Generated" no canto inferior direito.
boolean (opcional)Ativa a reescrita de prompt baseada em LLM para melhorar a qualidade da imagem. Adiciona latência.
integer (opcional)Semente de número aleatório. Faixa válida: [0, 2147483647].Se omitida, uma semente aleatória é gerada. Se especificada, sementes sequenciais são atribuídas a cada uma das n imagens com base em n. Por exemplo, se n=4, as sementes serão: seed, seed+1, seed+2, seed+3.Para melhorar a reprodutibilidade, fixe o valor da semente.Sementes idênticas não garantem saídas idênticas devido à geração probabilística. |
Parâmetros da resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectInformações de saída da tarefa.
Propriedades task_id stringO ID da tarefa. Válido para consultas por 24 horas.task_status stringO status da tarefa.
Valores de enumeração
| |
request_id stringIdentificador único da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro. |
Etapa 2: Consultar resultados usando o ID da tarefa
- China (Beijing)
- Singapore
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}Ao chamar, substitua {WorkspaceId} pelo seu ID do workspace real.- Singapore
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Ao chamar, substitua {WorkspaceId} pelo seu ID do workspace real.- Recomendação de polling: A geração de imagens demanda tempo. Use um mecanismo de polling com um intervalo razoável, como 10 segundos.
- Transição de estado da tarefa: PENDING → RUNNING → SUCCEEDED ou FAILED.
- Link do resultado: Após o sucesso da tarefa, uma URL de imagem válida por 24 horas é retornada. Baixe e salve a imagem em armazenamento permanente, como o OSS.
Parâmetros da solicitação |
Substitua 86ecf553-d340-4e21-xxxxxxxxx pelo seu task_id real.As chaves de API são diferentes para cada região. Para mais informações, consulte Obter uma chave de API. Se você usar um modelo na região China (Beijing), substitua |
Cabeçalhos da solicitação | |
Authorization string (Obrigatório)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetro de caminho da URL | |
task_id string (Obrigatório)O ID da tarefa. |
Parâmetros da resposta |
As URLs das imagens são válidas apenas por 24 horas e depois são removidas automaticamente. Salve as imagens geradas prontamente. |
output objectInformações de saída da tarefa.
Propriedades task_id stringO ID da tarefa. Válido para consultas por 24 horas.task_status stringO status da tarefa.
Valores de enumeração
stringO horário em que a tarefa foi enviada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringO horário em que a tarefa foi executada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.end_time stringO horário em que a tarefa foi concluída. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.results array of objectLista de resultados da tarefa, incluindo URLs de imagens, prompts e detalhes de erros para falhas parciais.
Propriedades orig_prompt stringO prompt de entrada original, correspondente ao parâmetro de solicitação prompt.actual_prompt stringO prompt otimizado usado quando a reescrita de prompt está ativada. Não retornado quando desativado.url stringURL da imagem gerada.code stringCódigo de erro para imagens com falha. Retornado apenas para falhas parciais.message stringMensagem de erro para imagens com falha. Retornada apenas para falhas parciais.objectEstatísticas do resultado da tarefa.
Propriedades TOTAL integerO número total de tarefas.SUCCEEDED integerO número de tarefas bem-sucedidas.FAILED integerO número de tarefas com falha.stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Códigos de erro.message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro. | |
usage objectEstatísticas de uso. Conta apenas resultados bem-sucedidos.
Propriedades image_count integerNúmero de imagens geradas com sucesso. Faturamento: Custo = Número de imagens × Preço unitário. | |
request_id stringIdentificador único da solicitação para rastreamento e solução de problemas. |
Chamada via DashScope SDK
Os parâmetros do SDK correspondem à Chamada de API HTTP, encapsulados para adequar-se a cada linguagem.
A edição de imagens leva de 30 a 60 segundos. O SDK encapsula o fluxo HTTP assíncrono, suportando chamadas síncronas e assíncronas.
O tempo real de execução varia conforme o tamanho da fila e a carga do service.
Chamada via Python SDK
- Chamada síncrona
- Chamada assíncrona
Exemplo de solicitação
Este exemplo suporta três métodos de entrada de imagem: URL pública, codificação Base64 e caminho de arquivo local.Exemplo de resposta
As URLs das imagens expiram após 24 horas. Baixe as imagens prontamente.
Chamada via Java SDK
- Chamada síncrona
- Chamada assíncrona
Exemplo de solicitação
Este exemplo suporta três métodos de entrada de imagem: URL pública, codificação Base64 e caminho de arquivo local.Exemplo de resposta
As URLs das imagens expiram após 24 horas. Baixe as imagens prontamente.
Limites
- Retenção de dados: Tanto os IDs de tarefa quanto as URLs de imagens expiram após 24 horas. Você não pode consultá-los ou baixá-los após a expiração.
- Moderação de conteúdo: Todos os prompts, imagens de entrada e imagens de saída passam por moderação de conteúdo. Solicitações contendo conteúdo proibido retornam erros como “IPInfringementSuspect” ou “DataInspectionFailed”. Consulte Informações de erro para detalhes.
Códigos de erro
Se a chamada do modelo falhar e retornar uma mensagem de erro, consulte Códigos de erro para resolução.
FAQ
P: Eu usei o General Image Editing 2.1 anteriormente. Preciso alterar minhas chamadas de SDK para usar o wan2.5?
R: Sim — o design dos parâmetros difere entre as versões:- General Image Editing 2.1: Requer ambos os parâmetros
promptefunction. - General Image Editing 2.5: Requer apenas
prompt. Descreva todas as edições em texto. O parâmetrofunctionnão é mais suportado nem necessário.



