Μοντέλα API

Χρησιμοποιήστε GET /api/v1/models για να εμφανίσετε τα μοντέλα Rivya με την ετοιμότητά τους για Public API.

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

Το endpoint είναι δημόσιο και read-only. Επιστρέφει το ίδιο δημόσιο επίπεδο μοντέλων που χρησιμοποιείται από τα API docs και τον online debugger, συμπεριλαμβανομένων μοντέλων που δεν είναι ακόμη πλήρως callable.

Μορφή απάντησης

Η απάντηση χρησιμοποιεί αυτή τη μορφή:

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

Χρησιμοποιήστε το id ως τιμή model στο POST /api/v1/generations για ασύγχρονα μοντέλα generation. Για μοντέλα chat, χρησιμοποιήστε POST /api/v1/chat/completions και ελέγξτε το chat_capabilities.

Καταστάσεις διαθεσιμότητας

Η αναφορά μοντέλων χρησιμοποιεί αυτές τις δημόσιες καταστάσεις:

• available: είναι διαθέσιμη τουλάχιστον μία διαδρομή generation μέσω Public API

• temporarily_unavailable: το μοντέλο είναι προσωρινά μη διαθέσιμο και δεν μπορεί προς το παρόν να κληθεί μέσω Public API v1

• studio_only: το μοντέλο είναι διαθέσιμο μέσω Studio ή άλλης περιοχής του προϊόντος, όχι μέσω Public API v1

Το πεδίο ετοιμότητας εισόδου είναι πιο συγκεκριμένο:

• available_text: αιτήματα βασισμένα σε prompt μπορούν να δοκιμαστούν απευθείας

• available_url_input: δημόσιο URL ή scalar params μπορούν να δοκιμαστούν απευθείας

• partial_requires_files: ορισμένες λειτουργίες μπορούν να κληθούν χωρίς ανέβασμα· οι λειτουργίες με μέσα αναφοράς πρέπει να χρησιμοποιούν Files API

• requires_files_api: το μοντέλο εξαρτάται από ανεβασμένα μέσα αναφοράς μέσω /api/v1/files

Χρησιμοποιήστε το Files API πριν καλέσετε λειτουργίες που απαιτούν ανεβασμένες αναφορές εικόνας, βίντεο ή ήχου.

Για μοντέλα chat, το chat_capabilities τεκμηριώνει αν το Chat API υποστηρίζει non-streaming απαντήσεις, streaming απαντήσεις, web search, συνημμένα εικόνας file_id, thoughts και reasoning effort.

Πολιτική πλήθους μοντέλων

Η δημόσια λίστα μοντέλων αλλάζει καθώς το Rivya προσθέτει, αφαιρεί ή περιορίζει μοντέλα.

Μην βασίζεστε σε hard-coded πλήθος μοντέλων στην ενσωμάτωσή σας. Να διαβάζετε πάντα το /api/v1/models ή τη δυναμική Αναφορά API μοντέλων.

Σχετικές σελίδες

• Αναφορά API μοντέλων

• Δημιουργία generation

• Chat API

• Οδηγός επιλογής μοντέλου Rivya

• Διαθεσιμότητα μοντέλων στο Rivya

Καταχωρίσεις «Σύντομα» μόνο για ανάγνωση

• coming_soon: το μοντέλο εμφανίζεται μόνο για ανακάλυψη και δεν υποβάλλεται στο API δημιουργίας ή Chat. Επιστρέφει supports_direct_generation: false, null για runtime, χρέωση και τιμή, καθώς και κενά supported_modes και params. Για αιτήματα επιλέξτε api_status: available.