μοντέλα

Recraft: Recraft V4.1 Utility

Markdown · JSON

Recraft: Recraft V4.1 Utility

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

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

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

Το Recraft V4.1 Utility είναι το βασικό μοντέλο raster Utility στην οικογένεια V4.1 της Recraft. Προτιμά απλές σκηνές, ομοιόμορφο φωτισμό και μετωπική σύνθεση, αντί για τις πιο εκφραστικές επιλογές γωνίας, φωτός και διάθεσης του κύριου μοντέλου V4.1. Ο πρακτικός ρόλος του είναι καθαρή λήψη προϊόντος ή μακέτα όπου πρέπει να κυριαρχούν το αντικείμενο και οι αναγκαίες λεπτομέρειες. Η συγκεκριμένη έκδοση Utility είναι χωριστή από το Utility Pro, το κύριο μοντέλο V4.1 και τις διανυσματικές παραλλαγές που παράγουν SVG.

Ο κωδικός μοντέλου παραγωγού είναι recraftv4_1_utility. Επιστρέφει εικόνες raster 1K σε WebP χωρίς απώλειες ή PNG, με μεγέθη από τις υποστηριζόμενες αναλογίες. Μια τετράγωνη εικόνα είναι 1024 × 1024 pixel και μια εικόνα 4:3 είναι 1216 × 896. Η έκδοση Pro Utility χρησιμοποιεί μεγαλύτερες διαστάσεις 2K, επομένως αυτά τα μεγέθη εξόδου δεν πρέπει να αποδίδονται στο βασικό Utility. Επιλέξτε το σχήμα της επιθυμητής καταχώρισης ή μακέτας πριν περιγράψετε τη σκηνή.

Μια χρήσιμη περιγραφή ονομάζει απλά προϊόν, οπτική γωνία, υλικό, επιφάνεια, φόντο και φωτισμό. Για καταχώριση προϊόντος, ζητήστε μετωπική λήψη μονωμένου μπουκαλιού σε ανοιχτόχρωμο φόντο, ομοιόμορφα φωτισμένου, με ορατή ολόκληρη τη σιλουέτα και χωρίς στοιχεία σκηνής που αποσπούν την προσοχή. Αν ένα προϊόν έχει πραγματικές διαστάσεις ή ιδιαίτερα μέρη, δώστε αυτές τις λεπτομέρειες ρητά. Η προτίμηση του Utility για απλή παρουσίαση δεν θεμελιώνει στοιχεία πραγματικού προϊόντος που έλειπαν από την περιγραφή.

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

Η χωριστή ροή εικόνας προς εικόνα χρησιμοποιεί υπάρχουσα εικόνα και προτροπή, με ισχύ από 0 έως 1 που ελέγχει την έκταση αλλαγής. Χαμηλότερη ισχύς κρατά το αποτέλεσμα πιο κοντά στην πηγή· υψηλότερη το αφήνει να απομακρυνθεί περισσότερο. Η είσοδος μπορεί να είναι PNG, JPG, WebP ή SVG κάτω από 20 MB, έως 16 MP, με πλευρές από 256 έως 4096 pixel. Τα προσαρμοσμένα ύφη V4.1 δεν γίνονται δεκτά σε αυτή τη λειτουργία μετασχηματισμού, που διαφέρει από την προσθήκη αναφοράς ύφους σε νέα δημιουργία.

Το V4.1 Utility δεν δέχεται επιμελημένα ονόματα ύφους ούτε ελέγχους negative_prompt, text_layout, artistic_level ή no_text. Δώστε απευθείας την επιθυμητή ολοκληρωμένη σκηνή στη θετική προτροπή. Για σειρά οπτικών προϊόντων, κρατήστε σταθερές τις οδηγίες κάδρου και φόντου και συγκρίνετε κατόπιν κάθε εικόνα με το παρεχόμενο σχήμα, υλικό και λεπτομέρειες προϊόντος πριν τη χρησιμοποιήσετε σε διάταξη. Το βασικό Utility είναι εστιασμένο εργαλείο raster για συγκρατημένη παρουσίαση· επιλέξτε τη συγκεκριμένη μορφή εξόδου και έκδοση που ταιριάζει στην εργασία.

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

recraft/recraft-v4.1-utility

Recraft /recraft/recraft-v4.1-utility

Εισαγωγή

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

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

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

Ailoot Ultra · Εικόνες POST /v1/images/generations
Είσοδος
text, image
Έξοδος
image
ΠεδίοΤύποςΑπαίτησηΤιμές και όριαΠροεπιλογή
ΠεδίοmodelΤύποςstringΑπαίτησηΥποχρεωτικόΤιμές και όρια
recraft/recraft-v4.1-utility
Προεπιλογή—
Πεδίο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-utility', '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-utility

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

/v1/images

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

recraft/recraft-v4.1-utility

FAQ · Recraft: Recraft V4.1 Utility
Ποιες είσοδοι και αποτελέσματα διατίθενται;

POST /v1/images/generations · recraft/recraft-v4.1-utility: text, image → image

Ποια πεδία χρησιμοποιεί το αίτημα;

POST /v1/images/generations · recraft/recraft-v4.1-utility: model, prompt, aspect_ratio, n, input_references, provider

Ποια όρια ισχύουν;

POST /v1/images/generations · recraft/recraft-v4.1-utility: n.minimum: 1; n.maximum: 6

Περισσότερες λεπτομέρειες

Συνδέστε το Ailoot με Claude Code, OpenCode, Hermes ή τη δική σας εφαρμογή.

Η εταιρεία και το χαρτοφυλάκιο έργων της

Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.

Αγοράστε token με έκπτωση.

Έκπτωση συνδρομής για τακτική χρήση. Προωθητικοί κωδικοί — έως 50% στην αγορά token.

Συνδρομή
Επιλέξτε πρόγραμμα με έκπτωση για τα τακτικά αιτήματά σας.
Προωθητικός κωδικός έως 50%
Εισαγάγετε τον κωδικό στην αγορά. Η τιμή επανυπολογίζεται σύμφωνα με την ενεργή προσφορά.
Δαπάνες στο ιστορικό
Μοντέλο, token και ποσό αποθηκεύονται για κάθε αίτημα.

Επιλέξτε συνδρομή · Δείτε τιμές μοντέλων

Συνδέστε το API με το προϊόν που πουλάτε.

SaaS, εφαρμογές και bot — σύμφωνα με τη δημόσια προσφορά και τη σύμβαση άδειας χρήσης Ailoot. Για μεταπώληση ζητήστε σχετική άδεια.

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

Ζητήστε άδεια μεταπώλησης · Δημόσια προσφορά και σύμβαση άδειας χρήσης