Χρησιμοποιήστε το Ideogram V3 μέσω Rivya Public API v1 με model id ideogram-v3, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText input έτοιμοΕικόνα

ID μοντέλου API

ideogram-v3

Inputs

text

Files API

Δεν απαιτείται για το minimal request

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

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	ideogram-v3	Χρησιμοποιήστε το ideogram-v3 ως API model id.
prompt	string	Ναι	-	Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

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

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
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	-	Αφήστε το κενό για ένα νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση ενός προηγούμενου αποτελέσματος. Παραμένει πιο κοντά μόνο όταν το prompt και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες και δεν εγγυάται αντιστοίχιση 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": "Προαιρετικά στοιχεία που θέλετε να αποφύγετε"
  }
}

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

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

{
  "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