Geração de imagens
Gere uma imagem com um Model ID com capacidade de imagem do catálogo compartilhado.
Antes de gerar uma imagem, confirme no catálogo a interface do modelo, as dimensões compatíveis, o método de saída e a unidade de faturamento.
Endpoint da solicitação
Modelos com uma interface compatível de geração de imagens usam:
POST https://api.vergora.ai/v1/images/generationsSe um modelo usar outra interface, siga a documentação dele em vez de reutilizar esta solicitação.
Exemplo de solicitação
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "Uma ilustração limpa de uma cidade pela manhã",
"size": "YOUR_SUPPORTED_SIZE"
}Campos da solicitação
| Campo | Descrição |
|---|---|
model | Um Model ID compatível com geração de imagens |
prompt | Descreve o tema, a cena, a composição e o resultado desejado |
size | Dimensão ou proporção compatível com o modelo selecionado |
| Outros parâmetros | Use quantidade, qualidade, imagem de referência ou outros campos apenas quando compatíveis |
Leia o resultado
Dependendo da interface do modelo, o resultado pode conter uma URL de imagem, dados de imagem codificados ou o status de uma tarefa:
- Verifique o status e a estrutura da resposta.
- Leia o identificador da imagem ou tarefa conforme definido pela interface.
- Se um identificador de tarefa for retornado, use o método de consulta de status documentado para a interface.
- Guarde o identificador da solicitação ou tarefa para investigar problemas e revisar custos.
Uma solicitação enviada não significa que a geração da imagem foi concluída.
Armazene a imagem
Baixe ou persista os recursos gerados no seu próprio armazenamento. A validade e os requisitos de acesso de URLs temporárias dependem da resposta real. Uma URL de resultado pode conter parâmetros sensíveis de acesso; revise-a antes de compartilhar.
Custo e novas tentativas
Solicitações de imagem podem ser cobradas por quantidade, dimensões, qualidade ou outra unidade. Considere o preço do modelo e o registro da solicitação como referência definitiva. Após um timeout, verifique a solicitação ou tarefa existente antes de gerar a imagem novamente.