Gerar imagem
Coloque uma imagem em fila a partir de uma instrução de texto e consulte o resultado. Devolve um identificador de tarefa de imediato em vez de manter a ligação aberta.
Uma imagem demora cerca de 10 a 40 segundos, demasiado para manter um pedido HTTP aberto. Por isso a geração são duas chamadas: iniciar uma tarefa e depois consultá-la.
POST /api/v1/ai/images
POST /api/v1/ai/images
{
"prompt": "uma bicicleta vermelha encostada a uma parede amarela, luz suave da manhã",
"aspectRatio": "16:9",
"model": "premium"
}| Campo | Obrigatório | Descrição |
|---|---|---|
| prompt | Sim | O que desenhar. Até 2000 caracteres |
| aspectRatio | Não | 1:1 (padrão), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21 |
| model | Não | standard (padrão) ou premium |
| quality | Não | LOW, MEDIUM ou HIGH |
| sessionId | Não | Agrupa imagens relacionadas. Sem ele, é criada uma sessão |
| referenceImages | Não | Até 5 URL de imagens públicas para orientar o resultado |
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "queued"
}Guarde o sessionId e passe-o na chamada seguinte para manter um conjunto de imagens junto, como uma conversa guarda as suas mensagens. Sem ele, cada imagem abre a sua própria sessão.
GET /api/v1/ai/images/{jobId}
GET /api/v1/ai/images/generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "completed",
"imageUrl": "https://cdn.adaptlypost.com/ai-images/ai-studio-4c81b93.png",
"imageId": "d7e44a10-93bc-4f27-8ae5-1b06c2f4d938",
"error": null
}| Estado | Significado |
|---|---|
queued | À espera de um worker |
generating | O modelo está a desenhar |
processing | A enviar o resultado |
completed | imageUrl está pronta |
failed | error diz porquê |
Consulte a cada 3 a 5 segundos. Mais depressa só gasta o seu limite de pedidos.
imageUrl aponta para o CDN e pode ir diretamente nos mediaUrls de uma publicação, por isso gerar e agendar é: criar a imagem, consultar até completed, e depois criar uma publicação com esse URL.
Créditos
Os créditos são cobrados quando a geração começa e devolvidos automaticamente se falhar, por isso uma tarefa falhada não custa nada. Com a sua própria chave da OpenAI ou da Google ligada, as imagens passam pela sua chave e não consomem créditos. premium e standard custam valores diferentes.