Recraft V4.1 Pro ialah edisi raster resolusi lebih tinggi dalam keluarga penjanaan V4.1 ekspresif Recraft. Pengeluar menekankan fotorealisme semula jadi, komposisi disengajakan dan gaya ilustrasi yang boleh dibangunkan daripada arah kreatif ringkas. Pro ditujukan untuk kerja yang memerlukan butiran lebih halus dan hasil raster lebih besar, termasuk visual pemasaran besar serta susun atur berorientasikan cetakan. Ia berbeza daripada persembahan lebih ringkas Utility Pro dan output SVG boleh sunting Pro Vector.
Model tepat ialah recraftv4_1_pro. Rujukan pengeluarnya menyenaraikan output 2K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 2048 × 2048 piksel; 16:9 ialah 2688 × 1536 dan 3:4 ialah 1792 × 2432, dengan nisbah lain dibenarkan dipetakan kepada dimensi masing-masing. Gunakan nisbah bidang mengikut susun atur dimaksudkan atau saiz tepat daripada jadual pengeluar. Nama Pro tidak menjadikan setiap komposisi segi empat sama dan tidak menukar imej raster kepada geometri vektor.
V4.1 boleh mentafsir arahan ringkas sambil membekalkan pilihan cahaya, suasana dan komposisi. Ini berguna untuk menerokai foto editorial, ilustrasi bergaya atau visual berdimensi dengan bahan memantul. Rupa 3D terpapar kekal imej, bukannya adegan tiga dimensi boleh sunting. Apabila arah seni khusus diperlukan, huraikan subjek dan adegan, pembingkaian, tingkah laku bahan, arah cahaya, latar belakang serta hierarki visual tanpa menjangkakan prompt terbuka menyelesaikan setiap butiran mengikut kehendak.
Untuk foto editorial, minta pandangan dekat lampu logam dengan kemasan berus dalam cahaya tingkap lembut, ruang dalaman hangat yang terasa dihuni dan komposisi tenang dengan ruang untuk kapsyen. Arahan lebih ilustratif boleh menetapkan bentuk warna lebar, pose watak bertenaga dan latar belakang terkawal. Berikan kegunaan dimaksudkan serta butiran pembeza subjek, kemudian periksa bahan, anatomi dan komposisi pada output lebih besar. Hasilnya ialah aset kreatif berpandukan arahan, bukan pemerhatian adegan sebenar.
Penjanaan menerima prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak serta satu hingga enam output. Rujukan gaya pilihan atau gaya tersimpan serasi boleh memberikan olahan visual berulang, dengan padanan fleksibel atau tepat. Gunakan rujukan padu dan jelas serta tetapkan kandungan dalam prompt; padanan warna tepat daripada rujukan tidak dijamin. V4.1 mengecualikan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text, jadi kawalan ini tidak patut dibawa masuk daripada edisi lama. Untuk penjanaan gaya rujukan, gunakan satu hingga sepuluh imej PNG, JPG atau WebP, jumlah tidak melebihi 64 MB dan setiap satu di bawah 20 MB. 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 serasi, bukan kedua-duanya.
Operasi imej-ke-imej berasingan Recraft menyokong keluarga V4.1 dengan imej sedia ada, prompt dan kekuatan 0 hingga 1. Ia boleh mengekalkan aspek sumber sambil mengubah aspek lain; kekuatan lebih rendah kekal lebih dekat, dan kekuatan lebih tinggi membenarkan lebih banyak perubahan. Operasi itu tidak menerima kawalan gaya tersuai V4.1. Sediakan imej sumber dalam had imej yang didokumenkan dan nyatakan perubahan dikehendaki serta atribut yang perlu membentuk hasil baharu. Untuk aset akhir, periksa output dalam komposisi sebenar, khususnya butiran halus, tulisan dan pemotongannya. Untuk imej-ke-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.
", "aboutText": "Recraft V4.1 Pro ialah edisi raster resolusi lebih tinggi dalam keluarga penjanaan V4.1 ekspresif Recraft. Pengeluar menekankan fotorealisme semula jadi, komposisi disengajakan dan gaya ilustrasi yang boleh dibangunkan daripada arah kreatif ringkas. Pro ditujukan untuk kerja yang memerlukan butiran lebih halus dan hasil raster lebih besar, termasuk visual pemasaran besar serta susun atur berorientasikan cetakan. Ia berbeza daripada persembahan lebih ringkas Utility Pro dan output SVG boleh sunting Pro Vector.\n\nModel tepat ialah recraftv4_1_pro. Rujukan pengeluarnya menyenaraikan output 2K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 2048 × 2048 piksel; 16:9 ialah 2688 × 1536 dan 3:4 ialah 1792 × 2432, dengan nisbah lain dibenarkan dipetakan kepada dimensi masing-masing. Gunakan nisbah bidang mengikut susun atur dimaksudkan atau saiz tepat daripada jadual pengeluar. Nama Pro tidak menjadikan setiap komposisi segi empat sama dan tidak menukar imej raster kepada geometri vektor.\n\nV4.1 boleh mentafsir arahan ringkas sambil membekalkan pilihan cahaya, suasana dan komposisi. Ini berguna untuk menerokai foto editorial, ilustrasi bergaya atau visual berdimensi dengan bahan memantul. Rupa 3D terpapar kekal imej, bukannya adegan tiga dimensi boleh sunting. Apabila arah seni khusus diperlukan, huraikan subjek dan adegan, pembingkaian, tingkah laku bahan, arah cahaya, latar belakang serta hierarki visual tanpa menjangkakan prompt terbuka menyelesaikan setiap butiran mengikut kehendak.\n\nUntuk foto editorial, minta pandangan dekat lampu logam dengan kemasan berus dalam cahaya tingkap lembut, ruang dalaman hangat yang terasa dihuni dan komposisi tenang dengan ruang untuk kapsyen. Arahan lebih ilustratif boleh menetapkan bentuk warna lebar, pose watak bertenaga dan latar belakang terkawal. Berikan kegunaan dimaksudkan serta butiran pembeza subjek, kemudian periksa bahan, anatomi dan komposisi pada output lebih besar. Hasilnya ialah aset kreatif berpandukan arahan, bukan pemerhatian adegan sebenar.\n\nPenjanaan menerima prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak serta satu hingga enam output. Rujukan gaya pilihan atau gaya tersimpan serasi boleh memberikan olahan visual berulang, dengan padanan fleksibel atau tepat. Gunakan rujukan padu dan jelas serta tetapkan kandungan dalam prompt; padanan warna tepat daripada rujukan tidak dijamin. V4.1 mengecualikan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text, jadi kawalan ini tidak patut dibawa masuk daripada edisi lama. Untuk penjanaan gaya rujukan, gunakan satu hingga sepuluh imej PNG, JPG atau WebP, jumlah tidak melebihi 64 MB dan setiap satu di bawah 20 MB. 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 serasi, bukan kedua-duanya.\n\nOperasi imej-ke-imej berasingan Recraft menyokong keluarga V4.1 dengan imej sedia ada, prompt dan kekuatan 0 hingga 1. Ia boleh mengekalkan aspek sumber sambil mengubah aspek lain; kekuatan lebih rendah kekal lebih dekat, dan kekuatan lebih tinggi membenarkan lebih banyak perubahan. Operasi itu tidak menerima kawalan gaya tersuai V4.1. Sediakan imej sumber dalam had imej yang didokumenkan dan nyatakan perubahan dikehendaki serta atribut yang perlu membentuk hasil baharu. Untuk aset akhir, periksa output dalam komposisi sebenar, khususnya butiran halus, tulisan dan pemotongannya. Untuk imej-ke-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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "de74cf23d7aef2c43c2aa514c1ce4ebfdfd41ef5d0d0034eb3ab883df249545b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "recraft/recraft-v4.1-proRecraft V4.1 Pro menjana imej raster 2K terperinci untuk fotografi ekspresif, ilustrasi dan aset kreatif lebih besar. Ia menggabungkan fotorealisme semula jadi V4.1 serta tafsiran prompt ringkas dengan rujukan gaya pilihan dan aliran imej-ke-imej.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4.1 Pro ialah edisi raster resolusi lebih tinggi dalam keluarga penjanaan V4.1 ekspresif Recraft. Pengeluar menekankan fotorealisme semula jadi, komposisi disengajakan dan gaya ilustrasi yang boleh dibangunkan daripada arah kreatif ringkas. Pro ditujukan untuk kerja yang memerlukan butiran lebih halus dan hasil raster lebih besar, termasuk visual pemasaran besar serta susun atur berorientasikan cetakan. Ia berbeza daripada persembahan lebih ringkas Utility Pro dan output SVG boleh sunting Pro Vector.
Model tepat ialah recraftv4_1_pro. Rujukan pengeluarnya menyenaraikan output 2K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 2048 × 2048 piksel; 16:9 ialah 2688 × 1536 dan 3:4 ialah 1792 × 2432, dengan nisbah lain dibenarkan dipetakan kepada dimensi masing-masing. Gunakan nisbah bidang mengikut susun atur dimaksudkan atau saiz tepat daripada jadual pengeluar. Nama Pro tidak menjadikan setiap komposisi segi empat sama dan tidak menukar imej raster kepada geometri vektor.
V4.1 boleh mentafsir arahan ringkas sambil membekalkan pilihan cahaya, suasana dan komposisi. Ini berguna untuk menerokai foto editorial, ilustrasi bergaya atau visual berdimensi dengan bahan memantul. Rupa 3D terpapar kekal imej, bukannya adegan tiga dimensi boleh sunting. Apabila arah seni khusus diperlukan, huraikan subjek dan adegan, pembingkaian, tingkah laku bahan, arah cahaya, latar belakang serta hierarki visual tanpa menjangkakan prompt terbuka menyelesaikan setiap butiran mengikut kehendak.
Untuk foto editorial, minta pandangan dekat lampu logam dengan kemasan berus dalam cahaya tingkap lembut, ruang dalaman hangat yang terasa dihuni dan komposisi tenang dengan ruang untuk kapsyen. Arahan lebih ilustratif boleh menetapkan bentuk warna lebar, pose watak bertenaga dan latar belakang terkawal. Berikan kegunaan dimaksudkan serta butiran pembeza subjek, kemudian periksa bahan, anatomi dan komposisi pada output lebih besar. Hasilnya ialah aset kreatif berpandukan arahan, bukan pemerhatian adegan sebenar.
Penjanaan menerima prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak serta satu hingga enam output. Rujukan gaya pilihan atau gaya tersimpan serasi boleh memberikan olahan visual berulang, dengan padanan fleksibel atau tepat. Gunakan rujukan padu dan jelas serta tetapkan kandungan dalam prompt; padanan warna tepat daripada rujukan tidak dijamin. V4.1 mengecualikan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text, jadi kawalan ini tidak patut dibawa masuk daripada edisi lama. Untuk penjanaan gaya rujukan, gunakan satu hingga sepuluh imej PNG, JPG atau WebP, jumlah tidak melebihi 64 MB dan setiap satu di bawah 20 MB. 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 serasi, bukan kedua-duanya.
Operasi imej-ke-imej berasingan Recraft menyokong keluarga V4.1 dengan imej sedia ada, prompt dan kekuatan 0 hingga 1. Ia boleh mengekalkan aspek sumber sambil mengubah aspek lain; kekuatan lebih rendah kekal lebih dekat, dan kekuatan lebih tinggi membenarkan lebih banyak perubahan. Operasi itu tidak menerima kawalan gaya tersuai V4.1. Sediakan imej sumber dalam had imej yang didokumenkan dan nyatakan perubahan dikehendaki serta atribut yang perlu membentuk hasil baharu. Untuk aset akhir, periksa output dalam komposisi sebenar, khususnya butiran halus, tulisan dan pemotongannya. Untuk imej-ke-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.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had recraft/recraft-v4.1-pro | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 1:1, 4:3, 3:4, 16:9, 9:16, auto | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 6 | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 1 | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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.
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.42 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.42 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v4.1-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nMuat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSimpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.
Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.
| Medan | Jenis |
|---|---|
Medancreated | Jenis |
Medandata[].url | Jenis |
Medandata[].b64_json | Jenis |
Medanusage | Jenis |
Ailoot Ultra recraft/recraft-v4.1-pro
/v1/images