Recraft: Recraft V4 Pro Vector
Recraft V4 Pro Vector menjana karya SVG boleh sunting untuk komposisi terperinci, logo dan ilustrasi. Ia ialah edisi vektor Pro bagi V4, menyokong taklimat penjanaan teks kepada imej dan aliran kerja imej kepada imej yang berasingan tanpa menetapkan saiz piksel raster kepada SVG.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4 Pro Vector ialah model SVG Pro dalam generasi V4 Recraft. Keluarga ini menumpukan pertimbangan visual, hubungan warna yang selaras, komposisi dan pentafsiran terperinci taklimat kreatif. Cabang Pro disasarkan untuk butiran lebih halus dan komposisi lebih mencabar, manakala edisi Vector ini membekalkan karya SVG boleh sunting. Ia berguna untuk ilustrasi grafik, lambang atau konsep huruf yang memerlukan fail kerja vektor bagi pelarasan reka bentuk kemudian.
Kod model yang tepat ialah recraftv4_pro_vector. Ia berbeza daripada V4 Vector standard, model raster V4 Pro dan keluarga V4.1 yang lebih kemudian. Rujukan saiz pengeluar menyatakan bahawa semua model vektor menerima empat belas nisbah bidang sebagai nisbah lebar kepada tinggi dan keluaran SVG tidak mempunyai saiz piksel tetap. Oleh itu, dimensi raster 2048 × 2048 V4 Pro bukan had resolusi piksel untuk edisi ini. Pilih komposisi dan bentuk aset yang dimaksudkan, bukannya label saiz raster.
Panduan V4 pengeluar menekankan logik grafik rata untuk kerja vektor dan logo. Huraikan jenis grafik, geometri, siluet, aturan garisan, palet dan susun atur. Untuk lambang pelabuhan, minta grafik terperinci dengan siluet rumah api yang padat, bentuk ombak besar, ruang dalaman yang luas dan dua warna rata. Nyatakan unsur yang patut dominan dan butiran yang patut kekal sekunder. Penerangan struktur lebih berguna untuk hasil vektor boleh sunting berbanding tekstur fotografi atau bahasa bahan apabila reka bentuk patut kekal rata.
Rujukan penjanaan tepat semasa menyokong prom sehingga 10,000 aksara, satu hingga enam keluaran, seed rawak dan kawalan warna pilihan atau warna latar. Gaya tersuai serasi dan imej rujukan pilihan boleh menetapkan gaya visual yang berulang. Pemadanan flexible membenarkan pentafsiran yang lebih longgar dan pemadanan precise mengikuti gaya dengan lebih rapat. Gunakan rujukan yang selaras secara visual dan nyatakan sistem warna yang dimaksudkan dengan jelas; warna rujukan yang tepat tidak dijamin. Untuk penjanaan berpandukan gaya rujukan, gunakan satu hingga sepuluh imej PNG, JPG atau WebP, tidak melebihi 64 MB keseluruhannya dan kurang daripada 20 MB setiap satu. Setiap rujukan memerlukan sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan resolusi tidak melebihi 16 megapiksel. Gunakan sama ada rujukan ini atau gaya tersimpan yang serasi, bukannya kedua-duanya.
Recraft mendokumenkan imej kepada imej untuk model raster dan vektor V4. Berikan imej sedia ada dan huraikan perubahan yang diingini, dengan strength daripada 0 hingga 1 menentukan sejauh mana hasil yang dijana menyimpang daripada sumber. Model vektor memulangkan SVG. Operasi ini tidak menerima kawalan gaya V4, maka ia berbeza daripada mencipta grafik baharu dengan rujukan gaya. Keperluan input imejnya membenarkan PNG, JPG, WebP atau SVG di bawah 20 MB, sehingga 16 MP, dengan sisi antara 256 dan 4096 piksel.
V4 tidak menyokong kawalan V3 negative_prompt, nama gaya pilihan terkurasi, text_layout, artistic_level atau no_text. Panduan pengeluarnya menerangkan frasa pendek dan sederhana yang boleh dibaca apabila hierarki ditentukan, tetapi tipografi tepat masih perlu diperiksa dalam SVG yang telah siap. Semak siluet, huruf, kawasan warna dan butiran halus pada saiz yang dimaksudkan, kemudian ubah bentuk atau warna aset mengikut keperluan reka bentuk. Ini ialah edisi penjanaan vektor terperinci, dengan keluaran dan kawalannya sendiri, bukannya sifat model raster Pro.
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-pro-vector
recraft/recraft-v4-pro-vectorPengenalan
Recraft V4 Pro Vector menjana karya SVG boleh sunting untuk komposisi terperinci, logo dan ilustrasi. Ia ialah edisi vektor Pro bagi V4, menyokong taklimat penjanaan teks kepada imej dan aliran kerja imej kepada imej yang berasingan tanpa menetapkan saiz piksel raster kepada SVG.
- 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-pro-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, 4:3, 3:4, 16:9, 9:16, auto Syarat: | Lalai— |
Medanoutput_format | Jenisstring | KeperluanPilihan | Nilai & had svg Syarat: | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Syarat: | Lalai— |
Medanquality | Jenisstring | KeperluanPilihan | Nilai & had auto, low, medium, high, xhigh, max Syarat: | Lalai— |
Gabungan bahan input
Teks kepada imej
Parameter kaedah dan kitar hayat
| 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 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 | Caj |
|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit 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 |
| Konfigurasiimej keluaran | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap imej keluaran | Caj Output · imej keluaran · Anggaran untuk perbandingan sahaja $0.6 bagi setiap imej keluaran |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.6 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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "recraft/recraft-v4-pro-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
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-pro-vector
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Recraft: Recraft V4 Pro Vector
- Apakah input dan hasil yang tersedia?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:text,image→image- Apakah medan yang digunakan oleh permintaan?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Apakah had yang terpakai?
POST /v1/images/generations·recraft/recraft-v4-pro-vector:n.minimum:1;n.maximum:6