Vypište modely Rivya API a porozumějte ID modelů, kategoriím, limitům promptů, referenčním médiím, stavům připravenosti a závislostem na Files API.

Použijte GET /api/v1/models pro výpis modelů Rivya včetně jejich připravenosti pro Public API.

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

Endpoint je veřejný a pouze pro čtení. Vrací stejnou veřejnou modelovou vrstvu, kterou používají API dokumentace a online debugger, včetně modelů, které ještě nejsou plně volatelné.

Tvar odpovědi

Odpověď používá tento tvar:

{
  "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 asynchronních modelů generování použijte id jako hodnotu model v POST /api/v1/generations. U chatových modelů použijte POST /api/v1/chat/completions a zkontrolujte chat_capabilities.

Stavy dostupnosti

Reference modelů používá tyto veřejné stavy:

available: dostupná je alespoň jedna cesta generování přes Public API
coming_soon: asynchronní model generování, který ale aktuálně není vystaven přes Public API
studio_only: model je dostupný přes Studio nebo jiné produktové rozhraní, ne přes Public API v1

Pole připravenosti vstupu je konkrétnější:

available_text: požadavky založené na promptu lze testovat přímo
available_url_input: veřejné URL nebo skalární parametry lze testovat přímo
partial_requires_files: některé režimy lze volat bez uploadu; režimy s referenčními médii by měly použít Files API
requires_files_api: model závisí na referenčních médiích nahraných přes /api/v1/files

Před voláním režimů, které vyžadují nahrané obrazové, video nebo audio reference, použijte Files API.

U chatových modelů chat_capabilities dokumentuje, zda Chat API podporuje nestreamované odpovědi, streamované odpovědi, webové vyhledávání, obrazové přílohy file_id, thoughts a reasoning effort.

Pravidla pro počet modelů

Veřejný seznam modelů se mění podle toho, jak Rivya modely přidává, odebírá nebo zpřístupňuje postupně.

Nespoléhejte ve své integraci na natvrdo zapsaný počet modelů. Vždy čtěte /api/v1/models nebo dynamickou referenci modelového API.

Modely API

Tvar odpovědi

Stavy dostupnosti

Pravidla pro počet modelů

Související stránky

Obsah