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

Ideogram Text to Image

Ενσωμάτωση

id μοντέλου ideogram/v3
# 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/v3?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"
  }'

# 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,06 $ 60 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Ideogram · Εικόνα

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

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

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

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

•απαιτείται
rendering_speed προεπιλογή BALANCED

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

image_size προεπιλογή square_hd

Ανάλυση που θα χρησιμοποιηθεί για την εικόνα εξόδου.

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

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

Για προχωρημένους negative_prompt · images · style · style_preset · seed · expand_prompt · style_codes · color_palette
προεπιλογή

Καθορίστε ανεπιθύμητο περιεχόμενο εικόνας· οι περιγραφές του κύριου prompt έχουν προτεραιότητα έναντι αυτών του negative prompt.

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

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

style

Τύπος στυλ που χρησιμοποιείται για την παραγωγή· αμοιβαία αποκλειόμενος με το style_codes.

Προκαθορισμένο στυλ του οποίου η επιλογή καθοδηγεί την παραγωγή εικόνας.

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

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

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

POST /run/ideogram/v3?wait=20 προσφορά → 0,06 $
# 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/v3?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"
  }'

# 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 Text to Image

Δημιουργεί εικόνες από ένα `prompt` με ταχύτητες απόδοσης TURBO, BALANCED ή QUALITY. Καθοδηγήστε την εμφάνιση μέσω εικόνων αναφοράς στυλ (`image_urls`), `style_codes`, `color_palette`, `style` ή μίας από 62 τιμές `style_preset`. Υποστηρίζει έως 8 εικόνες ανά κλήση, αρνητικό prompt, προαιρετική επέκταση prompt και προκαθορισμένα μεγέθη.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
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 όταν χρησιμοποιείτε αυτή τη λίστα.
styleπροαιρετικό
Τύποςenum
AUTOGENERALREALISTICDESIGN
Τύπος στυλ που χρησιμοποιείται για την παραγωγή· αμοιβαία αποκλειόμενος με το style_codes.
expand_promptπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή χρήσης MagicPrompt για την παραγωγή αιτήματος.
num_imagesπροαιρετικό num_outputs
Τύποςinteger
Προεπιλογή1
1 – 8
Πλήθος εικόνων προς παραγωγή.
seedπροαιρετικό
Τύποςinteger | null
Τιμή seed για παραγωγή τυχαίων αριθμών.
style_presetπροαιρετικό
Τύποςenum
80S_ILLUSTRATION90S_NOSTALGIAABSTRACT_ORGANICANALOG_NOSTALGIAART_BRUTART_DECOART_POSTERAURAAVANT_GARDEBAUHAUSBLUEPRINTBLURRY_MOTIONBRIGHT_ARTC4D_CARTOONCHILDRENS_BOOKCOLLAGE
+46 ακόμηCOLORING_BOOK_ICOLORING_BOOK_IICUBISMDARK_AURADOODLEDOUBLE_EXPOSUREDRAMATIC_CINEMAEDITORIALEMOTIONAL_MINIMALETHEREAL_PARTYEXPIRED_FILMFLAT_ARTFLAT_VECTORFOREST_REVERIEGEO_MINIMALISTGLASS_PRISMGOLDEN_HOURGRAFFITI_IGRAFFITI_IIHALFTONE_PRINTHIGH_CONTRASTHIPPIE_ERAICONICJAPANDI_FUSIONJAZZYLONG_EXPOSUREMAGAZINE_EDITORIALMINIMAL_ILLUSTRATIONMIXED_MEDIAMONOCHROMENIGHTLIFEOIL_PAINTINGOLD_CARTOONSPAINT_GESTUREPOP_ARTRETRO_ETCHINGRIVIERA_POPSPOTLIGHT_80SSTYLIZED_REDSURREAL_COLLAGETRAVEL_POSTERVINTAGE_GEOVINTAGE_POSTERWATERCOLORWEIRDWOODBLOCK_PRINT
Προκαθορισμένο στυλ του οποίου η επιλογή καθοδηγεί την παραγωγή εικόνας.
promptαπαιτείται
Τύποςstring
image_sizeπροαιρετικό
Τύποςobject
Προεπιλογήsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Ανάλυση που θα χρησιμοποιηθεί για την εικόνα εξόδου.
negative_promptπροαιρετικό
Τύποςstring
Προεπιλογή
Καθορίστε ανεπιθύμητο περιεχόμενο εικόνας· οι περιγραφές του κύριου prompt έχουν προτεραιότητα έναντι αυτών του negative prompt.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

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

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ideogram/v3",
  "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": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/v3.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt