API Modelleri

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

• temporarily_unavailable: model geçici olarak kullanılamıyor ve şu anda Public API v1 üzerinden çağrılamaz

• studio_only: model Studio veya başka bir ürün alanı ü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.

İlgili Sayfalar

• Model API Referansı

• Oluşturma İşi Başlatma

• Chat API

• Rivya Model Seçim Rehberi

• Rivya'da Model Kullanılabilirliği

Salt okunur Yakında kayıtları

• coming_soon: model yalnızca keşif için listelenir; Generation veya Chat API'ye gönderilemez. supports_direct_generation: false, null runtime, faturalandırma ve fiyat ile boş supported_modes ve params döner. İsteklerde api_status: available seçin.