Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector membuat grafis SVG yang dapat diedit dari brief teks dan gaya visual wajib. Model ini sesuai untuk ikon, logo, dan ilustrasi selaras yang aturan garis, palet, dan rendering-nya perlu mengikuti arah referensi yang sama.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Recraft V4 Styles Vector adalah model penghasil SVG dalam lini pembuatan khusus Recraft yang konsisten dalam gaya. Model ini mengubah brief teks menjadi karya vektor baru sambil menggunakan gaya referensi yang diberikan untuk memandu rendering, logika warna, dan tampilan keseluruhan. Model ini berguna untuk kumpulan ikon selaras, ilustrasi merek, dan sistem grafis dengan subjek yang berubah tetapi pengolahan visual yang harus tetap dapat dikenali. Edisi Vector mengembalikan grafis yang dapat diedit, bukan foto raster.
Pembuat mengidentifikasi edisi ini sebagai recraftv4_styles_vector. Keluarannya selalu SVG; pengaturan image_format raster tidak mengubahnya menjadi WebP atau PNG. Setiap varian vektor menerima empat belas rasio aspek yang didokumentasikan sebagai rasio lebar terhadap tinggi, bukan ukuran piksel yang persis. SVG tidak memiliki resolusi piksel tetap, sehingga keluaran 1K model raster standar bukan ukuran arsitektur edisi ini. Pilih bentuk aset yang diinginkan serta penggunaan tampilan kecil atau besar yang dituju saat menyiapkan brief.
Gaya wajib disediakan untuk setiap pembuatan. Gunakan satu hingga sepuluh referensi PNG, JPG, atau WebP, atau gaya tersimpan yang kompatibel sebagai pengganti referensi baru. Pembuat menolak permintaan yang menggabungkan pengenal gaya tersimpan dengan gambar referensi gaya. Jatah referensi yang didokumentasikan adalah total 64 MB dan di bawah 20 MB per berkas. Satu ikon atau ilustrasi yang jelas dapat menetapkan pengolahan; beberapa referensi berguna jika ketebalan garis, sudut, logika isian, dan paletnya sudah termasuk sistem visual yang sama. Setiap referensi harus memiliki sisi terpendek setidaknya 256 piksel, sisi terpanjang tidak lebih dari 4,096 piksel, dan resolusi total tidak lebih dari 16 megapiksel.
Pencocokan flexible merupakan default dan menafsirkan referensi lebih longgar, sedangkan pencocokan precise mengikuti rendering, warna, komposisi, dan pencahayaannya lebih dekat. Untuk sistem vektor, gunakan prompt untuk menetapkan jenis grafis, siluet, jumlah objek, dan tata letak. Untuk kumpulan ikon navigasi, gunakan garis luar tebal membulat, satu objek di tengah per gambar, dan palet dua warna. Pertahankan gaya referensi yang sama dan ubah objek yang disebutkan dalam setiap brief, alih-alih mencampur referensi yang tidak terkait untuk memperoleh variasi.
Referensi pembuatan mengizinkan prompt hingga 10,000 karakter, satu hingga enam keluaran, seed acak, warna pilihan, dan warna latar yang diinginkan. Prompt negatif, nama gaya kurasi, dan kontrol lama text_layout tidak didukung. Edisi Styles ini juga tidak menyediakan gambar ke gambar atau inpainting: referensi gambar menyediakan bahasa visual, bukan area yang perlu dihapus atau grafis yang sudah ada untuk dipertahankan tanpa perubahan. Instruksi struktural dalam brief positif perlu menjelaskan aset akhir yang dituju.
Periksa SVG pada ukuran penggunaannya, terutama jika desain memuat tulisan, celah sempit, atau detail kecil. Kecocokan warna terhadap referensi tidak dijamin, dan referensi yang tidak terkait dapat saling bersaing. Untuk kumpulan ikon yang mulai berulang, ubah objek, pose, atau susunan dalam prompt sambil mempertahankan gaya yang koheren. Hasil yang berguna berupa aset vektor konsisten yang dapat diubah bentuk dan warnanya dalam alur desain, dengan geometri serta keterbacaannya dinilai terhadap brief.
Melalui Ailoot, pilih ID model yang persis ini di /v1/images/generations dan berikan prompt kreatif. Pertahankan setiap entri data yang dikembalikan, baik respons memuat URL maupun konten gambar terenkode, dan simpan byte sebenarnya bersama tipe konten yang dikembalikan. Simpan usage dan task_id media apa pun bersama aset, lalu tinjau bentuk, tulisan, dan bidang warnanya dalam desain yang dituju.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorMulai
Recraft V4 Styles Vector membuat grafis SVG yang dapat diedit dari brief teks dan gaya visual wajib. Model ini sesuai untuk ikon, logo, dan ilustrasi selaras yang aturan garis, palet, dan rendering-nya perlu mengikuti arah referensi yang sama.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Gambar
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Images POST /v1/images/generations
- Masukan
text,image- Keluaran
image- Format keluaran
- Berkas gambar
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan recraft/recraft-v4-styles-vector Kondisi: Gunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 6 Kondisi: | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Kondisi: | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan svg Kondisi: | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanWajib | Nilai & batasan Kondisi: | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, low, medium, high, xhigh, max Kondisi: | Bawaan— |
Kombinasi bahan masukan
reference_guided_image
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, input_references |
Parameteroptional | Kontrakn, aspect_ratio, output_format, quality |
Parametermaterial_types | Kontraktext, image |
Parameterconditions | KontrakGunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan., quality adalah kontrol umum yang didokumentasikan; penyedia yang tidak memiliki pengaturan kualitas akan mengabaikannya. Tidak ada janji peningkatan kualitas untuk setiap model. |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id yang benar-benar dikembalikan atau catatan pustaka yang dipilih; operation_id adalah pengenal terpisah
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Kondisi penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Kondisi penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiReferensi masukan | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper permintaan | Kondisi penagihanPembuatan gaya saat menggunakan referensi gaya; sekali per permintaan, ditambahkan pada harga gambar keluaran. | Biaya Masukan · Referensi masukan · Perkiraan hanya untuk perbandingan $0.01 per permintaan Hanya perkiraan sebagai acuan; biaya akhir mengikuti faktur asli yang tercatat. |
| Konfigurasigambar keluaran | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper gambar keluaran | Kondisi penagihan— | Biaya Keluaran · gambar keluaran · Perkiraan hanya untuk perbandingan $0.1 per gambar keluaran |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Kondisi penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.1 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
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.
Terima dan simpan hasil
Ailoot Ultra · Images
Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara utuh, pengenal asli, setiap keluaran aktual, dan semua bidang penggunaan/akuntansi. Simpan setiap aset unik milik Ailoot dan pertahankan setiap peran yang menunjuk kepadanya.
Jika respons asli perlu diperiksa
Simpan X-Client-Request-ID asli, respons, dan header. Hasil yang tidak diketahui atau result_pending_check tidak mengizinkan permintaan pembuatan kedua.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomdata[].url | Jenisstring |
Kolomdata[].b64_json | Jenisstring |
Kolomusage | Jenisobject |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiKolom wajib, pemilih model, tipe, atau bentuk masukan tidak valid. | Langkah berikutnyaPeriksa rincian validasi yang dikembalikan sebelum menyiapkan permintaan terpisah. |
Respons | KondisiPermintaan atau hasil asli tidak diketahui atau perlu diperiksa. | Langkah berikutnyaSimpan pengenal dan header asli; baca hanya catatan status/pustaka yang didukung. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot Ultra recraft/recraft-v4-styles-vector
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Recraft: Recraft V4 Styles Vector
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Batasan apa yang berlaku?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6