Documentación de Rivya AI

Modelos de la API

Lista modelos de Rivya API y entiende IDs de modelo, categorías, límites de prompt, medios de referencia, estados de preparación y dependencias de Files API.

Última revisión el 2026/05/11

Usa GET /api/v1/models para listar modelos de Rivya con su preparación para Public API.

curl https://rivya.ai/api/v1/models

El endpoint es público y de solo lectura. Devuelve la misma capa pública de modelos que usan la documentación de API y el depurador online, incluidos modelos que aún no son completamente invocables.

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: al menos una ruta de generación de Public API está disponible
  • coming_soon: modelo de generación asíncrona, pero actualmente no expuesto mediante Public API
  • studio_only: el modelo está disponible en Studio u otra superficie de producto, no mediante Public API v1

El campo de preparación de entrada es más específico:

  • available_text: las solicitudes basadas en prompt pueden probarse directamente
  • available_url_input: una URL pública o params escalares pueden probarse directamente
  • partial_requires_files: algunos modos pueden invocarse sin subida; los modos con medios de referencia deben usar Files API
  • requires_files_api: el modelo depende de medios de referencia subidos mediante /api/v1/files

Usa Files API antes de llamar a modos que requieren referencias de imagen, video o audio subidas.

Para modelos de chat, chat_capabilities documenta si Chat API admite respuestas sin streaming, respuestas streaming, búsqueda web, adjuntos de imagen file_id, thoughts y reasoning effort.

Política de conteo de modelos

La lista pública de modelos cambia a medida que Rivya añade, retira o restringe modelos.

No dependas de un conteo de modelos hard-coded en tu integración. Lee siempre /api/v1/models o la referencia dinámica de modelos de la API.

Páginas relacionadas

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.

Contrato de OpenAPI y schema

Revisa fuentes de schema de Rivya API v1, reglas de compatibilidad, campos públicos y el contrato JSON de OpenAPI de solo lectura.

Tabla de contenido

Forma de respuesta
Estados de disponibilidad
Política de conteo de modelos
Páginas relacionadas