Rivya API modellerini listeleyin; model ID'lerini, kategorileri, prompt limitlerini, referans medyayı, readiness durumlarını ve Files API bağımlılıklarını anlayın.

Rivya modellerini Public API readiness durumlarıyla listelemek için GET /api/v1/models kullanın.

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

Bu endpoint public ve salt okunurdur. API dokümanları ve online debugger tarafından kullanılan aynı public model katmanını döndürür; henüz tamamen çağrılabilir olmayan modelleri de içerir.

Yanıt Şekli

Yanıt şu şekli kullanır:

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

Asenkron oluşturma modelleri için POST /api/v1/generations içinde id değerini model değeri olarak kullanın. Chat modelleri için POST /api/v1/chat/completions kullanın ve chat_capabilities alanını kontrol edin.

Kullanılabilirlik Durumları

Model referansı şu public durumları kullanır:

available: en az bir Public API oluşturma yolu kullanılabilir
coming_soon: asenkron oluşturma modeli, ancak şu anda Public API üzerinden sunulmuyor
studio_only: model Studio veya başka bir ürün yüzeyi üzerinden kullanılabilir, Public API v1 üzerinden kullanılamaz

Input readiness alanı daha spesifiktir:

available_text: prompt tabanlı istekler doğrudan test edilebilir
available_url_input: public URL veya scalar params doğrudan test edilebilir
partial_requires_files: bazı modlar yükleme olmadan çağrılabilir; referans medya modları Files API kullanmalıdır
requires_files_api: model, /api/v1/files üzerinden yüklenen referans medyaya bağlıdır

Yüklenmiş görüntü, video veya ses referansları gerektiren modları çağırmadan önce Files API kullanın.

Chat modelleri için chat_capabilities, Chat API'nin non-streaming yanıtları, streaming yanıtları, web araması, görüntü file_id ekleri, thoughts ve reasoning effort desteğini belgeler.

Model Sayısı Politikası

Rivya model ekledikçe, kaldırdıkça veya erişime kapattıkça public model listesi değişir.

Entegrasyonunuzda hard-coded model sayısına güvenmeyin. Her zaman /api/v1/models veya dinamik Model API Referansı sayfasını okuyun.

API Modelleri

Yanıt Şekli

Kullanılabilirlik Durumları

Model Sayısı Politikası

İlgili Sayfalar

İçindekiler