Generación de imágenes
Genere una imagen con un Model ID con capacidad de imagen del catálogo compartido.
Antes de generar una imagen, confirme en el catálogo la interfaz del modelo, dimensiones admitidas, método de salida y unidad de facturación.
Endpoint de solicitud
Los modelos con una interfaz compatible de generación de imágenes usan:
POST https://api.vergora.ai/v1/images/generationsSi un modelo usa otra interfaz, siga su documentación en lugar de reutilizar esta solicitud.
Ejemplo de solicitud
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "Una ilustración limpia de una ciudad por la mañana",
"size": "YOUR_SUPPORTED_SIZE"
}Campos de solicitud
| Campo | Descripción |
|---|---|
model | Un Model ID compatible con la generación de imágenes |
prompt | Describe el sujeto, escena, composición y resultado deseado |
size | Dimensión o relación de aspecto admitida por el modelo seleccionado |
| Otros parámetros | Use cantidad, calidad, imagen de referencia u otros campos solo si son compatibles |
Lea el resultado
Según la interfaz del modelo, el resultado puede contener una URL de imagen, datos de imagen codificados o el estado de una tarea:
- Compruebe el estado y la estructura de la respuesta.
- Lea el identificador de imagen o tarea según la interfaz.
- Si se devuelve un identificador de tarea, use el método de consulta de estado documentado para esa interfaz.
- Guarde el identificador de solicitud o tarea para diagnosticar problemas y revisar costos.
Enviar una solicitud no significa que haya terminado la generación de la imagen.
Guarde la imagen
Descargue o guarde los recursos generados en su propio almacenamiento. La vigencia y los requisitos de acceso de las URL temporales dependen de la respuesta real. Una URL de resultado puede contener parámetros sensibles de acceso; revísela antes de compartirla.
Costo y reintentos
Las solicitudes de imágenes pueden facturarse por cantidad, dimensiones, calidad u otra unidad. Tome el precio del modelo y el registro de solicitud como referencia definitiva. Tras un tiempo de espera agotado, revise la solicitud o tarea existente antes de generar de nuevo la imagen.