O Wan2.6 oferece suporte a entrada de múltiplas imagens, edição de imagens e saída intercalada de texto e imagem.
Visão geral do modelo
Modelo | Descrição | Especificações da imagem de saída |
|---|---|---|
wan2.6-image | Edita imagens e gera saída intercalada de texto e imagem. | Formato da imagem: PNG A resolução e as dimensões da imagem são configuradas por meio do parâmetro size. |
Pré-requisitos
Obtenha uma chave de API e exporte a chave de API como uma variável de ambiente.
HTTP síncrono
Retorna resultados em uma única solicitação. Recomendado para a maioria dos cenários.
- Singapore
- US (Virginia)
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationAo fazer a chamada, substitua {WorkspaceId} pelo seu ID do workspace real.O escopo de implantação global (região de Frankfurt) suporta apenas chamadas assíncronas .
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-SSEstring (Opcional)Ativa a saída em streaming.
| |
Corpo da solicitação | |
model string (Obrigatório)Nome do modelo. Defina como wan2.6-image. | |
input object (Obrigatório)Configuração de entrada.
Propriedades messages array (Obrigatório)Array de conteúdo da solicitação. Apenas conversas de turno único são suportadas -- forneça um par role-content.
Propriedades role string (Obrigatório)Função da mensagem. Defina como user.contentarray (Obrigatório)Array de conteúdo da mensagem.
Propriedades text string(Obrigatório)Prompt positivo que descreve o conteúdo, estilo e composição desejados para a imagem.Suporta chinês e inglês. Máximo de 2.000 caracteres (cada caractere chinês, letra, dígito ou símbolo conta como um). Truncado automaticamente se excedido.Exemplo: Gere um refogado de tomate com ovos baseado no estilo desta imagem.Nota: O array content deve conter exatamente um objeto com um campo text.imagestring(Opcional)URL ou string codificada em Base64 da imagem de entrada.Restrições da imagem:
| |
parameters object (Opcional)Parâmetros de geração.
Propriedades negative_prompt string (opcional)Um prompt negativo que descreve o que você não deseja na imagem.Suporta chinês e inglês. O comprimento máximo é de 500 caracteres. Caracteres excedentes são truncados automaticamente.Exemplo: Baixa resolução, baixa qualidade, membros distorcidos, dedos malformados, cores supersaturadas, aparência de cera, sem detalhes faciais, superfícies excessivamente lisas, aparência gerada por IA. Composição caótica. Texto desfocado ou distorcido.size string (Opcional)Resolução da imagem de saída. Suporta dois métodos: referenciar as proporções da imagem de entrada ou especificar diretamente as dimensões.Quando enable_interleave=false (modo de edição de imagem):
enable_interleave=true (modo de saída intercalada de texto e imagem):
Resoluções recomendadas para proporções comuns
bool (Opcional)Controla o modo de geração de imagem:
integer (Opcional)Número de imagens a serem geradas. O comportamento depende de enable_interleave:
integer (Opcional)Efetivo apenas no modo intercalado de texto e imagem (enable_interleave=true).
bool (Opcional)Efetivo apenas no modo de edição de imagem (enable_interleave = false).Ativa a reescrita inteligente de prompts. Otimiza apenas o prompt positivo; o prompt negativo permanece inalterado.
bool (Opcional)Ativa a saída em streaming. Obrigatório (definir como true) quando enable_interleave=true.
bool (Opcional)Adiciona um rótulo de marca d'água no canto inferior direito da imagem com o texto fixo "AI Generated".
integer (opcional)Semente de número aleatório. Faixa válida: [0,2147483647].Usar a mesma seed produz saídas semelhantes. Se omitido, o algoritmo usa uma semente aleatória.Nota: A geração de imagens é probabilística. Mesmo com a mesma seed, os resultados podem variar. |
Parâmetros da resposta |
Os dados da tarefa (status da tarefa e URLs das imagens) são retidos por apenas 24 horas e depois removidos automaticamente. Salve as imagens geradas prontamente. |
output objectSaída da tarefa.
Propriedades choices array of objectConteúdo de saída gerado pelo modelo.
Propriedades finish_reason stringMotivo do término da tarefa.Cenário de saída sem streaming: Para naturalmente com stop.Cenário de saída em streaming: Este parâmetro indica se o fluxo de dados terminou a transmissão.
objectMensagem retornada pelo modelo.
Propriedades role stringFunção da mensagem, fixa como assistant.contentarray
Propriedades type stringTipo de saída. Valores enumerados: text, image.text stringTexto gerado.image stringURL da imagem gerada no formato PNG.O link expira após 24 horas. Baixe e salve a imagem prontamente.boolSinalizador de conclusão da solicitação.
| |
usage objectEstatísticas de saída. Conta apenas resultados bem-sucedidos.
Propriedades image_count integerNúmero de imagens geradas.size stringResolução das imagens geradas. Exemplo: 1376*768.input_tokens integerFaturado por contagem de imagens.
integerFaturado por contagem de imagens.
integerFaturado por contagem de imagens.
| |
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. |
HTTP assíncrono
Fluxo: Criar tarefa → Consultar resultados
Etapa 1: Criar a tarefa e obter o ID da tarefa
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationAo fazer a chamada, substitua {WorkspaceId} pelo seu ID do workspace real.- Após criar a tarefa, utilize o
task_idretornado para consultar o resultado. Otask_idpermanece válido por 24 horas. Não crie tarefas duplicadas. Em vez disso, use consultas periódicas (polling) para recuperar o resultado. - Para orientações destinadas a iniciantes, consulte Chamar APIs com Postman ou cURL.
Parâmetros da requisição | |
Cabeçalhos da requisição | |
Content-Type string (Obrigatório)Tipo de conteúdo da requisição. Deve ser application/json. | |
Authorization string (Obrigatório)Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
X-DashScope-Asyncstring(Obrigatório)Alternador do modo assíncrono. Deve ser definido como enable. | |
Corpo da requisição | |
model string (Obrigatório)Nome do modelo.Exemplo: wan2.6-image | |
input object (Obrigatório)Configuração de entrada.
Propriedades messages array (Obrigatório)Array de conteúdo da requisição. Apenas conversas de turno único são suportadas — forneça um par role-content. Conversas de múltiplos turnos não são suportadas.
Propriedades role string (Obrigatório)Função da mensagem. Defina como user.contentarray (Obrigatório)Array de conteúdo da mensagem.
Propriedades text string(Obrigatório)Prompt positivo descrevendo o conteúdo, estilo e composição desejados para a imagem.Suporta chinês e inglês. Máximo de 2.000 caracteres (cada caractere chinês, letra, dígito ou símbolo conta como um). Truncado automaticamente se excedido.Exemplo: Gere um refogado de tomate com ovos baseado no estilo desta imagem.Nota: O array content deve conter exatamente um objeto com um campo text.imagestring(Opcional)URL ou string codificada em Base64 da imagem de entrada.Restrições de imagem:
| |
parameters object (Opcional)Parâmetros de geração.
Propriedades negative_prompt string (opcional)Um prompt negativo descrevendo o que você não deseja na imagem.Suporta chinês e inglês. O comprimento máximo é de 500 caracteres. Caracteres excedentes são truncados automaticamente.Exemplo: Baixa resolução, baixa qualidade, membros distorcidos, dedos malformados, cores supersaturadas, aparência de cera, sem detalhes faciais, superfícies excessivamente lisas, aparência gerada por IA. Composição caótica. Texto borrado ou distorcido.size string (Opcional)Resolução da imagem de saída. Suporta dois métodos: referenciar as proporções da imagem de entrada ou especificar diretamente as dimensões.Quando enable_interleave=false (modo de edição de imagem):
enable_interleave=true (modo de saída intercalada de texto e imagem):
Resoluções recomendadas para proporções comuns
bool (Opcional)Controla o modo de geração de imagem:
integer (Opcional)Número de imagens a serem geradas. O comportamento depende de enable_interleave:
integer (Opcional)Efetivo apenas no modo intercalado de texto e imagem (enable_interleave=true).
bool (Opcional)Efetivo apenas no modo de edição de imagem (enable_interleave = false).Habilita a reescrita inteligente de prompts. Otimiza apenas o prompt positivo; o prompt negativo permanece inalterado.
bool (Opcional)Adiciona um rótulo de marca d'água no canto inferior direito da imagem com o texto fixo "AI Generated".
integer (opcional)Semente de número aleatório. Faixa válida: [0,2147483647].Usar a mesma seed produz saídas semelhantes. Se omitida, o algoritmo usa uma semente aleatória.Nota: A geração de imagens é probabilística. Mesmo com a mesma seed, os resultados podem variar. |
Parâmetros da resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectSaí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 requisição para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para requisições com falha. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte Códigos de erro. |
Etapa 2: Consultar resultados usando o ID da tarefa
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Ao fazer a chamada, substitua {WorkspaceId} pelo seu ID do workspace real.- Recomendação de polling: A geração de imagens leva tempo. Utilize um mecanismo de consulta periódica 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 um armazenamento permanente, como o OSS.
Parâmetros da requisição |
Substitua {task_id} pelo valor de task_id retornado pela chamada de API anterior. O task_id é válido para consultas por 24 horas. |
Cabeçalhos da requisição | |
Authorization string (Obrigatório)Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetros de caminho da URL | |
task_id string (Obrigatório)O ID da tarefa. |
Parâmetros de resposta |
Os dados da tarefa (status e URLs das imagens) são retidos por apenas 24 horas e depois removidos automaticamente. Salve as imagens geradas imediatamente. |
output objectInformações de saída da tarefa.
Propriedades task_id stringID da tarefa. Válido para consultas durante 24 horas.task_status stringStatus atual da tarefa.
Valores de enumeração
stringHorá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 stringHorá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 stringHorá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.finished boolSinalizador de conclusão da solicitação.
array of objectConteúdo de saída gerado pelo modelo.
Propriedades finish_reason stringMotivo do término da tarefa. Interrompe naturalmente com stop.message objectMensagem retornada pelo modelo.
Propriedades role stringFunção da mensagem, fixa como assistant.contentarray
Propriedades type stringTipo de saída. Valores enumerados: text, image.text stringTexto gerado.image stringURL da imagem gerada no formato PNG.O link expira após 24 horas. Baixe e salve a imagem prontamente. | |
usage objectEstatísticas de saída. Conta apenas resultados bem-sucedidos.
Propriedades image_count integerQuantidade de imagens geradas.size stringResolução das imagens geradas. Exemplo: 1376*768.input_tokens integerContagem de tokens de entrada. Faturado por quantidade de imagens. Atualmente fixo em 0.output_tokens integerContagem de tokens de saída. Faturado por quantidade de imagens. Atualmente fixo em 0.total_tokensintegerContagem total de tokens. Faturado por quantidade de imagens. Atualmente fixo em 0. | |
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. |
DashScope Python SDK
Os parâmetros do SDK estão alinhados com a interface HTTP, adaptados às convenções de cada linguagem.
O SDK gerencia chamadas assíncronas internamente e suporta invocação síncrona e assíncrona.
A duração real varia conforme o tamanho da fila e a carga do service.O
base_url e a chave de API são específicos por região. Exemplo de chamada na região de Singapore:
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Ao realizar a chamada, substitua {WorkspaceId} pelo seu workspace ID real.O escopo de implantação global (região de Frankfurt) suporta apenas chamadas assíncronas.
Edição de imagem
- Synchronous
- Asynchronous
Exemplo de solicitação
Exemplo de resposta
A URL expira após 24 horas. Baixe as imagens prontamente.
Saída intercalada de texto e imagem
- Synchronous (streaming only)
- Asynchronous
Exemplo de solicitação
Exemplo de resposta
A URL expira após 24 horas. Baixe as imagens prontamente.
DashScope Java SDK
Os parâmetros do SDK estão alinhados com a interface HTTP, encapsulados conforme as convenções da linguagem.
O SDK gerencia chamadas assíncronas internamente e suporta invocação síncrona e assíncrona.
A duração real depende do tamanho da fila e da carga do service.O
base_url e a chave de API não são intercambiáveis entre regiões. Exemplos para a região de Singapore:
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Ao fazer a chamada, substitua {WorkspaceId} pelo seu workspace ID real.O escopo de implantação global (região de Frankfurt) suporta apenas chamadas assíncronas.
Edição de imagens
- Synchronous
- Asynchronous
Exemplo de solicitação
Exemplo de resposta
A URL expira após 24 horas. Baixe as imagens prontamente.
Saída intercalada de texto e imagem
- Synchronous call (streaming only)
- Asynchronous call
Exemplo de solicitação
Exemplo de resposta
A URL expira após 24 horas. Baixe as imagens prontamente.
Limitações
- Validade dos dados: O
task_idda tarefa e aurlda imagem são retidos por apenas 24 horas. Após esse período, não é possível consultá-los ou baixá-los. - Moderação de conteúdo: Tanto o
promptde entrada quanto a imagem de saída passam por moderação de conteúdo. Conteúdo não compatível retorna um erroIPInfringementSuspectouDataInspectionFailed. Consulte Códigos de erro.
Faturamento e limitação de taxa
- Cotas gratuitas e preços: Preços do modelo.
- Para limites de taxa do modelo, consulte Wanxiang.
- A cobrança é feita por imagem gerada com sucesso. Chamadas com falha não incorrem em custos e não consomem a cota gratuita.