APIMaster.ai

Hy Image 3.5 Preview · Referência da API e faturamento

Gere imagens a partir de texto ou referências e faça edições em várias rodadas.

Envie JSON com autenticação Bearer e uma chave de API da APIMaster válida.

POST /v1/wand/hunyuan-image/v35-generation · Content-Type: application/json

Parâmetros da solicitação

Campo Tipo Descrição
model string hy-image-v3.5-preview (obrigatório).
messages object[] Mensagens em ordem cronológica. A última mensagem user contém a instrução atual e as anteriores fornecem o contexto de edição. Obrigatório.
size string Dimensões no formato larguraxaltura, como 4096x4096. Cada lado aceita de 256 a 8192 pixels, com área máxima de 16,777,216 pixels.
seed int64 Inteiro de 0 a 2⁶³−1. Use 0 ou omita o campo para obter uma semente aleatória.
generate_max_pixels integer Aplica-se quando não há size. Opções: 1,048,576, 2,359,296 (padrão) e 4,194,304. Valores intermediários usam a faixa mais próxima. Para 4K, use size.
resize_max_pixels integer Imagens de referência acima dessa área são reduzidas proporcionalmente. Padrão: 1,048,576 pixels.
session string Mantenha o valor na mesma sessão de edição para facilitar o reaproveitamento de rota e cache KV.
footnote string Marca-d'água no canto inferior direito, com até 16 caracteres Unicode.
use_search_tool object Use {"value":true} ou {"value":false}. A busca vem desativada por padrão.

Cada mensagem inclui role (user, assistant ou tool) e um array content. Use type=text com text ou type=image_url com image_url:{url:...}. Envie URLs públicas ou URIs de dados com prefixo MIME. Limites: 20 MB por imagem, 20 imagens por contexto e 100,000 tokens de contexto. Em respostas de ferramentas, informe o tool_call_id correspondente. Marque imagens já geradas com is_generate:true.

Uma mensagem assistant pode reenviar reasoning e tool_calls como foram recebidos. Se apenas chamar uma ferramenta, pode omitir content. A chamada usa {id,type:"function",function:{name,arguments}}, com uma string JSON em arguments.

curl -X POST "https://apimaster.ai/v1/wand/hunyuan-image/v35-generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy-image-v3.5-preview","size":"1024x1024","messages":[{"role":"user","content":[{"type":"text","text":"Um círculo azul sobre fundo branco"}]}]}'

Resposta

A resposta pode trazer quadros JSON consecutivos. Siga o Content-Type retornado. O URL final fica em choices[0].delta.image.url, com dimensões em width e height. Uma resposta bem-sucedida pode ter finish_reason nulo. Verifique o URL e baixe a imagem antes que expire. Use assembled_history para continuar editando. Guarde o request_id em caso de erro ou desconexão. Repetir a geração pode gerar nova cobrança.

Faturamento

O gateway reserva saldo e cobra uma vez com base em tokenhub_usage.total_tokens. Consulte a ficha para ver o preço atual da APIMaster.