> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Geração de imagens e vídeos

## 1. Qual é a diferença entre as versões Nano Banana Pro e Light?

* Nano Banana Pro: conexão direta com a versão oficial, boa estabilidade e suporte a todos os recursos (como imagens de referência)
* Nano Banana Pro Light: versão reversa/desbloqueada, mais barata, porém com menor estabilidade; alguns recursos não são compatíveis (por exemplo, a função de imagem de referência pode falhar) e pode acionar a moderação de conteúdo (PROHIBITED\_CONTENT)

Recomendação: para ambientes de produção, recomendamos usar a versão não Light; para ambientes de teste, é possível usar a versão Light para economizar custos.

## 2. A API de alta definição de imagem (Upscale) apenas ampliou a imagem, mas ela não ficou mais nítida?

Atualmente, a API Upscale realiza a “alta definição” principalmente aumentando a resolução, mas não possui capacidade de redesenhar detalhes com IA. Se você precisar de aprimoramento real de detalhes, recomendamos usar:

* A função Upscale do Midjourney (deve ser usada em conjunto com imagens geradas pelo MJ)
* Ou outros modelos especializados de aprimoramento de imagem

## 3. A API de geração de imagens retorna erro 500 ou o tempo de fila é muito longo?

Possíveis causas:

* Recursos limitados: em horários de pico (como à tarde e à noite), tarefas de geração de vídeo/imagem podem ficar na fila (TASK\_STATUS\_QUEUED). Recomendamos evitar horários de pico
* Instabilidade da versão Light: se você estiver usando a versão Light, podem ocorrer falhas intermitentes. Recomendamos tentar novamente ou mudar para a versão oficial
* Moderação de conteúdo: o prompt acionou a verificação de segurança (por exemplo, o Gemini retorna PROHIBITED\_CONTENT). Modifique o prompt

## 4. A URL da imagem gerada não pode ser acessada?

A URL COS retornada pela plataforma é um link pré-assinado (Presigned URL) e normalmente pode ser acessada publicamente. Se não for possível acessar, verifique:

* Se a URL foi truncada ou se caracteres extras foram adicionados ao copiá-la
* Se for usada em cenários como Mini Program do WeChat, é necessário configurar suporte a CORS (cross-origin). A plataforma já configura isso por padrão; se o erro persistir, entre em contato com o atendimento ao cliente

## 5. Sora 2 / Veo 3.1 gera lentamente ou falha?

Geração de vídeo é uma tarefa que consome muitos recursos:

* Fila é normal: em horários de pico, pode ser necessário aguardar de 2 a 30 minutos
* Tarefa perdida: se após mais de 30 minutos ainda não houver resultado e a consulta retornar "task not found", a tarefa pode ter falhado. Recomendamos tentar novamente
* Problemas de orientação horizontal/vertical: em algumas versões (como Sora2), os parâmetros de orientação horizontal/vertical podem não funcionar. Recomendamos usar primeiro o modo horizontal padrão

***

**Contato com o suporte**

Se o FAQ acima não resolver seu problema, entre em contato com o suporte técnico pelos seguintes meios:

* Grupo de suporte técnico no WeCom/WeChat (recomendado, resposta mais rápida)
* Formato das informações a fornecer:
  * Descrição do problema + capturas de tela
  * ID da conta (UUID)
  * Trace ID (se houver, geralmente aparece na mensagem de erro)
  * Parâmetros da solicitação (após mascarar informações sensíveis)