HY Image 3.5 Preview API

A HY Image 3.5 Preview API dá acesso ao HY Image 3.5 Preview, o modelo de geração e edição de imagens da Tencent Hunyuan lançado como prévia hospedada em 22 de setembro de 2026. Ele reúne texto em imagem, geração com referências e edição em um só modelo. No APIMart, envie o ID de modelo hy-image-v3.5-preview.

O HunyuanImage 3.0 é o modelo anterior de pesos abertos da Tencent. O HY Image 3.5 Preview é um modelo hospedado sem pesos publicados, e a Tencent o apresenta como uma evolução em renderização de texto, realismo e consistência nas edições.

A Tencent classifica esta versão como prévia, então a qualidade, os limites e o modelo subjacente podem mudar. Teste fluxos importantes com a HY Image API antes de usar em produção e acompanhe esta página para novidades.

Envie em image_urls até cinco URLs públicas de imagens JPEG, PNG ou WebP, de preferência com menos de 7 MB cada. Descreva no prompt quais elementos manter, alterar ou combinar. Sem image_urls, o hy-image-v3.5-preview gera a imagem a partir do texto.

Defina size como auto (padrão) ou 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ou 21:9, e resolution como 1K (padrão), 2K ou 4K. Para um tamanho exato, passe ao hy-image-v3.5-preview um size como 2000x1104 ou um par width/height: de 256 a 8192 px por lado e no máximo 8.294.400 pixels.

Não. O HY Image 3.5 Preview retorna uma imagem por solicitação, então n deve ser 1. Envie solicitações em paralelo se precisar de várias variações.

Sim. Envie o resultado anterior de volta ao hy-image-v3.5-preview como imagem de referência com uma nova instrução. Cada rodada é uma solicitação separada.

O HY Image 3.5 Preview cobra cada imagem gerada uma vez. Com proporção, o nível de resolution define o valor; com pixels exatos, vale o lado menor: até 1024 px é 1K, de 1025 a 2048 px é 2K e acima disso é 4K. A tabela de preços mostra os valores atualizados, e tarefas com falha são totalmente reembolsadas.

Entre no APIMart, adicione créditos e crie uma chave na página API Keys. Envie-a como token Bearer no cabeçalho Authorization; a mesma chave de API funciona para todas as solicitações à HY Image API e para os outros modelos do APIMart.

Envie a solicitação com o modelo hy-image-v3.5-preview para POST /v1/images/generations, guarde o task_id e consulte GET /v1/tasks/{task_id} a cada 3–5 segundos por até cerca de 5 minutos. Quando o status for completed, leia result.images[0].url[0] e baixe a imagem antes de expires_at.

Sim, todos esses nomes se referem ao mesmo modelo da Tencent. No endpoint de imagens, o ID é hy-image-v3.5-preview; a documentação de chat da Tencent escreve Hy-Image-3.5-Preview e sites de benchmark listam HunyuanImage 3.5 (Preview). Grafias como HY-Image 3.5, Hy Image3.5, HY Image v3.5 ou Hunyuan Image 3.5 API apontam para o mesmo modelo. No APIMart, chame-o pela HY Image API com hy-image-v3.5-preview.

Você pode nos contatar pelo chat ao vivo no canto inferior direito da página, enviar um e-mail para [email protected] ou entrar na nossa comunidade do Discord. Nossa equipe responderá o mais rápido possível.