Modele API

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.

Formă 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

• temporarily_unavailable: modelul este temporar indisponibil și nu poate fi apelat momentan prin Public API v1

• 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

Listă 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

• Referința API pentru modele

• Creează o generare

• Chat API

• Ghidul Rivya pentru alegerea modelelor

• Disponibilitatea modelelor în Rivya

Intrări În curând doar pentru citire

• coming_soon: modelul este listat doar pentru descoperire și nu poate fi trimis la API-ul de generare sau Chat. Returnează supports_direct_generation: false, runtime, facturare și preț null, plus supported_modes și params goale. Pentru cereri alege api_status: available.