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
temporarily_unavailable: Modell ist vorübergehend nicht verfügbar und kann derzeit nicht über Public API v1 aufgerufen werden
studio_only: Modell ist über Studio oder einen anderen Produktbereich 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.

Schreibgeschützte Demnächst-Einträge

coming_soon: Das Modell dient nur zur Entdeckung und kann nicht an Generation oder Chat API gesendet werden. Es liefert supports_direct_generation: false, null für Laufzeit, Abrechnung und Preise sowie leere supported_modes und params. Verwende für Anfragen api_status: available.

API Models

Response-Form

Verfügbarkeitszustände

Policy zur Modellanzahl

Verwandte Seiten

Schreibgeschützte Demnächst-Einträge

Inhaltsverzeichnis