Crea una generación
Una solicitud contiene model, prompt y solo los parámetros de artefacto aplicables: tamaño, relación de aspecto, formato o cantidad de resultados.
No uses un modelo de texto como identificador de imagen: selecciona el modelo según la modalidad del catálogo.
Solicitud de generación de imágenes
bash
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
}'Referencias y edición
- Envía imágenes de referencia mediante input_references solo en la forma compatible con el modelo elegido.
- La conversión de imagen a imagen y la edición usan la misma ruta /images con la referencia de origen y una instrucción textual.
- Comprueba tipo MIME, tamaño y derechos del archivo de entrada antes de enviarlo.
Recibe el artefacto
En la respuesta compatible, lee data[].b64_json como bytes de imagen; media_type puede identificar el formato. Conserva los metadatos con su indicación y su modelo.
No publiques un resultado parcial como final. En streaming, distingue un evento de borrador de un artefacto terminado.