Skip to main content
Qwen

Qwen-MT-Image API reference

O Qwen-MT-Image traduz com precisão o texto em imagens e preserva o layout original. O modelo também oferece suporte a dicas de domínio, filtragem de palavras sensíveis e intervenção terminológica.

Os recursos descritos neste documento estão disponíveis apenas na região China (Beijing). Utilize a chave de API desta região.
O Alibaba Cloud Model Studio lançou um domínio específico por workspace para a região China (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com. O novo domínio dedicado oferece desempenho superior e maior estabilidade para solicitações de inferência. Recomendamos migrar do domínio https://dashscope.aliyuncs.com para o novo domínio.{WorkspaceId} é o ID do seu workspace. Você pode encontrá-lo na página Workspace Details no console do Alibaba Cloud Model Studio. O domínio existente permanece totalmente funcional.

Visão geral do modelo

en

Idioma de origem: Inglês

ja

Japonês

es

Português

ar

Árabe

Modelo

Descrição

Especificações da imagem de saída

qwen-mt-image

Modelo de tradução de imagens Qwen. Suporta tradução entre chinês ou inglês e outros idiomas. Não há suporte para tradução direta entre dois idiomas que não sejam chinês ou inglês (por exemplo, japonês para coreano). Consulte Idiomas suportados.

Formato da imagem: JPG

Pré-requisitos

Obter uma chave de API e exportar a chave de API como variável de ambiente.

HTTP

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis. Substitua {WorkspaceId} pelo seu ID do Workspace real. A API HTTP opera em modo assíncrono, dividido em duas etapas:
  1. Crie uma tarefa e obter um ID de tarefa: Envie uma solicitação para criar a tarefa. A resposta retorna um ID de tarefa (task_id).
  2. Consultar o resultado usando o ID da tarefa: Verifique periodicamente o status da tarefa usando o task_id até a conclusão e recupere a URL da imagem.

Etapa 1: Crie uma tarefa e obter um ID de tarefa

  • Após criar a tarefa, utilize o task_id retornado para consultar o resultado. O task_id tem validade de 24 horas. Faça consultas periódicas para obter os resultados em vez de criar tarefas duplicadas.
  • Para acessar um tutorial, consulte Postman.

Parâmetros da solicitação

  • Tradução de imagem
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
    --header 'X-DashScope-Async: enable' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{
        "model": "qwen-mt-image",
        "input": {
            "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp",
            "source_lang": "en",
            "target_lang": "ja",
            "ext": {
                "config": {
                    "imageSegment": false
                }
            }
        }
    }'
Cabeçalhos da solicitação
Content-Type string (Obrigatório)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)Ative o processamento assíncrono. As solicitações HTTP suportam apenas chamadas assíncronas. O valor deve ser enable.
Se este cabeçalho de solicitação estiver ausente, o sistema retornará o erro "current user api does not support synchronous calls".
Corpo da solicitação
model string (Obrigatório)Nome do modelo. Defina como qwen-mt-image.
input object (Obrigatório)Objeto de parâmetro de entrada com os seguintes campos:

Propriedades

image_url string (Obrigatório)URL da imagem acessível publicamente (HTTP ou HTTPS).
  • Formato: JPG, JPEG, PNG, BMP, PNM, PPM, TIFF ou WEBP
  • Dimensões: A largura e a altura da imagem devem estar entre 15 e 8.192 pixels. A proporção deve estar entre 1:10 e 10:1.
  • Tamanho: No máximo 100 MB
  • A URL não pode conter caracteres chineses.
  • Exemplo: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp
source_lang string (Obrigatório)O idioma de origem.
  • Valores suportados: Nome completo do idioma, código do idioma ou auto (para detecção automática). O valor não diferencia maiúsculas de minúsculas.
  • Restrição: Deve ser diferente de target_lang. Pelo menos um dos idiomas (origem ou destino) deve ser chinês ou inglês.
  • Exemplo: Chinese, en ou auto
target_lang string (Obrigatório)O idioma de destino.
  • Valores suportados: Nome completo do idioma ou código do idioma. O valor não diferencia maiúsculas de minúsculas.
  • Restrição: Deve ser diferente de source_lang. Pelo menos um dos idiomas (origem ou destino) deve ser chinês ou inglês.
  • Exemplo: Chinese ou en
ext object (Opcional)Campos estendidos opcionais.

Propriedades

domainHint string (Opcional)Dica de domínio para adaptar o estilo da tradução a um contexto específico. Use inglês para descrever o cenário, estilo e requisitos (máximo de 200 palavras para garantir qualidade).
Atualmente, as dicas de domínio suportam apenas inglês.
Exemplo: These sentences are from seller-buyer conversations on a B2C ecommerce platform. Translate them into clear, engaging customer service language, ensuring the translation is appropriate for handling potential issues or disputes.sensitives array (Opcional)Palavras sensíveis a filtrar do texto da imagem antes da tradução. O filtro realiza correspondência exata (diferencia maiúsculas de minúsculas).As palavras sensíveis podem estar em qualquer idioma de origem ou de destino suportado (máximo de 50 por solicitação para manter a qualidade).Exemplo: ["10% off entire store", "7-day no-questions-asked return"]terminologies array (Opcional)Use a intervenção terminológica para definir traduções específicas para termos técnicos ou de domínio. Os idiomas dos pares de termos devem corresponder a source_lang e target_lang.

Propriedades

src string (Obrigatório)Texto de origem do termo. O idioma deve ser o mesmo de source_lang.tgtstring (Obrigatório)Texto de destino do termo. O idioma deve ser o mesmo de target_lang.
Exemplo: [{"src": "Application Programming Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]config object (Opcional)

Propriedades

imageSegmentbool (Opcional)Quando ativada, a segmentação de assunto da imagem exclui textos presentes nos assuntos da imagem (pessoas, produtos, logotipos) da tradução.
  • false (padrão): Traduz todo o texto da imagem.
  • true: Não traduz textos sobrepostos aos assuntos da imagem.
Nota: Anteriormente, este parâmetro chamava-se skipImgSegment (especificava se a segmentação de assunto da imagem deveria ser ignorada). Para compatibilidade com versões anteriores, esse parâmetro ainda é suportado. No entanto, recomendamos o uso do novo parâmetro imageSegment.

Parâmetros de resposta

  • Resposta bem-sucedida
  • Resposta de erro
Salve o task_id para consultar o status e o resultado da tarefa.
{
        "output": {
            "task_status": "PENDING",
            "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
        },
        "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
    }
output objectInformações de saída da tarefa.

Propriedades

task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus atual da tarefa.

Valores de enumeração

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: A tarefa não existe ou seu status é desconhecido.
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas.
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro.
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Códigos de erro.

Etapa 2: Consultar o resultado usando o ID da tarefa

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • O task_id tem validade de 24 horas. IDs inexistentes ou expirados retornam o status UNKNOWN.
  • A url para tarefas bem-sucedidas é válida por 24 horas. Baixe e salve a imagem imediatamente.

Parâmetros da solicitação

  • Consultar resultado da tarefa
Substitua 86ecf553-d340-4e21-xxxxxxxxx pelo task_id real.
# The URL below is for the China (Beijing) region. Replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
    curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY"
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âmetros de caminho da URL
task_id string (Obrigatório)ID da tarefa.

Parâmetros de resposta

  • Tarefa bem-sucedida - conteúdo traduzível existente
  • Tarefa bem-sucedida - nenhum conteúdo traduzível
  • Falha na tarefa
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.
{
    "request_id": "5fec62eb-bf94-91f8-b9f4-f7f758e4e27e",
    "output": {
        "task_id": "72c52225-8444-4cab-ad0c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-08-13 18:11:16.954",
        "scheduled_time": "2025-08-13 18:11:17.003",
        "end_time": "2025-08-13 18:11:23.860",
        "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    },
    "usage": {
        "image_count":1
    }
}
outputobjectInformações sobre a saída da tarefa.

Propriedades

task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus atual da tarefa.

Valores de enumeração

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: A tarefa não existe ou seu status é desconhecido.
submit_time stringHorário de envio da tarefa. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringHorário de execução da tarefa. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.end_time stringHorário de conclusão da tarefa. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.image_url stringURL da imagem gerada pelo modelo (mesmas dimensões da origem, formato JPG, válida por 24 horas). Baixe e salve imediatamente.code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Códigos de erro.messagestringInformações detalhadas sobre a falha da solicitação. Para mais informações, consulte Mensagens de erro.Geralmente não retornado em solicitações bem-sucedidas. Retornado apenas quando a imagem não contém texto traduzível (por exemplo, após segmentação de assunto). A tarefa ainda é concluída com sucesso e faturada normalmente, retornando No text detected for translation.
usage objectEstatísticas de uso. Contabilizadas apenas para tarefas bem-sucedidas.

Propriedades

image_count integerNúmero de imagens geradas (sempre 1).
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas.

Idiomas suportados

Pelo menos um dos idiomas (origem ou destino) deve ser chinês ou inglês. Não há suporte para tradução direta entre outros pares de idiomas (por exemplo, japonês para coreano). Defina source_lang como auto para detecção automática de idioma.

Idioma

Código

Como idioma de origem

Como idioma de destino

Chinês

zh

Suportado

Suportado

Inglês

en

Suportado

Suportado

Coreano

ko

Suportado

Suportado

Japonês

ja

Suportado

Suportado

Russo

ru

Suportado

Suportado

Espanhol

es

Suportado

Suportado

Francês

fr

Suportado

Suportado

Português

pt

Suportado

Suportado

Italiano

it

Suportado

Suportado

Alemão

de

Suportado

Não suportado

Vietnamita

vi

Suportado

Suportado

Malaio

ms

Não suportado

Suportado

Tailandês

th

Não suportado

Suportado

Indonésio

id

Não suportado

Suportado

Árabe

ar

Não suportado

Suportado

Faturamento e limites de taxa

  • Para cota gratuita e preços, consulte Preços do modelo.
  • Para limites de taxa, consulte Limites de taxa.
  • O faturamento ocorre por imagem gerada com sucesso. Chamadas com falha e erros não geram cobranças .
  • Caso a imagem não contenha texto traduzível (ou nenhum texto fora das áreas de assunto após a segmentação), a tarefa ainda será concluída com sucesso e faturada normalmente, retornando No text detected for translation.

Códigos de erro

Se a chamada do modelo falhar e retornar uma mensagem de erro, consulte Códigos de erro para resolução.

Perguntas frequentes

P: Por que o conteúdo da imagem não foi traduzido?

O recurso de segmentação de assunto exclui textos presentes nos assuntos da imagem (pessoas, produtos, logotipos) da tradução. Para traduzir todo o texto da imagem, defina ext.config.imageSegment como false. Links temporários não podem ser convertidos diretamente em permanentes. Baixe a imagem por meio de um service de backend e faça upload dela para o OSS para obter um link permanente. 
import requests

def download_and_save_image(image_url, save_path):
    try:
        response = requests.get(image_url, stream=True, timeout=300) # Set a timeout.
        response.raise_for_status() # Raise an exception if the HTTP status code is not 200.
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Image successfully downloaded to: {save_path}")
        # You can add the logic to upload to permanent storage here.
    except requests.exceptions.RequestException as e:
        print(f"Image download failed: {e}")

if __name__ == '__main__':
    image_url = "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    save_path = "image-translation.jpg"
    download_and_save_image(image_url, save_path)

P: Como visualize métricas de invocação do modelo?

R: Uma hora após a conclusão da invocação do modelo, acesse a página Monitoring (Singapore) ou Monitoring (China (Beijing)) para visualizar métricas como contagem de invocações e taxa de sucesso. Para mais informações, consulte Faturamento e gestão de custos.

P: Como obter a lista de permissões de nomes de domínio para armazenamento de imagens?

R: As imagens geradas pelos modelos são armazenadas no OSS. A API retorna uma URL pública temporária. Para configure uma lista de permissões de firewall para esta URL de download, observe o seguinte: O armazenamento subjacente pode mudar dinamicamente. Este tópico não fornece uma lista fixa de permissões de nomes de domínio do OSS para evitar problemas de acesso causados por informações desatualizadas. Se você tiver requisitos de controle de segurança, entre em contato com o gerente da sua conta para obter a lista mais recente de nomes de domínio do OSS.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais
Qwen-MT-Image API reference - Alibaba Cloud Model Studio