Modelos de la API
Consulta los modelos de la API de Rivya y comprende sus identificadores, categorías, límites de instrucciones, archivos de referencia, estados de disponibilidad y dependencias de la Files API.
Última revisión el 2026/08/11
Usa GET /api/v1/models para consultar los modelos de Rivya y su disponibilidad en la API pública.
curl https://rivya.ai/api/v1/modelsEl endpoint es público y de solo lectura. Devuelve el mismo catálogo público de modelos que usan la documentación de la API y el depurador en línea, incluidos los modelos que aún no pueden invocarse con todas sus funciones.
Forma de respuesta
La respuesta usa esta forma:
{
"object": "list",
"data": [
{
"id": "z-image",
"display_name": "Z-Image",
"category": "image",
"runtime": "async_task",
"base_credits": 1,
"billing_type": "FIXED",
"supported_modes": ["text-to-image"],
"max_prompt_length": 1000,
"reference_media": null,
"params": [],
"api_status": "available",
"api_input_status": "available_text",
"supported_api_inputs": ["text"],
"requires_files_api": false,
"requires_upload_for_modes": [],
"url_input_supported": false,
"file_kinds": [],
"chat_capabilities": null,
"notices": []
}
]
}Usa id como valor de model en POST /api/v1/generations para modelos de generación asíncrona. Para modelos de chat, usa POST /api/v1/chat/completions y revisa chat_capabilities.
Estados de disponibilidad
La referencia de modelos usa estos estados públicos:
available: hay disponible al menos una ruta de generación mediante la API públicatemporarily_unavailable: modelo temporalmente no disponible que no se puede llamar actualmente mediante la API pública v1studio_only: el modelo está disponible en Studio u otra área del producto, pero no mediante la API pública v1
El campo de preparación de entrada es más específico:
available_text: las solicitudes basadas en instrucciones de texto pueden probarse directamenteavailable_url_input: una URL pública o parámetros escalares pueden probarse directamentepartial_requires_files: algunos modos pueden invocarse sin subir archivos; los modos con archivos de referencia deben usar la Files APIrequires_files_api: el modelo depende de medios de referencia subidos mediante/api/v1/files
Usa la Files API antes de llamar a modos que requieran imágenes, vídeos o audios de referencia subidos.
Para los modelos de chat, chat_capabilities indica si la Chat API admite respuestas completas o en streaming, búsqueda web, imágenes adjuntas mediante file_id, contenido de razonamiento y ajuste del esfuerzo de razonamiento.
Política de recuento de modelos
La lista pública de modelos cambia a medida que Rivya añade, retira o restringe modelos.
No uses en tu integración un número de modelos codificado manualmente. Consulta siempre /api/v1/models o la referencia dinámica de modelos de la API.
Páginas relacionadas
Entradas de descubrimiento Próximamente
coming_soon: el modelo solo se muestra para descubrirlo y no puede enviarse a Generations ni Chat API. Estas entradas devuelvensupports_direct_generation: false, runtime, facturación y precio nulos, ysupported_modesyparamsvacíos. Para solicitudes, eligeapi_status: available.
SDK TypeScript de Rivya
Usa la beta del SDK TypeScript de Rivya para llamar a Public API v1 para modelos, generaciones, archivos, créditos, webhooks y Chat, incluido streaming SSE.
Referencia de modelos de la API
Consulta IDs de modelos de Rivya API, disponibilidad, modos admitidos, tablas de parámetros, límites de prompt, reglas de medios de referencia y enlaces de detalle de modelo.