Docs Rivya AI

Modele API

Listeaza modelele Rivya API, intelege ID-urile de model, categoriile, limitele de prompt, media de referinta, starile de pregatire si dependentele Files API.

Ultima revizuire la 2026/05/11

Foloseste GET /api/v1/models pentru a lista modelele Rivya impreuna cu starea lor de pregatire pentru Public API.

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

Endpointul este public si read-only. Returneaza acelasi strat public de modele folosit de documentatia API si debuggerul online, inclusiv modele care inca nu sunt complet apelabile.

Forma raspunsului

Raspunsul foloseste aceasta 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": []
    }
  ]
}

Foloseste id ca valoare model in POST /api/v1/generations pentru modele de generare asincrona. Pentru modele de chat, foloseste POST /api/v1/chat/completions si verifica chat_capabilities.

Stari de disponibilitate

Referinta modelelor foloseste aceste stari publice:

  • available: cel putin o cale de generare Public API este disponibila
  • coming_soon: model de generare asincrona, dar momentan neexpus prin Public API
  • studio_only: modelul este disponibil prin Studio sau alta suprafata de produs, nu prin Public API v1

Campul de pregatire a inputului este mai specific:

  • available_text: cererile bazate pe prompt pot fi testate direct
  • available_url_input: URL-urile publice sau parametrii scalari pot fi testati direct
  • partial_requires_files: unele moduri pot fi apelate fara incarcare; modurile cu media de referinta ar trebui sa foloseasca Files API
  • requires_files_api: modelul depinde de media de referinta incarcata prin /api/v1/files

Foloseste Files API inainte sa apelezi moduri care necesita referinte imagine, video sau audio incarcate.

Pentru modelele de chat, chat_capabilities documenteaza daca Chat API accepta raspunsuri non-streaming, raspunsuri streaming, web search, atasamente imagine file_id, thoughts si reasoning effort.

Politica privind numarul de modele

Lista publica de modele se schimba pe masura ce Rivya adauga, elimina sau restrictioneaza modele.

Nu te baza pe un numar de modele hard-coded in integrarea ta. Citeste intotdeauna /api/v1/models sau Referinta API dinamica pentru modele.

Pagini asociate

Referinta API pentru modele

Cauta ID-uri de modele Rivya API, disponibilitate, moduri acceptate, tabele de parametri, limite de prompt, reguli pentru media de referinta si linkuri catre detalii de model.

Contract OpenAPI si schema

Revizuieste sursele de schema Rivya API v1, regulile de compatibilitate, campurile publice si contractul JSON OpenAPI read-only.

Cuprins

Forma raspunsului
Stari de disponibilitate
Politica privind numarul de modele
Pagini asociate