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

Διαθέσιμο μέσω APIΕτοιμότηταΕικόνα

ID μοντέλου API

ideogram-character

Είσοδοι

file

Files API

Απαιτείται για λειτουργίες αναφοράς

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

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

Δυνατότητα

Εικόνα

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	ideogram-character	Χρησιμοποιήστε το ideogram-character ως αναγνωριστικό μοντέλου 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, REALISTIC, FICTION	Στυλ
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	Μέγεθος εικόνας
num_images	select	Όχι	1	-	1, 2, 3, 4	Επιλέξτε 1–4 εξόδους. Το σύνολο είναι η τιμή ανά εικόνα επί το πλήθος, στρογγυλοποιημένη προς τα πάνω σε ακέραιες πιστώσεις.
seed	number	Όχι	-	-	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.
negative_prompt	text	Όχι	-	-	-	Αρνητική προτροπή

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Εικόνα αναφοράς χαρακτήρα: Ανεβάστε ακριβώς 1 αρχείο εικόνας για αυτό το έργο.

Μέγιστος αριθμός αρχείων

Αποδεκτοί τύποι αρχείων

image

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
image	10 MB	image/jpeg, image/png, image/webp

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

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Προαιρετικό περιεχόμενο που θέλετε να αποφύγετε"
  }
}

Αίτημα με αρχείο αναφοράς

{
  "model": "ideogram-character",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "negative_prompt": "Προαιρετικό περιεχόμενο που θέλετε να αποφύγετε",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_ideogram_character_example",
  "status": "queued",
  "model": "ideogram-character",
  "reserved_credits": 18,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για Ideogram Character