Τεκμηρίωση Rivya AI
Σελίδες API μοντέλων

Ενσωμάτωση API για 4o Image

Χρησιμοποιήστε το 4o Image μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου 4o-image, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΕίσοδος κειμένου έτοιμηΕικόνα
ID μοντέλου API

4o-image

Είσοδοι

text

Files API

Δεν απαιτείται για το ελάχιστο αίτημα

Βασικές πιστώσεις

3

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

Δεν υπάρχει τεκμηριωμένο όριο prompt

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαι4o-imageΧρησιμοποιήστε το 4o-image ως αναγνωριστικό μοντέλου API.
promptstringΝαι-Κείμενο προτροπής για μοντέλα που υποστηρίζουν είσοδο κειμένου.
paramsobjectΌχι-Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_idstringΌχι-Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
sizeselectΌχι1:1-1:1, 3:2, 2:3Αναλογία διαστάσεων

Ελάχιστο αίτημα

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.