Recraft: Recraft V4 Styles Vector
Το Recraft V4 Styles Vector δημιουργεί επεξεργάσιμα γραφικά SVG από κειμενικές οδηγίες και υποχρεωτικό οπτικό ύφος. Ταιριάζει σε συντονισμένα εικονίδια, λογότυπα και εικονογραφήσεις με γραμμές, παλέτα και απόδοση που ακολουθούν κοινή κατεύθυνση αναφοράς.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Recraft V4 Styles Vector είναι το μοντέλο παραγωγής SVG στην ειδική σειρά δημιουργίας συνεπούς ύφους του Recraft. Μετατρέπει κειμενικές οδηγίες σε νέα διανυσματικά έργα, χρησιμοποιώντας δοσμένη αναφορά ύφους για καθοδήγηση απόδοσης, χρωματικής λογικής και συνολικής εμφάνισης. Χρησιμεύει σε συντονισμένα σύνολα εικονιδίων, εικονογράφηση επωνυμίας και γραφικά συστήματα όπου τα θέματα αλλάζουν αλλά η οπτική απόδοση πρέπει να παραμένει αναγνωρίσιμη. Η έκδοση Vector επιστρέφει επεξεργάσιμο γραφικό αντί για ψηφιδωτή φωτογραφία.
Ο παραγωγός προσδιορίζει την έκδοση ως recraftv4_styles_vector. Η έξοδός της είναι πάντα SVG· οι ψηφιδωτές ρυθμίσεις image_format δεν τη μετατρέπουν σε WebP ή PNG. Κάθε διανυσματική παραλλαγή δέχεται τις δεκατέσσερις τεκμηριωμένες αναλογίες πλάτους προς ύψος αντί για ακριβή μεγέθη pixel. Το SVG δεν έχει σταθερή ανάλυση pixel, επομένως η έξοδος 1K του τυπικού ψηφιδωτού μοντέλου δεν είναι αρχιτεκτονικό μέγεθος αυτής της έκδοσης. Επιλέξτε επιθυμητό σχήμα και μικρή ή μεγάλη χρήση προβολής όταν ετοιμάζετε τις οδηγίες.
Κάθε δημιουργία απαιτεί ύφος. Χρησιμοποιήστε μία έως δέκα αναφορές PNG, JPG ή WebP ή συμβατό αποθηκευμένο ύφος αντί νέων αναφορών. Ο παραγωγός απορρίπτει αίτημα που συνδυάζει αναγνωριστικό αποθηκευμένου ύφους με εικόνες αναφοράς ύφους. Το τεκμηριωμένο όριο αναφορών είναι 64 MB συνολικά και κάτω από 20 MB ανά αρχείο. Ένα καθαρό εικονίδιο ή εικονογράφηση μπορεί να καθορίσει την απόδοση· πολλές αναφορές βοηθούν όταν πάχος γραμμής, γωνίες, λογική γεμισμάτων και παλέτα ανήκουν ήδη στο ίδιο οπτικό σύστημα. Κάθε αναφορά πρέπει να έχει μικρότερη πλευρά τουλάχιστον 256 pixel, μεγαλύτερη έως 4,096 pixel και συνολική ανάλυση έως 16 megapixel.
Το flexible matching είναι προεπιλογή και διαβάζει πιο ελεύθερα την αναφορά, ενώ το precise matching ακολουθεί στενότερα απόδοση, χρώμα, σύνθεση και φωτισμό. Για διανυσματικό σύστημα, ορίστε στο prompt τύπο γραφικού, περίγραμμα, πλήθος αντικειμένων και διάταξη. Για σύνολο εικονιδίων πλοήγησης, χρησιμοποιήστε έντονα στρογγυλεμένα περιγράμματα, ένα κεντραρισμένο αντικείμενο ανά εικόνα και παλέτα δύο χρωμάτων. Κρατήστε το ίδιο ύφος αναφοράς και αλλάξτε το ονομασμένο αντικείμενο σε κάθε οδηγία, αντί να αναμειγνύετε άσχετες αναφορές για ποικιλία.
Η αναφορά δημιουργίας επιτρέπει προτροπές έως 10,000 χαρακτήρων, μία έως έξι εξόδους, τυχαίο seed, προτιμώμενα χρώματα και επιθυμητό χρώμα φόντου. Αρνητικές προτροπές, επιμελημένα ονόματα ύφους και η παλαιότερη ρύθμιση text_layout δεν υποστηρίζονται. Αυτή η έκδοση Styles επίσης δεν παρέχει εικόνα προς εικόνα ή inpainting: η εικόνα αναφοράς δίνει οπτική γλώσσα, όχι περιοχή προς διαγραφή ή υπάρχον γραφικό προς αμετάβλητη διατήρηση. Οι δομικές οδηγίες στη θετική προτροπή πρέπει να περιγράφουν το επιθυμητό τελικό αρχείο.
Εξετάστε το SVG στο μέγεθος χρήσης του, ιδίως όταν περιέχει γράμματα, στενά κενά ή μικρές λεπτομέρειες. Η αντιστοίχιση χρωμάτων αναφοράς δεν είναι εγγυημένη και άσχετες αναφορές μπορούν να ανταγωνίζονται. Αν σύνολο εικονιδίων γίνεται επαναληπτικό, αλλάξτε αντικείμενο, στάση ή διάταξη στο prompt, διατηρώντας συνεκτικό ύφος. Το χρήσιμο παραδοτέο είναι συνεπές διανυσματικό γραφικό που ανασχηματίζεται και επαναχρωματίζεται σε σχεδιαστική ροή, με γεωμετρία και αναγνωσιμότητα ελεγμένες βάσει των οδηγιών.
Μέσω του Ailoot, επιλέξτε αυτό ακριβώς το αναγνωριστικό μοντέλου στο /v1/images/generations και δώστε τη δημιουργική προτροπή. Διατηρήστε κάθε επιστρεφόμενη εγγραφή data, είτε η απόκριση περιέχει URL είτε κωδικοποιημένο περιεχόμενο εικόνας, και αποθηκεύστε τα πραγματικά byte με τον επιστρεφόμενο τύπο περιεχομένου τους. Κρατήστε usage και τυχόν task_id πολυμέσων με το αρχείο και ελέγξτε τα σχήματα, τα γράμματα και τις χρωματικές περιοχές του στο επιθυμητό σχέδιο.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorΕισαγωγή
Το Recraft V4 Styles Vector δημιουργεί επεξεργάσιμα γραφικά SVG από κειμενικές οδηγίες και υποχρεωτικό οπτικό ύφος. Ταιριάζει σε συντονισμένα εικονίδια, λογότυπα και εικονογραφήσεις με γραμμές, παλέτα και απόδοση που ακολουθούν κοινή κατεύθυνση αναφοράς.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Εικόνες
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Images POST /v1/images/generations
- Είσοδος
text,image- Έξοδος
image- Μορφή εξόδου
- Αρχείο εικόνας
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια recraft/recraft-v4-styles-vector Συνθήκες: Χρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot. | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: | Προεπιλογή— |
Πεδίοn | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 6 Συνθήκες: | Προεπιλογή— |
Πεδίο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 Συνθήκες: | Προεπιλογή— |
Πεδίοoutput_format | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια svg Συνθήκες: | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: | Προεπιλογή— |
Πεδίοquality | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια auto, low, medium, high, xhigh, max Συνθήκες: | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
reference_guided_image
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, input_references |
Παράμετροςoptional | Σύμβασηn, aspect_ratio, output_format, quality |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε ακριβώς αυτόν τον επιλογέα δρομολόγησης του Ailoot., Το quality είναι μια κοινή τεκμηριωμένη παράμετρος· οι πάροχοι χωρίς ρύθμιση ποιότητας την αγνοούν. Δεν παρέχεται υπόσχεση βελτίωσης ποιότητας για κάθε μοντέλο. |
Κύκλος ζωής: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Το πραγματικό task_id που επιστράφηκε ή η επιλεγμένη εγγραφή βιβλιοθήκης· το operation_id είναι ξεχωριστό αναγνωριστικό.
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.1 ανά εικόνα εξόδου |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.1 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-styles-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field.", "input_references": [{"type": "image_url", "image_url": {"url": "YOUR_ACCESSIBLE_IMAGE_URL"}}]}')
p['input_references'][0]['image_url']['url']=os.environ['AILOOT_IMAGE_URL']
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
# Submit once. Retain the complete result, original identifiers and every response header.
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Images
Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, τα αρχικά αναγνωριστικά, κάθε πραγματική έξοδο και όλα τα πεδία χρήσης και λογιστικής καταγραφής. Αποθηκεύστε κάθε μοναδικό αρχείο πολυμέσων που σας ανήκει και διατηρήστε κάθε ρόλο που παραπέμπει σε αυτό.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το αρχικό X-Client-Request-ID, την απόκριση και τις κεφαλίδες. Ένα άγνωστο αποτέλεσμα ή το result_pending_check δεν επιτρέπουν δεύτερο αίτημα δημιουργίας.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοdata[].url | Τύποςstring |
Πεδίοdata[].b64_json | Τύποςstring |
Πεδίοusage | Τύποςobject |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΈνα υποχρεωτικό πεδίο, ο επιλογέας μοντέλου, ο τύπος ή η μορφή αναπαράστασης της εισόδου δεν είναι έγκυρα. | Επόμενο βήμαΕξετάστε τις λεπτομέρειες επικύρωσης που επιστράφηκαν πριν ετοιμάσετε ξεχωριστό αίτημα. |
Απάντηση | ΣυνθήκηΤο αρχικό αίτημα ή αποτέλεσμα είναι άγνωστο ή απαιτεί έλεγχο. | Επόμενο βήμαΔιατηρήστε τα αρχικά αναγνωριστικά και τις κεφαλίδες· διαβάστε μόνο τις υποστηριζόμενες εγγραφές κατάστασης ή βιβλιοθήκης. Μην υποβάλετε ξανά αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra recraft/recraft-v4-styles-vector
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Recraft: Recraft V4 Styles Vector
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Ποια όρια ισχύουν;
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6