Recraft: Recraft V4 Styles Pro
Το Recraft V4 Styles Pro δημιουργεί εικόνες raster 2K σε οπτικό ύφος καθορισμένο από αναφορές. Έχει σχεδιαστεί για λεπτομερή οπτικά καμπανιών και σύνολα εικόνων των οποίων η υφή, η απόδοση, η παλέτα και η συνολική εμφάνιση πρέπει να παραμένουν συνεπείς καθώς αλλάζει το θέμα.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Recraft V4 Styles Pro είναι το μοντέλο raster υψηλότερης ανάλυσης στην ειδική οικογένεια V4 Styles της Recraft. Δημιουργεί νέα εικόνα από περιγραφή κειμένου και οπτικό ύφος παρεχόμενο μέσω εικόνων αναφοράς ή αποθηκευμένου ύφους. Το μοντέλο προορίζεται για καμπάνιες, εικονογράφηση επωνυμίας και άλλα σύνολα εικόνων όπου απόδοση, υφή και συνθετικός χαρακτήρας πρέπει να μεταφέρονται από οπτικό σε οπτικό. Είναι χωριστό από τα Recraft V4 Pro και V4.1 Pro, των οποίων η είσοδος ύφους είναι προαιρετική αντί για καθοριστική απαίτηση μοντέλου.
Το Styles Pro παράγει έξοδο raster 2K, σε WebP χωρίς απώλειες ή PNG. Η τετράγωνη έξοδος στον πίνακα μεγεθών παραγωγού είναι 2048 × 2048 pixel, ενώ η έξοδος 16:9 είναι 2688 × 1536· άλλες υποστηριζόμενες αναλογίες έχουν δικές τους διαστάσεις. Η μεγαλύτερη έξοδος Pro μπορεί να είναι χρήσιμη για λεπτομερή οπτικά καμπανιών και μεγαλύτερες διατάξεις. Οι διανυσματικές παραλλαγές παράγουν αντίθετα SVG χωρίς σταθερό μέγεθος pixel, επομένως αυτή η έκδοση raster Pro δεν πρέπει να επιλέγεται όταν το επιθυμητό παραδοτέο είναι επεξεργάσιμο διανυσματικό αρχείο.
Κάθε δημιουργία στην οικογένεια Styles απαιτεί ύφος. Δώστε μία έως δέκα εικόνες αναφοράς PNG, JPG ή WebP ή επαναχρησιμοποιήστε συμβατό αποθηκευμένο ύφος· αναγνωριστικό ύφους και νέες αναφορές είναι εναλλακτικές είσοδοι, όχι ζεύγος προς συνδυασμό. Η ροή παραγωγού επιτρέπει έως 64 MB συνολικά στις αναφορές, με κάθε αρχείο κάτω από 20 MB. Η δημιουργία ύφους δεν απαιτεί βήμα εκπαίδευσης που εκτελεί ο χρήστης. Μία καθαρή αναφορά μπορεί να θεμελιώσει συνεκτική κατεύθυνση και αρκετές βοηθούν όταν ήδη μοιράζονται την ίδια οπτική γλώσσα αντί για ανταγωνιστικές εμφανίσεις. Κάθε αναφορά πρέπει να έχει μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη πλευρά έως 4,096 pixel και συνολική ανάλυση έως 16 megapixel.
Η ευέλικτη αντιστοίχιση ύφους είναι προεπιλογή και επιτρέπει χαλαρότερη ερμηνεία αναφοράς. Η ακριβής αντιστοίχιση ακολουθεί πιο στενά απόδοση, παλέτα, σύνθεση και φωτισμό. Η αναφορά ορίζει την οπτική γλώσσα· η περιγραφή κειμένου πρέπει και πάλι να περιγράφει νέο θέμα, δράση, σκηνή και κάδρο. Για λεπτομερή καμπάνια προϊόντος, προσδιορίστε γυάλινο μπουκάλι σε ανοιχτόχρωμη πέτρινη επιφάνεια, λήψη τριών τετάρτων, απαλό πλευρικό φωτισμό και καθαρό χώρο για τίτλο, ενώ η παρεχόμενη αναφορά μεταφέρει τη φωτογραφική απόδοση.
Το μοντέλο δέχεται προτροπές έως 10,000 χαρακτήρες, υποστηρίζει προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου και μπορεί να χρησιμοποιεί τυχαίο seed. Η τεκμηριωμένη ροή δημιουργίας μπορεί να επιστρέφει από μία έως έξι εικόνες. Οι χρήσιμοι έλεγχοι διαφέρουν από παλαιότερες εκδόσεις Recraft: επιμελημένα ονόματα ύφους, negative_prompt και text_layout δεν υποστηρίζονται και η οικογένεια Styles δεν παρέχει εικόνα προς εικόνα ή inpainting. Μια αναφορά είναι πηγή ύφους, όχι μάσκα ή οδηγία διατήρησης υπάρχουσας φωτογραφίας pixel προς pixel.
Προετοιμάστε καθαρά οπτικά αρχεία αναφοράς με επαρκή λεπτομέρεια και επαναχρησιμοποιήστε το ίδιο ύφος όταν αναπτύσσετε σύνολο. Αν οι έξοδοι γίνουν επαναληπτικές, αλλάξτε θέμα, στάση, γωνία κάμερας ή σκηνή στην περιγραφή κειμένου, αντί να προσθέτετε άσχετη αναφορά. Δεν είναι εγγυημένη η ακριβής χρωματική αντιστοίχιση αναφοράς και εξόδου· οι έλεγχοι προτιμώμενων χρωμάτων εκφράζουν κατεύθυνση αντί για αποτέλεσμα χρωματικού δοκιμίου. Για τελικό οπτικό καμπάνιας, αξιολογήστε την εικόνα στο επιθυμητό μέγεθος προβολής ή εκτύπωσης και ελέγξτε αν θέμα, χρήσιμος κενός χώρος και οπτική απόδοση ταιριάζουν στην περιγραφή.
Ailoot Ultra · Εικόνες POST /v1/images/generations recraft/recraft-v4-styles-pro
recraft/recraft-v4-styles-proΕισαγωγή
Το Recraft V4 Styles Pro δημιουργεί εικόνες raster 2K σε οπτικό ύφος καθορισμένο από αναφορές. Έχει σχεδιαστεί για λεπτομερή οπτικά καμπανιών και σύνολα εικόνων των οποίων η υφή, η απόδοση, η παλέτα και η συνολική εμφάνιση πρέπει να παραμένουν συνεπείς καθώς αλλάζει το θέμα.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Εικόνες POST /v1/images/generations
- Είσοδος
text,image- Έξοδος
image
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια recraft/recraft-v4-styles-pro | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 6 | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 Μέγιστο πλήθος στοιχείων: 10 | Προεπιλογή— |
Πεδίο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.01 ανά αίτημα |
| Διαμόρφωσηεικόνα εξόδου | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά εικόνα εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · εικόνα εξόδου · Εκτίμηση μόνο για σύγκριση $0.2 ανά εικόνα εξόδου |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Εικόνες
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-styles-pro', '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}/contentGET /v1/media/assetsGET /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-styles-pro
Εναλλακτικές διαδρομές μεθόδων
/v1/images
Σχετικά ID μοντέλων
FAQ · Recraft: Recraft V4 Styles Pro
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·recraft/recraft-v4-styles-pro:text,image→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·recraft/recraft-v4-styles-pro:model,prompt,aspect_ratio,n,input_references,provider- Ποια όρια ισχύουν;
POST /v1/images/generations·recraft/recraft-v4-styles-pro:n.minimum:1;n.maximum:6