O modelo Qwen Image Generation and Editing 3,0 oferece suporte a texto para imagem (T2I) e imagem para imagem/edição de imagem (I2I). Ele gera imagens diretamente a partir de prompts de texto ou edita imagens com base em 1 a 3 imagens de referência combinadas com instruções de edição.
Visão geral do modelo
Modelo | Descrição | Especificações da imagem de saída |
|---|---|---|
qwen-image-3.0-pro | Modelo Qwen Image Generation and Editing 3,0 com suporte a texto para imagem (T2I) e imagem para imagem/edição de imagem (I2I). | Resolução da imagem:
Formato da imagem: PNG |
qwen-image-3.0 | Modelo padrão Qwen Image Generation and Editing 3,0 com suporte a texto para imagem (T2I) e imagem para imagem/edição de imagem (I2I). Equilibra qualidade e velocidade. |
Disponibilidade
O modelo, a URL do endpoint e a chave de API devem pertencer à mesma região. Chamadas entre regiões falham.
- Selecione um modelo: Verifique se o modelo está disponível na região de destino.
- Selecione uma URL: Escolha a URL do endpoint correspondente à região do seu modelo. Há suporte para URLs HTTP e DashScope SDK.
- Configure uma chave de API: Obtenha uma API key para a região e, em seguida, configure the API key as an environment variable.
- Instale o SDK: Para fazer chamadas de API com o SDK, instale o DashScope SDK.
API síncrona (recomendada)
HTTP
- Singapore
- China (Beijing)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation{WorkspaceId} pelo seu workspace ID real.
Parâmetros da solicitação | |
Headers | |
Content-Type string (Required)Tipo de conteúdo da solicitação. Deve ser application/json. | |
Authorization string (Required)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Corpo da solicitação | |
model string (Required)Nome do modelo. Valores disponíveis: qwen-image-3.0-pro e qwen-image-3.0. | |
input object (Required)Objeto de parâmetro de entrada contendo os seguintes campos:
Properties messages array (Required)Array de conteúdo da solicitação. Apenas conversas de rodada única são suportadas, portanto, o array deve conter exatamente um objeto com as propriedades role e content.
Properties role string (Required)Função do remetente da mensagem. Defina como user.contentarray (Required)Array de conteúdo da mensagem, com combinações diferentes dependendo do caso de uso:
Properties image string (Required for I2I)URL ou dados codificados em Base64 da imagem de entrada. Em cenários I2I, há suporte para 1 a 3 imagens. Ao fornecer várias imagens, a ordem segue a sequência do array.Requisitos da imagem:
string(Required)Prompt positivo descrevendo o conteúdo, estilo e composição da imagem a gerar ou editar. Chinês e inglês suportados. Máximo recomendado: 4.500 tokens.Nota: Apenas um objeto de texto é permitido. Omiti-lo ou fornecer vários objetos de texto resultará em erro. | |
parameters object (Optional)Parâmetros adicionais para controlar a geração de imagens.
Properties prompt_extend boolean (Optional)Ativa a reescrita inteligente de prompts. Padrão: true (recomendado). Quando ativado, o modelo otimiza o prompt positivo usando o método especificado por prompt_extend_mode, melhorando significativamente os resultados para descrições simples.prompt_extend_mode string (Optional)Método de reescrita de prompt. Padrão: direct. Opções:
boolean (Optional)Ativa o modo de raciocínio. Padrão: true. Aprimora o raciocínio do modelo para melhorar a qualidade da imagem, mas aumenta o tempo de geração. Requer prompt_extend=true. Suportado para Direct T2I, Direct I2I e Agent T2I. Não suportado para I2I Agent.n integer (Optional)Número de imagens de saída. Intervalo: 1 a 6. Padrão: 1.size string (Optional)Resolução da imagem de saída no formato width height, por exemplo "10241024". Se não especificado, o modelo recomenda automaticamente uma resolução com base no prompt.
string (Optional)Prompt negativo descrevendo o conteúdo indesejado na imagem.seed integer (Optional)Seed aleatória. Intervalo: [0, 2147483647]. Se omitido, o service gera uma seed aleatória. Use uma seed fixa para resultados reproduzíveis.watermark boolean (Optional)Adiciona marca d'água. Padrão: false. |
Parâmetros de resposta |
Os dados da tarefa (status e URLs das imagens) ficam retidos por apenas 24 horas e depois são removidos automaticamente. Salve as imagens geradas imediatamente. |
output objectContém os resultados da geração do modelo.
Properties rewrite_status stringStatus da reescrita do prompt. O valor depende da ativação da reescrita na solicitação e do resultado obtido.choices arrayLista de opções de resultado.
Properties finish_reason stringMotivo da interrupção da tarefa. O valor é stop quando a tarefa é concluída normalmente.message objectMensagem retornada pelo modelo.
Properties role stringFunção da mensagem. Fixa como assistant.contentarrayConteúdo da mensagem com informações da imagem gerada.
Properties image stringURL da imagem gerada em formato PNG. O link é válido por 24 horas. Baixe e salve a imagem imediatamente. | |
usage objectUso de recursos desta chamada. Retornado apenas em caso de sucesso.
Properties output_width integerLargura da imagem de saída final em pixels.output_height integerAltura da imagem de saída final em pixels.input_image_count integerNúmero de imagens de entrada na solicitação. Retorna 0 para texto para imagem (T2I) e a contagem real para imagem para imagem (I2I).input_image_type stringNível de faturamento da imagem de entrada. Determinado pela área de pixels da resolução de saída: qima_input_1k se a área for ≤ 2.250.000, ou qima_input_2k se a área for > 2.250.000.output_image_count integerNúmero real de imagens de saída retornadas.output_image_type stringNível de faturamento da imagem de saída. Determinado pela área de pixels da resolução de saída: qima_output_1k se a área for ≤ 2.250.000, ou qima_output_2k se a área for > 2.250.000. | |
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Error codes. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Error codes. |
SDK
Os exemplos a seguir demonstram como chamar a API usando SDKs Python e Java para imagem para imagem / edição de imagem (I2I).
API assíncrona
Além da chamada síncrona descrita acima, o Qwen Image Generation and Editing 3,0 também suporta chamadas assíncronas. A API assíncrona compartilha a mesma estrutura de parâmetros de solicitação que a API síncrona. Basta adicionar o header X-DashScope-Async: enable. Após o service aceitar a solicitação, ele retorna um ID de tarefa (task_id), que você então usa para consultar a API de consulta e obter o resultado final.
HTTP
Chamadas assíncronas usam um fluxo de trabalho de duas etapas:
- Crie uma tarefa para obter um ID de tarefa: Envie uma solicitação para criar uma tarefa. A resposta contém um ID de tarefa (task_id).
- Consulte os resultados usando o ID da tarefa: Use o task_id para consultar o status da tarefa até que ela seja concluída e a URL da imagem seja retornada.
Etapa 1: Criar uma tarefa para obter um ID de tarefa
- Singapore
- China (Beijing)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationParâmetros da solicitação | |
Headers | |
Content-Type string (Required)Tipo de conteúdo da solicitação. Deve ser application/json. | |
Authorization string (Required)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
X-DashScope-Async string (Required)Ativa o processamento assíncrono. Solicitações HTTP suportam apenas chamadas assíncronas. Deve ser enable. | |
Corpo da solicitação | |
model string (Required)Nome do modelo. Valores disponíveis: qwen-image-3.0-pro e qwen-image-3.0. | |
input object (Required)Objeto de parâmetro de entrada contendo os seguintes campos:
Properties messages array (Required)Array de conteúdo da solicitação. Apenas conversas de rodada única são suportadas, portanto, o array deve conter exatamente um objeto com as propriedades role e content.
Properties role string (Required)Função do remetente da mensagem. Defina como user.contentarray (Required)Array de conteúdo da mensagem, com combinações diferentes dependendo do caso de uso:
Properties image string (Required for I2I)URL ou dados codificados em Base64 da imagem de entrada. Em cenários I2I, há suporte para 1 a 3 imagens. Ao fornecer várias imagens, a ordem segue a sequência do array.Requisitos da imagem:
string(Required)Prompt positivo descrevendo o conteúdo, estilo e composição da imagem a gerar ou editar. Chinês e inglês suportados. Máximo recomendado: 4.500 tokens.Nota: Apenas um objeto de texto é permitido. Omiti-lo ou fornecer vários objetos de texto resultará em erro. | |
parameters object (Optional)Parâmetros adicionais para controlar a geração de imagens.
Properties prompt_extend boolean (Optional)Ativa a reescrita inteligente de prompts. Padrão: true (recomendado). Quando ativado, o modelo otimiza o prompt positivo usando o método especificado por prompt_extend_mode, melhorando significativamente os resultados para descrições simples.prompt_extend_mode string (Optional)Método de reescrita de prompt. Padrão: direct. Opções:
boolean (Optional)Ativa o modo de raciocínio. Padrão: true. Aprimora o raciocínio do modelo para melhorar a qualidade da imagem, mas aumenta o tempo de geração. Requer prompt_extend=true. Suportado para Direct T2I, Direct I2I e Agent T2I. Não suportado para I2I Agent.n integer (Optional)Número de imagens de saída. Intervalo: 1 a 6. Padrão: 1.size string (Optional)Resolução da imagem de saída no formato width height, por exemplo "10241024". Se não especificado, o modelo recomenda automaticamente uma resolução com base no prompt.
string (Optional)Prompt negativo descrevendo o conteúdo indesejado na imagem.seed integer (Optional)Seed aleatória. Intervalo: [0, 2147483647]. Se omitido, o service gera uma seed aleatória. Use uma seed fixa para resultados reproduzíveis.watermark boolean (Optional)Adiciona marca d'água. Padrão: false. |
Parâmetros de resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectInformações de aceitação da tarefa.
Properties task_id stringID da tarefa assíncrona, usado para consultar o status e o resultado da tarefa. Certifique-se de salvá-lo.task_status stringStatus da tarefa. Geralmente PENDING ao enviar a tarefa, indicando apenas que foi aceita, não que a imagem foi gerada. | |
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Error codes. |
Etapa 2: Consultar resultados usando o ID da tarefa
- Singapore
- China (Beijing)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Parâmetros da solicitação |
Substitua {task_id} pelo valor task_id retornado pela chamada de API anterior. O task_id é válido para consultas por 24 horas, Substitua {WorkspaceId} pelo seu workspace ID real. |
Headers | |
Authorization string (Required)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetros de caminho da URL | |
task_id string (Required)ID da tarefa. |
Parâmetros de resposta |
Os dados da tarefa (status e URLs das imagens) ficam retidos por apenas 24 horas e depois são removidos automaticamente. Salve as imagens geradas imediatamente. |
output objectInformações de saída da tarefa.
Properties task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus da tarefa.
Enumeration values
stringHora de envio da tarefa. A hora está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringHora de execução da tarefa. A hora está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.end_time stringHora de conclusão da tarefa. A hora está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.rewrite_status stringStatus da reescrita do prompt. O valor depende da ativação da reescrita na solicitação e do resultado obtido.choices arrayLista de opções de resultado.
Properties finish_reason stringMotivo da interrupção da tarefa. O valor é stop quando a tarefa é concluída normalmente.message objectMensagem retornada pelo modelo.
Properties role stringFunção da mensagem. Fixa como assistant.contentarrayConteúdo da mensagem com informações da imagem gerada.
Properties image stringURL da imagem gerada em formato PNG. O link é válido por 24 horas. Baixe e salve a imagem imediatamente. | |
usage objectUso de recursos desta chamada. Retornado apenas em caso de sucesso.
Properties output_width integerLargura da imagem de saída final em pixels.output_height integerAltura da imagem de saída final em pixels.input_image_count integerNúmero de imagens de entrada na solicitação. Retorna 0 para texto para imagem (T2I) e a contagem real para imagem para imagem (I2I).input_image_type stringNível de faturamento da imagem de entrada. Determinado pela área de pixels da resolução de saída: qima_input_1k se a área for ≤ 2.250.000, ou qima_input_2k se a área for > 2.250.000.output_image_count integerNúmero real de imagens de saída retornadas.output_image_type stringNível de faturamento da imagem de saída. Determinado pela área de pixels da resolução de saída: qima_output_1k se a área for ≤ 2.250.000, ou qima_output_2k se a área for > 2.250.000. | |
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Error codes. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Error codes. |