Recraft: Recraft V4 Vector
Recraft V4 Vector membuat logo, ilustrasi, dan aset grafis SVG yang dapat diedit dari brief kreatif. Ini adalah edisi vektor standar V4, dengan geometri yang dapat diskalakan, referensi gaya opsional, dan alur gambar ke gambar yang didokumentasikan secara terpisah.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Recraft V4 Vector adalah edisi penghasil SVG standar dari Recraft V4. Model ini dirancang untuk grafis yang bergantung pada bentuk jelas, bidang warna, dan komposisi, termasuk logo, sistem ikon, dan ilustrasi. Pembuat menjelaskan V4 sebagai keluarga yang berfokus pada desain dengan penafsiran prompt yang kuat untuk pekerjaan raster maupun vektor. Hasil edisi ini adalah karya SVG yang dapat diedit dan disesuaikan dalam alur desain, bukan bitmap PNG atau WebP.
Model yang persis adalah recraftv4_vector, terpisah dari V4 Pro Vector dan varian raster V4. Panduan ukuran pembuat mengizinkan empat belas rasio lebar terhadap tinggi untuk keluaran vektor dan secara eksplisit menyatakan SVG tidak memiliki dimensi piksel tetap. Tentukan bentuk aset melalui rasio aspek, lalu pilih penempatan dan ukuran tampilannya dalam desain akhir. Label 1K model raster V4 tidak menetapkan resolusi varian SVG ini.
Panduan vektor V4 merekomendasikan penetapan jenis grafis, logika bentuk, sistem warna, aturan garis, dan tata letak. Untuk ikon kecil, sebutkan objek dan siluet yang membuatnya dapat dikenali. Untuk sistem ilustrasi, pertahankan aturan garis dan isian yang stabil di seluruh brief. Untuk ikon pengiriman, minta van bergaris luar dengan sudut membulat, satu bentuk paket besar, dan palet terkendali, yang ditempatkan di tengah komposisi persegi. Jelaskan geometri alih-alih menambahkan detail permukaan fotografis jika hasil yang dituju adalah grafis datar.
Pembuatan mendukung prompt hingga 10,000 karakter, seed acak, satu hingga enam gambar, serta kontrol warna pilihan dan warna latar. Gaya yang kompatibel atau gambar referensi opsional dapat memandu bahasa visual dengan pencocokan flexible atau precise. Referensi tidak menggantikan instruksi tentang subjek atau tata letak baru. Gunakan satu aset yang jelas atau kumpulan referensi yang koheren; kecocokan warna yang persis terhadap referensi tidak dijamin. Untuk pembuatan berdasarkan gaya referensi, gunakan satu hingga sepuluh gambar PNG, JPG, atau WebP, dengan total tidak lebih dari 64 MB dan masing-masing di bawah 20 MB. Setiap referensi harus memiliki sisi terpendek setidaknya 256 piksel, sisi terpanjang tidak lebih dari 4,096 piksel, dan resolusi tidak lebih dari 16 megapiksel. Gunakan referensi tersebut atau gaya tersimpan yang kompatibel, bukan keduanya.
Alur gambar ke gambar terpisah dapat menggunakan model vektor V4 untuk menghasilkan SVG dari gambar yang sudah ada dan permintaan perubahan teks. Pengaturan strength yang wajib diisi berkisar dari 0 hingga 1: nilai lebih rendah tetap lebih dekat dengan sumber, sedangkan nilai lebih tinggi mengizinkan perubahan lebih besar. Operasi menerima PNG, JPG, WebP, atau SVG dalam batas ukuran dan resolusi yang didokumentasikan, dan tidak menerima kontrol gaya V4. Pembedaan ini penting saat memilih apakah gambar harus menyediakan konten yang diubah atau hanya pengolahan visual untuk aset baru. Untuk gambar ke gambar, berikan PNG, JPG, WebP, atau SVG di bawah 20 MB, tidak lebih dari 16 megapiksel, dengan kedua sisi antara 256 dan 4,096 piksel.
Referensi pembuatan V4 terkini mengecualikan nama gaya kurasi, negative_prompt, text_layout, artistic_level, dan no_text. Masukkan struktur dan susunan kata yang dituju dalam brief positif. Untuk hasil logo atau tulisan, periksa SVG pada ukuran kecil dan besar untuk jarak, keterbacaan, serta detail yang tidak diinginkan. Tentukan hierarki tipografi dan bentuk geometris secara eksplisit, lalu selesaikan dan tempatkan aset vektor sesuai brief desain.
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-vector
recraft/recraft-v4-vectorMulai
Recraft V4 Vector membuat logo, ilustrasi, dan aset grafis SVG yang dapat diedit dari brief kreatif. Ini adalah edisi vektor standar V4, dengan geometri yang dapat diskalakan, referensi gaya opsional, dan alur gambar ke gambar yang didokumentasikan secara terpisah.
- 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-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, 4:3, 3:4, 16:9, 9:16, auto Kondisi: | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan svg Kondisi: | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Kondisi: | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, low, medium, high, xhigh, max Kondisi: | Bawaan— |
Kombinasi bahan masukan
Teks ke gambar
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontrakn, aspect_ratio, output_format, input_references, 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 | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan 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 |
| Konfigurasigambar keluaran | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper gambar keluaran | Biaya Keluaran · gambar keluaran · Perkiraan hanya untuk perbandingan $0.16 per gambar keluaran |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.16 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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')
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-vector
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Recraft: Recraft V4 Vector
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Batasan apa yang berlaku?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6