Recraft: Recraft V4.1

Το Recraft V4.1 δημιουργεί εικόνες raster 1K με φυσικό φωτορεαλισμό, εκφραστική εικονογράφηση και σκόπιμη σύνθεση. Μπορεί να αναπτύσσει σύντομη δημιουργική κατεύθυνση ή να ακολουθεί λεπτομερή περιγραφή, με προαιρετικές εισόδους εικόνας και προσαρμοσμένου ύφους.

Ailoot Ultra · Εικόνες POST /v1/images/generations recraft/recraft-v4.1

Σχετικά με το μοντέλο

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

Το Recraft V4.1 είναι το κύριο μοντέλο raster στην οικογένεια V4.1 της Recraft. Είναι φτιαγμένο για εκφραστική δημιουργία εικόνας, όπως φωτογραφίες με φυσική όψη, εικονογράφηση και οπτικές ιδέες με όγκο. Ο κατασκευαστής το παρουσιάζει ως μοντέλο που μπορεί να παρέχει αισθητικές αποφάσεις από σύντομη προτροπή, ανταποκρινόμενο επίσης σε πιο λεπτομερή δημιουργική κατεύθυνση. Χρησιμοποιήστε το για εξερεύνηση, ανάπτυξη ιδεών και εικόνες όπου διάθεση, φωτισμός και σύνθεση αποτελούν μέρος αποτελέσματος αντί να περιορίζονται σε απλή μετωπική λήψη προϊόντος.

Ο συγκεκριμένος κωδικός παραγωγού είναι recraftv4_1. Επιστρέφει εικόνες raster 1K σε WebP χωρίς απώλειες ή PNG, με τετράγωνη έξοδο 1024 × 1024 pixel και 16:9 στα 1344 × 768. Άλλες υποστηριζόμενες αναλογίες χρησιμοποιούν δικές τους διαστάσεις. Το V4.1 Pro είναι χωριστή έκδοση raster 2K, το Vector επιστρέφει επεξεργάσιμο SVG και το Utility προτιμά απλούστερο φωτισμό και σκηνές. Αυτοί οι κλάδοι υπηρετούν διαφορετικά παραδοτέα και δεν πρέπει να συγχωνεύονται σε ένα σύνολο ιδιοτήτων εξόδου.

Ο κατασκευαστής τονίζει φυσικότερες φωτογραφικές σκηνές, πιο ήσυχο φόντο, ομαλότερες διαβαθμίσεις και ευρύ φάσμα εικονογράφησης. Τα παραδείγματα περιλαμβάνουν εκφραστικά γράμματα, επίπεδη εικονογράφηση χαρακτήρα και σχεδιασμένο φύλλο αναφοράς χαρακτήρα. Μια σύντομη προτροπή μπορεί να αφήνει χώρο στην ερμηνεία μοντέλου· μια λεπτομερής περιγραφή μπορεί να καθορίζει θέμα, στάση, υλικό, φόντο και σύνθεση. Για οπτικό με όγκο, ορίστε απόδοση επιφάνειας και φωτισμού, έχοντας υπόψη ότι το αποτέλεσμα είναι εικόνα και όχι πλέγμα ή επεξεργάσιμο έργο 3D.

Για ιδέα χώρου ανάγνωσης, ζητήστε οικεία φωτογραφία μικρής γωνιάς ανάγνωσης, ζεστό φως ημέρας, βιβλία και ένα κεραμικό αντικείμενο, με χαλαρή διάταξη αντί για εικόνα εκθεσιακού χώρου. Μια ελεγχόμενη περιγραφή εικονογράφησης θα μπορούσε αντίθετα να ονομάζει το γραφικό θέμα, τις χρωματικές σχέσεις και την απόδοση γραμμής. Δηλώστε την επιθυμητή αναλογία και τις σημαντικότερες οπτικές αποφάσεις. Έτσι είναι ευκολότερο να κριθεί αν μια απρόσμενη λεπτομέρεια είναι χρήσιμη δημιουργική ερμηνεία ή κάτι που πρέπει να αλλάξει στην επόμενη περιγραφή.

Η αναφορά δημιουργίας επιτρέπει προτροπές έως 10,000 χαρακτήρες, τυχαίο seed, προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου, με από μία έως έξι εξόδους. Προαιρετικές εικόνες αναφοράς ή συμβατά αποθηκευμένα ύφη μπορούν να καθορίζουν οπτική γλώσσα με ευέλικτη ή ακριβή αντιστοίχιση. Δεν απαιτούνται για την κύρια έκδοση V4.1. Επιλέξτε καθαρές αναφορές που συμφωνούν μεταξύ τους και χρησιμοποιήστε την προτροπή για το νέο περιεχόμενο· δεν είναι εγγυημένη η αναπαραγωγή των χρωμάτων της αναφοράς. Για δημιουργία με αναφορές ύφους, χρησιμοποιήστε μία έως δέκα εικόνες PNG, JPG ή WebP, έως 64 MB συνολικά και κάτω από 20 MB καθεμία. Κάθε αναφορά χρειάζεται μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη πλευρά έως 4,096 pixel και ανάλυση έως 16 megapixel. Χρησιμοποιήστε είτε αυτές τις αναφορές είτε ένα συμβατό αποθηκευμένο ύφος, χωρίς να τα συνδυάζετε στο ίδιο αίτημα.

Το V4.1 υποστηρίζει επίσης χωριστή ροή εικόνας προς εικόνα με υπάρχουσα εικόνα, κείμενο και ισχύ από 0 έως 1. Η λειτουργία χρησιμοποιεί την ισχύ για να ελέγχει πόσο κοντά μένει η νέα εικόνα στην πηγή και δεν δέχεται ελέγχους προσαρμοσμένου ύφους V4.1. Η τρέχουσα αναφορά δημιουργίας μοντέλου αποκλείει negative_prompt, επιμελημένα ύφη, text_layout, artistic_level και no_text. Περιγράψτε απευθείας την επιθυμητή σκηνή και εξετάστε το οπτικό που προκύπτει στη διάταξη στόχου, μαζί με λεπτομέρειες, περικοπή και κάθε γράμμα, πριν επιλέξετε ποια οπτική κατεύθυνση θα κρατήσετε. Για εικόνα προς εικόνα, δώστε PNG, JPG, WebP ή SVG κάτω από 20 MB, έως 16 megapixel, με αμφότερες τις πλευρές από 256 έως 4,096 pixel.

Ailoot Ultra · Εικόνες POST /v1/images/generations recraft/recraft-v4.1

recraft/recraft-v4.1

Recraft /recraft/recraft-v4.1

Εισαγωγή

Αποδεκτές είσοδοι: Κείμενο · Εικόνες
Αποτελέσματα: Εικόνες

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Εικόνες POST /v1/images/generations

Είσοδος: text, image
Έξοδος: image

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια recraft/recraft-v4.1	Προεπιλογή—
Πεδίο`prompt`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Ελάχιστο μήκος: 1	Προεπιλογή—
Πεδίο`aspect_ratio`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια 1:1, 4:3, 3:4, 16:9, 9:16, auto	Προεπιλογή—
Πεδίο`n`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 6	Προεπιλογή—
Πεδίο`input_references`	Τύπος`array`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 0 Μέγιστο πλήθος στοιχείων: 1	Προεπιλογή—
Πεδίο`provider`	Τύπος`object`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια	Προεπιλογή—

Παράμετροι και κύκλος ζωής μεθόδου

Παράμετρος	Σύμβαση
Παράμετρος`content_type`	Σύμβασηapplication/json
Παράμετρος`required`	Σύμβασηmodel, prompt
Παράμετρος`material_types`	Σύμβασηtext, image

Κύκλος ζωής: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Το πραγματικό task_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Τιμολόγηση

Πώς υπολογίζεται η τελική χρέωση

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

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

Γρήγορη λειτουργία: Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
Λειτουργία flex: Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
Μέγιστη προσπάθεια συλλογισμού: Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default

Εκτιμώμενες χρεώσεις για σύγκριση

Τιμές ανά διαμόρφωση

Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.

Διαμόρφωση	Πίνακας χρεώσεων	Προβλεπόμενη ποσότητα	Μονάδα τιμολόγησης	Χρέωση
ΔιαμόρφωσηΒασικές χρεώσεις token	Πίνακας χρεώσεωνΒασική χρέωση	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησης—	Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token
Διαμόρφωσηεικόνα εξόδου	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά εικόνα εξόδου	Χρέωση Έξοδος · εικόνα εξόδου · Εκτίμηση μόνο για σύγκριση $0.07 ανά εικόνα εξόδου
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.07 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Παραδείγματα αιτημάτων

Ailoot Ultra · Εικόνες

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'recraft/recraft-v4.1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Λήψη και αποθήκευση αποτελεσμάτων

Ailoot Ultra · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Άλλες ανακτήσεις περιεχομένου

Ανάκτηση υπαρχόντων αρχείων που σας ανήκουν

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.

Αν χρειάζεται έλεγχος της αρχικής απάντησης

Διατηρήστε το X-Client-Request-ID που επιστράφηκε για τη συμφωνία των εγγραφών. Διαβάστε μόνο πραγματικές τιμές task_id/asset_id που επιστράφηκαν ή τη βιβλιοθήκη πολυμέσων που σας ανήκει· μην κατασκευάσετε ποτέ URL εργασίας από το ID της λειτουργίας και μην υποβάλετε ποτέ ξανά αίτημα δημιουργίας.

Πεδία απάντησης

Πεδίο	Τύπος
Πεδίο`created`	Τύπος
Πεδίο`data[].url`	Τύπος
Πεδίο`data[].b64_json`	Τύπος
Πεδίο`usage`	Τύπος

Εναλλακτικά ονόματα

Εναλλακτικά ονόματα μοντέλου

Ailoot Ultra recraft/recraft-v4.1

Εναλλακτικές διαδρομές μεθόδων

/v1/images

Σχετικά ID μοντέλων

recraft/recraft-v4.1

FAQ · Recraft: Recraft V4.1

Ποιες είσοδοι και αποτελέσματα διατίθενται;: POST /v1/images/generations · recraft/recraft-v4.1: text, image → image
Ποια πεδία χρησιμοποιεί το αίτημα;: POST /v1/images/generations · recraft/recraft-v4.1: model, prompt, aspect_ratio, n, input_references, provider
Ποια όρια ισχύουν;: POST /v1/images/generations · recraft/recraft-v4.1: n.minimum: 1; n.maximum: 6

Recraft: Recraft V4.1