Documentazione Rivya AI

Modelli API

Elenca i modelli Rivya API, comprendi ID modello, categorie, limiti prompt, media di riferimento, stati di readiness e dipendenze Files API.

Ultima revisione il 2026/05/11

Usa GET /api/v1/models per elencare i modelli Rivya con la loro readiness Public API.

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

L'endpoint è pubblico e in sola lettura. Restituisce lo stesso livello pubblico dei modelli usato dalla documentazione API e dal debugger online, inclusi modelli non ancora pienamente richiamabili.

Forma della risposta

La risposta usa questa 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 come valore model in POST /api/v1/generations per i modelli di generazione asincrona. Per i modelli chat, usa POST /api/v1/chat/completions e controlla chat_capabilities.

Stati di disponibilità

Il riferimento modelli usa questi stati pubblici:

  • available: almeno un percorso di generazione Public API è disponibile
  • coming_soon: modello di generazione asincrona, ma non attualmente esposto tramite Public API
  • studio_only: modello disponibile tramite Studio o un'altra superficie prodotto, non tramite Public API v1

Il campo di readiness dell'input è più specifico:

  • available_text: le richieste basate su prompt possono essere testate direttamente
  • available_url_input: URL pubblici o parametri scalari possono essere testati direttamente
  • partial_requires_files: alcune modalità possono essere chiamate senza upload; le modalità con media di riferimento dovrebbero usare Files API
  • requires_files_api: il modello dipende da media di riferimento caricati tramite /api/v1/files

Usa Files API prima di chiamare modalità che richiedono riferimenti immagine, video o audio caricati.

Per i modelli chat, chat_capabilities documenta se Chat API supporta risposte non streaming, risposte streaming, web search, allegati immagine file_id, thoughts e reasoning effort.

Policy sul conteggio dei modelli

L'elenco pubblico dei modelli cambia quando Rivya aggiunge, rimuove o limita l'accesso ai modelli.

Non fare affidamento su un conteggio modelli hard-coded nella tua integrazione. Leggi sempre /api/v1/models o il riferimento API dei modelli dinamico.

Pagine correlate

Riferimento API dei modelli

Consulta ID modelli Rivya API, disponibilità, modalità supportate, tabelle parametri, limiti prompt, regole per media di riferimento e link ai dettagli dei modelli.

OpenAPI e contratto dello schema

Rivedi sorgenti schema Rivya API v1, regole di compatibilità, campi pubblici e contratto OpenAPI JSON in sola lettura.

Indice

Forma della risposta
Stati di disponibilità
Policy sul conteggio dei modelli
Pagine correlate