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.
