Recraft: Recraft V4 Vector
Recraft V4 Vector mencipta logo, ilustrasi dan aset grafik SVG boleh sunting daripada taklimat kreatif. Ia ialah edisi vektor standard V4, dengan geometri boleh skala, rujukan gaya pilihan dan aliran kerja imej kepada imej yang didokumenkan secara berasingan.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4 Vector ialah edisi penghasil SVG standard Recraft V4. Ia direka untuk grafik yang bergantung pada bentuk jelas, kawasan warna dan komposisi, termasuk logo, sistem ikon dan ilustrasi. Pengeluar menerangkan V4 sebagai keluarga yang menumpukan reka bentuk dengan pentafsiran prom yang kukuh dalam kerja raster dan vektor. Hasil serahan edisi ini ialah karya SVG boleh sunting yang boleh dilaraskan dalam aliran kerja reka bentuk, bukannya bitmap PNG atau WebP.
Model yang tepat ialah recraftv4_vector, berasingan daripada V4 Pro Vector dan varian raster V4. Panduan saiz pengeluar membenarkan empat belas nisbah lebar kepada tinggi untuk keluaran vektor dan secara jelas menyatakan SVG tidak mempunyai dimensi piksel tetap. Pilih bentuk aset dengan nisbah bidang, kemudian pilih penempatan dan saiz paparannya dalam reka bentuk akhir. Label 1K model raster V4 tidak menentukan resolusi varian SVG ini.
Panduan vektor V4 mengesyorkan supaya jenis grafik, logik bentuk, sistem warna, aturan garisan dan susun atur ditentukan. Untuk ikon kecil, nyatakan objek dan siluet yang menjadikannya boleh dikenal pasti. Untuk sistem ilustrasi, kekalkan aturan garisan dan isian merentas taklimat. Untuk ikon penghantaran, minta van bergaris luar dengan bucu membulat, satu bentuk bungkusan besar dan palet terkawal, berpusat dalam komposisi segi empat sama. Huraikan geometri, bukannya menambah butiran permukaan fotografi apabila hasil yang dimaksudkan ialah grafik rata.
Penjanaan menyokong prom sehingga 10,000 aksara, seed rawak, satu hingga enam imej serta kawalan warna pilihan dan warna latar. Gaya serasi atau imej rujukan pilihan boleh memandu bahasa visual dengan pemadanan flexible atau precise. Rujukan tidak menggantikan arahan tentang subjek atau susun atur baharu. Gunakan satu aset yang jelas atau set rujukan yang selaras; pemadanan warna tepat dengan rujukan 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.
Aliran kerja imej kepada imej yang berasingan boleh menggunakan model vektor V4 untuk menghasilkan SVG daripada imej sedia ada dan permintaan perubahan teks. Tetapan strength yang wajib berjulat daripada 0 hingga 1: nilai lebih rendah kekal lebih hampir kepada sumber, manakala nilai lebih tinggi membenarkan perubahan lebih besar. Operasi menerima PNG, JPG, WebP atau SVG dalam had saiz dan resolusi yang didokumenkan, serta tidak menerima kawalan gaya V4. Perbezaan itu penting apabila memilih sama ada imej patut membekalkan kandungan untuk diubah atau sekadar gaya visual bagi aset baharu. Untuk imej kepada imej, berikan PNG, JPG, WebP atau SVG di bawah 20 MB, tidak melebihi 16 megapiksel, dengan kedua-dua sisi antara 256 dan 4,096 piksel.
Rujukan penjanaan V4 semasa mengecualikan nama gaya terkurasi, negative_prompt, text_layout, artistic_level dan no_text. Letakkan struktur dan perkataan yang dimaksudkan dalam taklimat positif. Untuk hasil logo atau huruf, periksa SVG pada saiz kecil dan besar bagi jarak, kebolehbacaan dan butiran yang tidak dimaksudkan. Nyatakan hierarki tipografi dan bentuk geometri secara jelas, kemudian sempurnakan serta tempatkan aset vektor mengikut taklimat reka bentuk.
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-vector
recraft/recraft-v4-vectorPengenalan
Recraft V4 Vector mencipta logo, ilustrasi dan aset grafik SVG boleh sunting daripada taklimat kreatif. Ia ialah edisi vektor standard V4, dengan geometri boleh skala, rujukan gaya pilihan dan aliran kerja imej kepada imej yang didokumenkan secara berasingan.
- 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-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.16 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.16 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-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-vector
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Recraft: Recraft V4 Vector
- Apakah input dan hasil yang tersedia?
POST /v1/images/generations·recraft/recraft-v4-vector:text,image→image- Apakah medan yang digunakan oleh permintaan?
POST /v1/images/generations·recraft/recraft-v4-vector:model,prompt,n,aspect_ratio,output_format,input_references,quality- Apakah had yang terpakai?
POST /v1/images/generations·recraft/recraft-v4-vector:n.minimum:1;n.maximum:6