Μετάβαση στο περιεχόμενο

Ideogram V3 Character Edit

Ενσωμάτωση

id μοντέλου ideogram/character/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/character/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Αυτό το αίτημα: 0,15 $ 150 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Ideogram Επεξεργασία εικόνας Είσοδοι αναφοράς #character-consistency

Επεξεργασία με μάσκα του Ideogram V3 που διατηρεί την ταυτότητα χαρακτήρα αναφοράς

Ideogram · Εικόνα

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

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

•απαιτείται

Prompt που περιγράφει το γέμισμα για την καλυμμένη περιοχή της εικόνας.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

Πηγή παραγωγής παρεχόμενη ως URL εικόνας, με πλάτος και ύψος που πρέπει να ισούνται ακριβώς με τις αντίστοιχες διαστάσεις της μάσκας.

•απαιτείται mask_url
Αποθέστε ένα αρχείο ή

Μάσκα inpainting παρεχόμενη μέσω URL, με πλάτος και ύψος που πρέπει να ισούνται ακριβώς με τις αντίστοιχες διαστάσεις της εικόνας εισόδου.

•απαιτείται
Αποθέστε ένα αρχείο ή

Εικόνες αναφοράς χαρακτήρα σε μορφή JPEG, PNG ή WebP, με συνολικό όριο 10 MB για όλες τις αναφορές χαρακτήρα. Προς το παρόν υποστηρίζεται μόνο 1 εικόνα· οι επιπλέον αγνοούνται.

rendering_speed προεπιλογή BALANCED

Ρύθμιση ταχύτητας για rendering.

num_images προεπιλογή 1

Πλήθος εικόνων προς παραγωγή.

Για προχωρημένους images · reference_mask_urls · seed · expand_prompt · style_codes · color_palette
image_urls
Αποθέστε ένα αρχείο ή

Εικόνες αναφοράς στυλ σε μορφή JPEG, PNG ή WebP. Το συνολικό τους μέγεθος δεν πρέπει να υπερβαίνει τα 10 MB.

Αποθέστε ένα αρχείο ή

Μάσκες αναφοράς χαρακτήρα σε μορφή JPEG, PNG ή WebP· το συνολικό μέγεθος δεν μπορεί να υπερβαίνει τα 10 MB. Προς το παρόν χρησιμοποιείται μόνο 1 μάσκα και οι επιπλέον αγνοούνται.

Τιμή seed για παραγωγή τυχαίων αριθμών.

Κωδικοί στυλ εικόνας ως δεκαεξαδικές συμβολοσειρές 8 χαρακτήρων· παραλείψτε τα style_reference_images και style όταν χρησιμοποιείτε αυτή τη λίστα.

Παλέτα χρωμάτων που χρησιμοποιείται κατά την παραγωγή. Καθορίστε είτε preset μέσω name είτε ρητά δεκαεξαδικά χρώματα μέσω members, προαιρετικά με βάρη.

POST /run/ideogram/character/edit?wait=20 προσφορά → 0,15 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/character/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Ideogram V3 Character Edit

Συμπληρώνει μια περιοχή με μάσκα του `image_url` χρησιμοποιώντας `mask_url` (και τα δύο πρέπει να έχουν ίδιες διαστάσεις), ένα `prompt` και μια αναφορά χαρακτήρα στο `reference_image_urls` (χρησιμοποιείται 1 εικόνα). Είναι χρήσιμο για αλλαγή στάσης, έκφρασης ή ρουχισμού. Υποστηρίζει προαιρετικές αναφορές στυλ, `rendering_speed` και έως 8 εξόδους.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlsπροαιρετικό images
Τύποςurl[] · image
Εικόνες αναφοράς στυλ σε μορφή JPEG, PNG ή WebP. Το συνολικό τους μέγεθος δεν πρέπει να υπερβαίνει τα 10 MB.
rendering_speedπροαιρετικό
Τύποςenum
ΠροεπιλογήBALANCED
TURBOBALANCEDQUALITY
Ρύθμιση ταχύτητας για rendering.
color_paletteπροαιρετικό
Τύποςobject
Παλέτα χρωμάτων που χρησιμοποιείται κατά την παραγωγή. Καθορίστε είτε preset μέσω name είτε ρητά δεκαεξαδικά χρώματα μέσω members, προαιρετικά με βάρη.
color_palette.membersπροαιρετικό
Τύποςobject[]
Λίστα μελών παλέτας που ορίζει τα χρώματα της παλέτας.
color_palette.members[].rgbαπαιτείται
Τύποςobject
Χρώμα μέλους παλέτας σε μορφή RGB.
color_palette.members[].color_weightπροαιρετικό
Τύποςnumber | null
Προεπιλογή0.5
0,05 – 1
Βάρος που αντιστοιχίζεται σε αυτό το χρώμα μέσα στην παλέτα.
color_palette.nameπροαιρετικό
Τύποςenum
EMBERFRESHJUNGLEMAGICMELONMOSAICPASTELULTRAMARINE
Επιλογή preset για την παλέτα χρωμάτων.
style_codesπροαιρετικό
Τύποςstring[]
Κωδικοί στυλ εικόνας ως δεκαεξαδικές συμβολοσειρές 8 χαρακτήρων· παραλείψτε τα style_reference_images και style όταν χρησιμοποιείτε αυτή τη λίστα.
expand_promptπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή χρήσης MagicPrompt για την παραγωγή αιτήματος.
num_imagesπροαιρετικό num_outputs
Τύποςinteger
Προεπιλογή1
1 – 8
Πλήθος εικόνων προς παραγωγή.
seedπροαιρετικό
Τύποςinteger | null
Τιμή seed για παραγωγή τυχαίων αριθμών.
promptαπαιτείται
Τύποςstring
Prompt που περιγράφει το γέμισμα για την καλυμμένη περιοχή της εικόνας.
image_urlαπαιτείται image
Τύποςurl · image
Πηγή παραγωγής παρεχόμενη ως URL εικόνας, με πλάτος και ύψος που πρέπει να ισούνται ακριβώς με τις αντίστοιχες διαστάσεις της μάσκας.
mask_urlαπαιτείται mask
Τύποςurl · image
Μάσκα inpainting παρεχόμενη μέσω URL, με πλάτος και ύψος που πρέπει να ισούνται ακριβώς με τις αντίστοιχες διαστάσεις της εικόνας εισόδου.
reference_image_urlsαπαιτείται
Τύποςurl[] · image
Εικόνες αναφοράς χαρακτήρα σε μορφή JPEG, PNG ή WebP, με συνολικό όριο 10 MB για όλες τις αναφορές χαρακτήρα. Προς το παρόν υποστηρίζεται μόνο 1 εικόνα· οι επιπλέον αγνοούνται.
reference_mask_urlsπροαιρετικό
Τύποςurl[] · image
Μάσκες αναφοράς χαρακτήρα σε μορφή JPEG, PNG ή WebP· το συνολικό μέγεθος δεν μπορεί να υπερβαίνει τα 10 MB. Προς το παρόν χρησιμοποιείται μόνο 1 μάσκα και οι επιπλέον αγνοούνται.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/character/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mask_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
images
array of object {url, content_type, file_name, file_size}
seed
integerΤιμή seed που χρησιμοποιείται για παραγωγή τυχαίων αριθμών.

Περισσότερα μοντέλα: Επεξεργασία εικόνας

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/ideogram/character/edit.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt