Imagens e vídeos FAQ

Perguntas comuns sobre geração de imagens e vídeos: faturamento, erros de API, diferenças de modelos, requisitos de entrada e URLs de saída.

<a id="debugging" />

Depuração

Como faço para depurar as chamadas da API de imagem localmente?

APIs de imagem suportam chamadas HTTP padrão. Para testar localmente:

1. [Ativar o serviço de modelo e obter uma chave API] (/developer-guides/getting-started/first-api-call). Então [defina a chave API como uma variável de ambiente] (/api-reference/preparation/export-api-key-env).
2. Encontre o curl comando na imagem API docs e executá-lo em um terminal (macOS/Linux) ou usar uma plataforma API como Postman ou Apifox (Windows).

curl -X POST https://maas.qwencloudapi.com/api/v1/services/aigc/text2image/image-synthesis \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wan2.1-t2i-turbo",
  "input": {
    "prompt": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
  },
  "parameters": {
    "size": "1024*1024",
    "n": 1
  }
}'

Ao usar uma plataforma API, substitua $DASHSCOPE_API_KEY na Authorization cabeçalho com sua chave de API real, por exemplo, Bearer sk-ws-xxxxxx.

<a id="billing-rate-limits" />

Limites de faturamento e taxa

Como faturar funciona para modelos de imagem?

Cada modelo de imagem tem uma cota livre e pode ter um preço por imagem. Limites de cota e taxa são compartilhados através de um QwenCloud Conta. Apenas imagens de saída geradas com sucesso são faturadas - imagens de entrada e pedidos falhados não consomem cotas ou incorrem em cargas.

Para detalhes completos de faturamento, veja [Billing Overview] (/resources/billing-overview).

O que significa "liberdade por um tempo limitado"?

O modelo está em pré-visualização pública. Quando a cota livre se esgota, o modelo fica indisponível.

Como eu ganho a cota livre?

A cota livre é concedida automaticamente quando você ativa. QwenCloud. É válido por 90 dias. Veja [Cota livre para novos usuários] (/resources/free-quota).

Como é que faturar funciona para modelos de vídeo?

A geração de vídeo é cobrada pela duração de vídeo gerado com sucesso. As tarefas falhadas não são carregadas.

<a id="api-errors" />

Erros de API

Erros comuns na API da imagem:

BadRequest.InputDownloadFailed"O download da imagem de referência falhou"

{
  "request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
  "output": {
    "task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
    "task_status": "FAILED",
    "code": "BadRequest.InputDownloadFailed",
    "message": "Reference image download failed, please check image url."
  }
}

A URL da imagem é incorreta, inalcançável ou restrita ao acesso. O serviço baixa a imagem durante o processamento. Se o download falhar, a tarefa falha.

Solução: Garanta que a URL seja completa e acessível publicamente. Se a imagem requer autenticação, faça upload para armazenamento público (como OSS) e use a nova URL.

InvalidParameter"Corpo obrigatório inválido"

{
  "request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
  "code": "InvalidParameter",
  "message": "Required body invalid, please check the request body format."
}

Porque: # curl O corpo de pedido contém caracteres chineses que o cliente não pode analisar corretamente.

? Solution: ? Correr o curl comando em um terminal (macOS/Linux manusear UTF-8 nativamente), ou usar uma plataforma HTTP como Postman ou Apifox.

Resources baixam tempo fora do continente chinês.

Download the media resource timed out during the data inspection process

**Causa:**Instabilidade de rede entre a região de armazenamento de imagens (fora do continente chinês) e o ponto final de serviço causa tempo de download.

Solução: Armazenar imagens em uma região com conectividade estável com o terminal de serviço e configurar aceleração. O período de tempo de download não é configurável.

<a id="wan26-image" />

Wan2.6 geração de imagens e edição

** APIS:** [Syncronous] (/api-reference/image-generation/wan26-image-gen-edit/synchronous), [Criar tarefa] (/api-reference/image-generation/wan26-image-gen-edit/create-task), [Resultado da pergunta] (/api-reference/image-generation/wan26-image-gen-edit/query-result)

O que os modos de edição de imagens fazem Wan2.6 Apoio?

Wan2.6 suporta dois modos controlados pelo enable_interleave parâmetro:

• Tradução:enable_interleave=falseEdita imagens, aplica transferência de estilo, ou gera imagens consistentes com o assunto. Entrada: 1-4 imagens. Saída: 1-4 imagens.
• ** Saída de imagem de texto interleaved ** (enable_interleave=trueGera conteúdo misto de imagens de texto. Entrada: 0-1 imagens. É necessário fazer uma transmissão.

Quais são os requisitos de entrada de imagem?

• ** Formatos:** JPEG, JPG, PNG (canal alfa não suportado), BMP, WEBP.
• Resolução: Largura e altura entre 240 e 8.000 pixels.
• Tamanho do arquivo: 10 MB por imagem.
• ** Contagem de imagens:** Modo de edição: 1-4 imagens. Modo inter-liminar: imagem 0-1.

Como passo imagens usando codificação Base64?

Em vez de uma URL pública, passe uma string codificada pela Base64 no formato data:{mime_type};base64,{base64_data} (por exemplo, data:image/jpeg;base64,/9j/4AAQ...).

Como faço para usar o modo de saída de imagem de texto interleaved?

Saída de imagem de texto interleaved (enable_interleave=true) requer transmissão. Defina os dois:

1. X-DashScope-Sse - Para onde? enable
2. parameters.stream para true

Use max_images (1-5, padrão 5) para controlar o número máximo de imagens geradas. O parâmetro n Deve permanecer 1 neste modo.

Quais resoluções de saída são apoiadas?

** Modo de edição de imagens:** Use 1K (padrão, ~~1280*1280) ou 2K (~~2048*2048) para combinar proporções de entrada, ou especificar exatamente width*height dentro [768*768, 2048*2048].

** Modo interleaved:** Dimensões dentro [768*768, 1280*1280]. Recomendado: 1280*1280, 800*1200, 1200*800, 960*1280, 1280*960, 720*1280, 1280*720, 1344*576.

Quanto tempo são válidas URLs de imagens geradas?

URLs de imagens geradas são válidas por 24 horas. Baixe imagens imediatamente após a geração.

<a id="qwen-text-to-image" />

Qwen texto-para-imagem

** API:**Qwen "Textual para imagem" (/api-reference/image-generation/qwen-text-to-image)

Devo habilitar ou desativar o prompt_extend Parâmetro?

Habilitar (padrão) para simples avisos para melhorar a qualidade. Desativar (false) para controle preciso, descrições detalhadas, ou baixa latência. Veja [Guia de imagem imediata] (/developer-guides/accuracy-tuning/image-generation).

Quais são as diferenças entre os Qwen-Image Modelos?

** Geração de imagens e modelos de edição unificados:

• qwen-image-3.0-pro (recomendado): entrada de texto longo e geração de layout complexo, renderização de texto de 10 pixels, 12 idiomas e 20+ fontes. Suporta chamadas síncronas e assíncronas.
• qwen-image-3.0 Variante padrão 3.0, qualidade e velocidade de equilíbrio. Suporta chamadas síncronas e assíncronas.
• qwen-image-2.1-pro Modelo unificado compacto com suporte à transparência nativa, pode produzir imagens com um canal alfa baseado em seu prompt. A edição de imagens aceita até 10 imagens de referência. Suporta chamadas síncronas e assíncronas.
• qwen-image-2.0-proGeração anterior. Tradução de texto profissional, realismo fino, mais forte aderência semântica. Só sincronia.
• qwen-image-2.0Geração anterior. Geração de alta qualidade, mais rápido que qwen-image-2.0-pro. Só sincronia.

<a id="qwen-image-editing" />

Qwen edição de imagens

** API:**Qwen Tradução:/api-reference/image-generation/qwen-image-editing)

Que línguas fazem o Qwen Modelos de edição de imagens?

Os modelos apoiam oficialmente chinês e inglês simplificados. Outras línguas podem funcionar, mas os resultados não são garantidos.

Para que são os requisitos de entrada de imagem? Qwen Edição de imagem?

• ** Formatos:** JPG, JPEG, PNG, BMP, TIFF, WEBP, GIF (primeiro quadro apenas). Saída é sempre PNG.
• Resolução: Largura e altura entre 384 e 3072 pixels. Imagens fora desta faixa podem produzir saída turva ou aumentar o tempo de processamento.
• Tamanho do arquivo: 10 MB por imagem.
• Número de imagens: 1 a 3 imagens por pedido.

Como passo imagens usando codificação Base64?

Passe uma string de imagem codificada pela Base64 em vez de uma URL no formato. data:{mime_type};base64,{base64_data} (como data:image/jpeg;base64,/9j/4AAQ...). Veja amostras de código na referência API para exemplos completos.

<a id="z-image" />

Z-Image

Como eu vejo as métricas de invocação de modelos?

Métricas (contagem de invocações, taxa de sucesso) estão disponíveis uma hora após a tarefa de geração completar no [Analytics] (https://home.qwencloud.com/analytics) page. Veja também: [Bill query and custo management] (/resources/bill-query).

<a id="video-generation" />

Geração de vídeo

** APIS:** [Texto para vídeo] (/developer-guides/video-generation/text-to-video), [Imagem para vídeo] (/developer-guides/video-generation/image-to-video[Imagem para vídeo (primeira e última moldura)] (/developer-guides/video-generation/image-to-video-first-last), [Edição de vídeo] (/developer-guides/video-generation/video-editing)

Quais são os requisitos de entrada de imagem para imagem para vídeo?

• Formatos comuns, como JPEG, JPG, PNG, WEBP.
• Tamanho: 10 MB por imagem.
• URL: Deve ser uma URL HTTP(S) acessível publicamente. O serviço baixa a imagem na hora da geração.

Os requisitos diferem entre wan2.6 e wan2.5 - Veja a referência da API para o modelo que está usando.

Quanto tempo demora a geração de vídeo?

A geração de vídeo é assíncrona. Após enviar uma tarefa, pesquise o ponto final da consulta a cada 10-30 segundos até que o status se transmita de PENDING Ou RUNNING para SUCCEEDED Ou FAILED. O tempo de geração depende da duração do vídeo, resolução e carga de fila, plano para um a vários minutos.

Quanto tempo são válidas URLs de vídeo geradas?

URLs de vídeo geradas são válidas por 24 horas. Baixe o vídeo imediatamente após a tarefa ter sucesso.