Ενσωμάτωση API για Ideogram V3
Χρησιμοποιήστε το Ideogram V3 μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου ideogram-v3, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.
ideogram-v3
text
Δεν απαιτείται για το ελάχιστο αίτημα
7
Εικόνα
FIXED
5000 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | ideogram-v3 | Χρησιμοποιήστε το ideogram-v3 ως αναγνωριστικό μοντέλου API. |
| prompt | string | Ναι | - | Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| rendering_speed | select | Όχι | BALANCED | - | TURBO, BALANCED, QUALITY | Ισορροπεί ταχύτητα, κόστος και λεπτομέρεια. Το Turbo είναι το πιο γρήγορο και πιο φθηνό, το Quality είναι το πιο λεπτομερές και το πιο ακριβό, και το Balanced είναι το προεπιλεγμένο ενδιάμεσο. |
| style | select | Όχι | AUTO | - | AUTO, GENERAL, REALISTIC, DESIGN | Στυλ |
| expand_prompt | select | Όχι | true | - | true, false | Ο διακόπτης επέκτασης προτροπής του Ideogram. Η ενεργοποίησή του βοηθά το μοντέλο να εμπλουτίσει την περιγραφή σας· η απενεργοποίησή του είναι καλύτερη όταν θέλετε αυστηρό έλεγχο της προτροπής. |
| image_size | select | Όχι | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 | Μέγεθος εικόνας |
| seed | number | Όχι | - | min 0 | - | Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1. |
| negative_prompt | text | Όχι | - | - | - | Αρνητική προτροπή |
Ελάχιστο αίτημα
{
"model": "ideogram-v3",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"rendering_speed": "BALANCED",
"style": "AUTO",
"expand_prompt": "true",
"image_size": "square_hd",
"seed": 0,
"negative_prompt": "Προαιρετικά στοιχεία που θέλετε να αποφύγετε"
}
}Απόκριση δημιουργίας
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.
{
"id": "task_ideogram_v3_example",
"status": "queued",
"model": "ideogram-v3",
"reserved_credits": 7,
"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
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.