Recraft: Recraft V4 Styles Vector
Recraft V4 Styles Vector mencipta grafik SVG boleh sunting daripada taklimat teks dan gaya visual wajib. Ia sesuai untuk ikon, logo dan ilustrasi yang diselaraskan, dengan garisan, palet dan rendering yang patut mengikuti arah rujukan yang sama.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4 Styles Vector ialah model penghasil SVG dalam barisan khusus Recraft untuk penjanaan dengan gaya selaras. Ia menukar taklimat teks kepada karya vektor baharu sambil menggunakan gaya rujukan yang diberikan untuk memandu rendering, logik warna dan rupa keseluruhan. Ia berguna untuk set ikon yang diselaraskan, ilustrasi jenama dan sistem grafik apabila subjek berubah tetapi gaya visual patut kekal boleh dikenal pasti. Edisi Vector memulangkan grafik boleh sunting, bukannya foto raster.
Pengeluar mengenal pasti edisi ini sebagai recraftv4_styles_vector. Keluarannya sentiasa SVG; tetapan raster image_format tidak menukarkannya kepada WebP atau PNG. Setiap varian vektor menerima empat belas nisbah bidang yang didokumenkan sebagai nisbah lebar kepada tinggi, bukannya saiz piksel tepat. SVG tidak mempunyai resolusi piksel tetap, maka keluaran 1K model raster standard bukan saiz seni bina untuk edisi ini. Pilih bentuk aset yang diingini dan kegunaan paparan kecil atau besar yang dimaksudkan semasa menyediakan taklimat.
Gaya diperlukan untuk setiap penjanaan. Gunakan satu hingga sepuluh rujukan PNG, JPG atau WebP, atau gaya tersimpan yang serasi sebagai ganti rujukan baharu. Pengeluar menolak permintaan yang menggabungkan pengecam gaya tersimpan dengan imej rujukan gaya. Peruntukan rujukan yang didokumenkan ialah 64 MB keseluruhannya dan di bawah 20 MB bagi setiap fail. Satu ikon atau ilustrasi yang jelas boleh menetapkan gaya; beberapa rujukan berguna apabila ketebalan garisan, bucu, logik isian dan paletnya sudah tergolong dalam sistem visual yang sama. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.
Pemadanan flexible ialah lalai dan mentafsir rujukan dengan lebih longgar, manakala pemadanan precise mengikuti rendering, warna, komposisi dan pencahayaannya dengan lebih rapat. Untuk sistem vektor, gunakan prom bagi menentukan jenis grafik, siluet, bilangan objek dan susun atur. Untuk set ikon navigasi, gunakan garis luar tebal yang membulat, satu objek berpusat bagi setiap imej dan palet dua warna. Kekalkan gaya rujukan yang sama dan ubah objek yang dinamakan dalam setiap taklimat, bukannya mencampurkan rujukan yang tidak berkaitan untuk memperoleh variasi.
Rujukan penjanaan membenarkan prom sehingga 10,000 aksara, satu hingga enam keluaran, seed rawak, warna pilihan dan warna latar yang diingini. Prom negatif, nama gaya terkurasi dan kawalan lama text_layout tidak disokong. Edisi Styles ini juga tidak menyediakan imej kepada imej atau inpainting: imej rujukan membekalkan bahasa visual, bukannya kawasan untuk dipadam atau grafik sedia ada untuk dikekalkan tanpa perubahan. Arahan struktur dalam taklimat positif patut menghuraikan aset siap yang dimaksudkan.
Periksa SVG pada saiz yang akan digunakan, khususnya apabila reka bentuk mengandungi huruf, jurang sempit atau butiran kecil. Pemadanan warna dengan rujukan tidak dijamin, dan rujukan yang tidak berkaitan boleh bersaing. Untuk set ikon yang menjadi berulang, ubah objek, pose atau susunan dalam prom sambil mengekalkan gaya yang selaras. Hasil serahan yang berguna ialah aset vektor konsisten yang boleh diubah bentuk dan warna dalam aliran kerja reka bentuk, dengan geometri dan kebolehbacaan dinilai berdasarkan taklimat.
Melalui Ailoot, pilih ID model yang tepat ini dalam /v1/images/generations dan sertakan prom kreatif. Simpan setiap entri data yang dipulangkan, sama ada respons membawa URL atau kandungan imej terenkod, dan simpan bait sebenar bersama jenis kandungan yang dipulangkan. Simpan usage dan sebarang task_id media bersama aset, kemudian semak bentuk, huruf dan kawasan warnanya dalam reka bentuk yang dimaksudkan.
Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vector
recraft/recraft-v4-styles-vectorPengenalan
Recraft V4 Styles Vector mencipta grafik SVG boleh sunting daripada taklimat teks dan gaya visual wajib. Ia sesuai untuk ikon, logo dan ilustrasi yang diselaraskan, dengan garisan, palet dan rendering yang patut mengikuti arah rujukan yang sama.
- Input yang diterima
- Teks · Imej
- Hasil
- Imej
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Images POST /v1/images/generations
- Input
text,image- Output
image- Format output
- Fail imej
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had recraft/recraft-v4-styles-vector Syarat: Gunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan. | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 6 Syarat: | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto Syarat: | Lalai— |
Medanoutput_format | Jenisstring | KeperluanPilihan | Nilai & had svg Syarat: | Lalai— |
Medaninput_references | Jenisarray | KeperluanDiperlukan | Nilai & had Syarat: | Lalai— |
Medanquality | Jenisstring | KeperluanPilihan | Nilai & had auto, low, medium, high, xhigh, max Syarat: | Lalai— |
Gabungan bahan input
reference_guided_image
Parameter kaedah dan kitar hayat
| 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 penghalaan Ailoot ini tepat seperti yang dinyatakan., quality ialah kawalan umum yang didokumentasikan; penyedia tanpa tetapan kualiti mengabaikannya. Tiada peningkatan kualiti dijanjikan bagi setiap model. |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka yang dipilih; operation_id ialah pengecam berasingan
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Syarat pengebilan | Caj |
|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Syarat pengebilan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiRujukan input | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap permintaan | Syarat pengebilanPenciptaan gaya apabila menjana dengan rujukan gaya; sekali bagi setiap permintaan, sebagai tambahan kepada harga imej output. | Caj Input · Rujukan input · Anggaran untuk perbandingan sahaja $0.01 bagi setiap permintaan Anggaran untuk rujukan sahaja; caj akhir mengikut invois asal yang direkodkan. |
| Konfigurasiimej keluaran | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap imej keluaran | Syarat pengebilan— | Caj Output · imej keluaran · Anggaran untuk perbandingan sahaja $0.1 bagi setiap imej keluaran |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Syarat pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.1 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
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
Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan respons dan pengepala lengkap, pengecam asal, setiap output sebenar dan semua medan penggunaan/perakaunan. Simpan setiap aset unik milik anda dan kekalkan setiap peranan yang merujuk kepadanya.
Jika respons asal perlu disemak
Simpan X-Client-Request-ID asal, respons dan pengepala. Hasil yang tidak diketahui atau result_pending_check tidak membenarkan penciptaan kedua.
Medan respons
| Medan | Jenis |
|---|---|
Medandata[].url | Jenisstring |
Medandata[].b64_json | Jenisstring |
Medanusage | Jenisobject |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, pemilih model, jenis atau bentuk input tidak sah. | Langkah seterusnyaSemak butiran pengesahan yang dikembalikan sebelum menyediakan permintaan berasingan. |
Respons | SyaratPermintaan atau hasil asal tidak diketahui atau memerlukan semakan. | Langkah seterusnyaSimpan pengecam dan pengepala asal; baca hanya rekod status/pustaka yang disokong. Jangan hantar semula permintaan penciptaan. |
Alias
Alias model
Ailoot Ultra recraft/recraft-v4-styles-vector
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Recraft: Recraft V4 Styles Vector
- Apakah input dan hasil yang tersedia?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:text,image→image- Apakah medan yang digunakan oleh permintaan?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Apakah had yang terpakai?
POST /v1/images/generations·recraft/recraft-v4-styles-vector:n.minimum:1;n.maximum:6