Listuj modele Rivya API, poznaj ID modeli, kategorie, limity promptów, media referencyjne, stany gotowości i zależności od Files API.

Użyj GET /api/v1/models, aby wyświetlić modele Rivya wraz z ich gotowością Public API.

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

Endpoint jest publiczny i tylko do odczytu. Zwraca tę samą publiczną warstwę modeli, której używają dokumentacja API i debugger online, w tym modele, które nie są jeszcze w pełni wywoływalne.

Kształt Odpowiedzi

Odpowiedź używa tego kształtu:

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

Użyj id jako wartości model w POST /api/v1/generations dla asynchronicznych modeli generowania. Dla modeli czatu użyj POST /api/v1/chat/completions i sprawdź chat_capabilities.

Stany Dostępności

Referencja modeli używa tych publicznych stanów:

available: dostępna jest co najmniej jedna ścieżka generowania Public API
coming_soon: asynchroniczny model generowania, ale obecnie nieudostępniony przez Public API
studio_only: model jest dostępny przez Studio albo inną powierzchnię produktu, nie przez Public API v1

Pole gotowości wejścia jest bardziej szczegółowe:

available_text: żądania oparte na promptach można testować bezpośrednio
available_url_input: publiczny URL albo parametry skalarne można testować bezpośrednio
partial_requires_files: niektóre tryby można wywołać bez uploadu; tryby z mediami referencyjnymi powinny używać Files API
requires_files_api: model zależy od mediów referencyjnych przesłanych przez /api/v1/files

Użyj Files API przed wywołaniem trybów, które wymagają przesłanych referencji obrazu, wideo albo audio.

Dla modeli czatu chat_capabilities dokumentuje, czy Chat API obsługuje odpowiedzi niestreamingowe, odpowiedzi streamingowe, wyszukiwanie w sieci, załączniki obrazów przez file_id, thoughts i reasoning effort.

Polityka Liczby Modeli

Publiczna lista modeli zmienia się, gdy Rivya dodaje, usuwa albo ogranicza dostęp do modeli.

Nie polegaj w swojej integracji na zakodowanej na stałe liczbie modeli. Zawsze odczytuj /api/v1/models albo dynamiczną Referencję modeli API.

Modele API

Kształt Odpowiedzi

Stany Dostępności

Polityka Liczby Modeli

Powiązane Strony

Spis treści