Liste Rivya API-Modelle auf und verstehe Modell-IDs, Kategorien, Prompt-Limits, Referenzmedien, Readiness-Zustände und Files API-Abhängigkeiten.

Nutze GET /api/v1/models, um Rivya-Modelle mit ihrer Public-API-Readiness aufzulisten.

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

Der Endpoint ist öffentlich und read-only. Er gibt dieselbe öffentliche Modellschicht zurück, die API-Dokumentation und Online-Debugger verwenden, einschließlich Modellen, die noch nicht vollständig aufrufbar sind.

Response-Form

Die Antwort verwendet diese Form:

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

Nutze id als model-Wert in POST /api/v1/generations für asynchrone Generation-Modelle. Verwende für Chat-Modelle POST /api/v1/chat/completions und prüfe chat_capabilities.

Verfügbarkeitszustände

Die Modellreferenz verwendet diese öffentlichen Zustände:

available: mindestens ein Public-API-Generation-Pfad ist verfügbar
coming_soon: asynchrones Generation-Modell, aber aktuell nicht über Public API verfügbar
studio_only: Modell ist über Studio oder eine andere Produktfläche verfügbar, nicht über Public API v1

Das Feld zur Input-Readiness ist spezifischer:

available_text: promptbasierte Anfragen können direkt getestet werden
available_url_input: öffentliche URL oder skalare Params können direkt getestet werden
partial_requires_files: einige Modi können ohne Upload aufgerufen werden; Referenzmedien-Modi sollten Files API verwenden
requires_files_api: das Modell hängt von hochgeladenen Referenzmedien über /api/v1/files ab

Nutze Files API, bevor du Modi aufrufst, die hochgeladene Bild-, Video- oder Audio-Referenzen erfordern.

Für Chat-Modelle dokumentiert chat_capabilities, ob Chat API nicht streamende Antworten, Streaming-Antworten, Websuche, Bildanhänge per file_id, Thoughts und Reasoning Effort unterstützt.

Policy zur Modellanzahl

Die öffentliche Modellliste ändert sich, wenn Rivya Modelle hinzufügt, entfernt oder gated.

Verlasse dich in deiner Integration nicht auf eine hart codierte Modellanzahl. Lies immer /api/v1/models oder die dynamische Modell-API-Referenz.

API Models

Response-Form

Verfügbarkeitszustände

Policy zur Modellanzahl

Verwandte Seiten

Inhaltsverzeichnis