Images
Cria uma imagem a partir de um prompt, ou edita as imagens enviadas.
Atualizado em 09 de ago. de 2026
Gera e edita imagens com o hinow/himegia. Uma chamada, uma imagem, preço fixo por imagem. O uso guiado está em Geração de imagem.
https://api.hinow.ai/v1/imagesBearerCria uma imagem a partir de um prompt, ou edita as imagens enviadas em images.
Parâmetros
modelstring· bodyobrigatório`hinow/himegia` para o modelo de imagem da HiNow.
promptstring· bodyobrigatórioA descrição da cena — ou, com `images`, a instrução de edição.
imagesarray· bodyImagens de origem para edição ou referência: URLs públicas ou `data:` em base64.
parameters.aspect_ratiostring· body`1:1` (padrão), `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `21:9`, `9:21`.
parameters.output_formatstring· body`jpeg` (padrão), `png` ou `webp`.
parameters.num_inference_stepsinteger· bodyPassos de inferência: 20 a 40, padrão 28. Mais passos, mais detalhe, mais tempo.
parameters.guidance_scalenumber· bodyAderência ao prompt: 1.5 a 3.5, padrão 2.5.
Respostas
{
"success": true,
"data": {
"urls": ["https://s3.us1-stlouis.hinow.ai/hi-storage/.../8c9ab329.jpg"],
"thumbnail_url": "https://s3.us1-stlouis.hinow.ai/hi-storage/.../8c9ab329_thumb.webp",
"model": "hinow/himegia",
"category": "text_to_image",
"operation": "generate",
"cost": { "amount": 0.082, "currency": "USD", "value_type": "per_image" },
"metadata": { "format": "image/jpeg", "size": 236652 }
},
"request_id": "83d88c3e-6219-4efd-a6fb-6fed0df29c23"
}| Campo | O que diz |
|---|---|
data.urls | A imagem gerada, no armazenamento da plataforma. Baixe e guarde do seu lado o que for para produção. |
data.thumbnail_url | Miniatura em webp, para listagem e pré-visualização. |
data.operation | generate quando criou do zero; editing quando trabalhou sobre images. |
data.cost | O custo exato da chamada — { "amount": 0.082, "value_type": "per_image" }. |
data.metadata | Formato e tamanho em bytes do arquivo final. |
request_id | Identificador da chamada, para suporte e auditoria. |
O envelope de erro é próprio deste endpoint
Erros vêm como {"success": false, "error": {"code": "MODEL_NOT_FOUND", "num_code": 4001, "message": "..."}} — o mesmo formato da autenticação, não o de https://api.hinow.ai/v1/chat/completions. Trate pelo código HTTP e pelo error.code.
Timeouts de outra escala
A geração leva de poucos segundos a mais de trinta, conforme a complexidade do pedido. Use timeout de pelo menos 120 segundos e processe em fila quando o volume for alto.