Documentație Rivya AI

Modele API

Listează modelele Rivya API, înțelege ID-urile modelelor, categoriile, limitele prompturilor, materialele de referință, stările de disponibilitate și dependențele Files API.

Ultima revizuire la 2026/05/11

Folosește GET /api/v1/models pentru a lista modelele Rivya împreună cu starea lor de disponibilitate pentru Public API.

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

Endpointul este public și doar pentru citire. Returnează același catalog public de modele folosit de documentația API și instrumentul online de depanare, inclusiv modele care încă nu pot fi apelate complet.

Forma răspunsului

Răspunsul folosește această structură:

{
  "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": []
    }
  ]
}

Folosește id ca valoare model în POST /api/v1/generations pentru modelele de generare asincronă. Pentru modelele de chat, folosește POST /api/v1/chat/completions și verifică chat_capabilities.

Stări de disponibilitate

Referința modelelor folosește aceste stări publice:

  • available: este disponibil cel puțin un traseu de generare prin Public API
  • coming_soon: model de generare asincronă care nu este expus momentan prin Public API
  • studio_only: modelul este disponibil prin Studio sau în altă zonă a produsului, nu prin Public API v1

Câmpul privind disponibilitatea intrărilor este mai specific:

  • available_text: cererile bazate pe prompt pot fi testate direct
  • available_url_input: URL-urile publice sau parametrii scalari pot fi testați direct
  • partial_requires_files: unele moduri pot fi apelate fără încărcare; modurile cu materiale de referință trebuie să folosească Files API
  • requires_files_api: modelul depinde de materiale de referință încărcate prin /api/v1/files

Folosește Files API înainte să apelezi moduri care necesită referințe imagine, video sau audio încărcate.

Pentru modelele de chat, chat_capabilities arată dacă Chat API acceptă răspunsuri fără streaming, răspunsuri cu streaming, căutare web, imagini atașate prin file_id, gândurile modelului și nivelul de raționament.

Politica privind numărul de modele

Lista publică de modele se schimbă pe măsură ce Rivya adaugă, elimină sau restricționează modele.

Nu te baza în integrare pe un număr de modele scris direct în cod. Consultă întotdeauna /api/v1/models sau Referința API dinamică 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 răspunsului
Stări de disponibilitate
Politica privind numărul de modele
Pagini asociate