Imagens

Criar uma geração

Um pedido contém model, prompt e apenas parâmetros de artefacto aplicáveis: tamanho, proporção, formato ou número de resultados.

Não use um modelo de texto como identificador de imagem: selecione o modelo pela respetiva modalidade no catálogo.

curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Referências e edição

• Envie imagens de referência através de input_references apenas na forma suportada pelo modelo selecionado.
• A transformação e edição de imagem para imagem usam a mesma rota /images, com a referência de origem e uma instrução textual.
• Verifique o tipo MIME, o tamanho e os direitos de um ficheiro de entrada antes de o enviar.

Receber o artefacto

Na resposta compatível, leia data[].b64_json como bytes de imagem; media_type pode identificar o formato. Conserve os metadados com o pedido e o modelo.

Não publique um resultado parcial como final. Na entrega transmitida, distinga um evento de rascunho de um artefacto concluído.