Recraft V4.1 ialah model raster utama dalam keluarga V4.1 Recraft. Ia dibina untuk penciptaan imej ekspresif, termasuk foto kelihatan semula jadi, ilustrasi dan konsep visual berdimensi. Pengeluar memperkenalkannya sebagai model yang boleh membekalkan keputusan estetika daripada prompt ringkas sambil turut memberi respons kepada arah kreatif lebih terperinci. Gunakannya untuk penerokaan, pengkonsepan dan imej yang suasana, pencahayaan serta komposisinya menjadi sebahagian hasil tanpa terhad kepada pandangan hadapan produk mudah.
Kod tepat pengeluar ialah recraftv4_1. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan output segi empat sama 1024 × 1024 piksel dan 16:9 pada 1344 × 768. Nisbah disokong lain menggunakan dimensi sendiri. V4.1 Pro ialah edisi raster 2K berasingan, Vector mengembalikan SVG boleh sunting, dan Utility mengutamakan pencahayaan serta adegan lebih ringkas. Cabang ini menyediakan hasil berbeza dan tidak patut digabungkan menjadi satu set sifat output.
Pengeluar menonjolkan adegan fotografi lebih semula jadi, latar belakang lebih tenang, gradien lebih lancar dan julat ilustrasi luas. Contohnya termasuk tulisan ekspresif, ilustrasi watak rata dan helaian rujukan watak dilukis. Prompt ringkas boleh memberikan ruang tafsiran model; arahan terperinci boleh menetapkan subjek, pose, bahan, latar belakang dan komposisi. Untuk visual berdimensi, tetapkan olahan permukaan dan pencahayaan, sambil mengingati bahawa hasil ialah imej, bukannya mesh atau projek 3D boleh sunting.
Untuk konsep ruang membaca, minta foto intim sudut membaca kecil, cahaya siang hangat, buku dan satu objek seramik, dengan susunan santai dan bukan seperti bilik pameran. Arahan ilustrasi terkawal pula boleh menamakan subjek grafik, hubungan warna dan olahan garisan. Nyatakan nisbah bidang dimaksudkan serta keputusan visual terpenting. Ini memudahkan penentuan sama ada butiran tidak dijangka merupakan tafsiran kreatif berguna atau sesuatu yang perlu berubah dalam arahan berikutnya.
Rujukan penjanaan membenarkan prompt sehingga 10,000 aksara, seed rawak, warna pilihan dan warna latar belakang dikehendaki, dengan satu hingga enam output. Imej rujukan pilihan atau gaya tersimpan serasi boleh menetapkan bahasa visual dengan padanan fleksibel atau tepat. Ia tidak diwajibkan untuk edisi V4.1 utama. Pilih rujukan bersih yang saling sepadan dan gunakan prompt untuk kandungan baharu; penghasilan semula warna rujukan tidak dijamin. 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.
V4.1 turut menyokong aliran imej-ke-imej berasingan dengan imej sedia ada, teks dan kekuatan 0 hingga 1. Operasi menggunakan kekuatan untuk mengawal tahap kedekatan imej baharu dengan sumber, dan tidak menerima kawalan gaya tersuai V4.1. Rujukan penjanaan semasa model mengecualikan negative_prompt, gaya yang dikurasi, text_layout, artistic_level dan no_text. Huraikan adegan dimaksudkan secara terus dan periksa aset hasil dalam susun atur sasaran, termasuk butiran, pemotongan dan sebarang tulisan, sebelum memilih arah visual untuk dikekalkan. 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 ialah model raster utama dalam keluarga V4.1 Recraft. Ia dibina untuk penciptaan imej ekspresif, termasuk foto kelihatan semula jadi, ilustrasi dan konsep visual berdimensi. Pengeluar memperkenalkannya sebagai model yang boleh membekalkan keputusan estetika daripada prompt ringkas sambil turut memberi respons kepada arah kreatif lebih terperinci. Gunakannya untuk penerokaan, pengkonsepan dan imej yang suasana, pencahayaan serta komposisinya menjadi sebahagian hasil tanpa terhad kepada pandangan hadapan produk mudah.\n\nKod tepat pengeluar ialah recraftv4_1. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan output segi empat sama 1024 × 1024 piksel dan 16:9 pada 1344 × 768. Nisbah disokong lain menggunakan dimensi sendiri. V4.1 Pro ialah edisi raster 2K berasingan, Vector mengembalikan SVG boleh sunting, dan Utility mengutamakan pencahayaan serta adegan lebih ringkas. Cabang ini menyediakan hasil berbeza dan tidak patut digabungkan menjadi satu set sifat output.\n\nPengeluar menonjolkan adegan fotografi lebih semula jadi, latar belakang lebih tenang, gradien lebih lancar dan julat ilustrasi luas. Contohnya termasuk tulisan ekspresif, ilustrasi watak rata dan helaian rujukan watak dilukis. Prompt ringkas boleh memberikan ruang tafsiran model; arahan terperinci boleh menetapkan subjek, pose, bahan, latar belakang dan komposisi. Untuk visual berdimensi, tetapkan olahan permukaan dan pencahayaan, sambil mengingati bahawa hasil ialah imej, bukannya mesh atau projek 3D boleh sunting.\n\nUntuk konsep ruang membaca, minta foto intim sudut membaca kecil, cahaya siang hangat, buku dan satu objek seramik, dengan susunan santai dan bukan seperti bilik pameran. Arahan ilustrasi terkawal pula boleh menamakan subjek grafik, hubungan warna dan olahan garisan. Nyatakan nisbah bidang dimaksudkan serta keputusan visual terpenting. Ini memudahkan penentuan sama ada butiran tidak dijangka merupakan tafsiran kreatif berguna atau sesuatu yang perlu berubah dalam arahan berikutnya.\n\nRujukan penjanaan membenarkan prompt sehingga 10,000 aksara, seed rawak, warna pilihan dan warna latar belakang dikehendaki, dengan satu hingga enam output. Imej rujukan pilihan atau gaya tersimpan serasi boleh menetapkan bahasa visual dengan padanan fleksibel atau tepat. Ia tidak diwajibkan untuk edisi V4.1 utama. Pilih rujukan bersih yang saling sepadan dan gunakan prompt untuk kandungan baharu; penghasilan semula warna rujukan tidak dijamin. 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\nV4.1 turut menyokong aliran imej-ke-imej berasingan dengan imej sedia ada, teks dan kekuatan 0 hingga 1. Operasi menggunakan kekuatan untuk mengawal tahap kedekatan imej baharu dengan sumber, dan tidak menerima kawalan gaya tersuai V4.1. Rujukan penjanaan semasa model mengecualikan negative_prompt, gaya yang dikurasi, text_layout, artistic_level dan no_text. Huraikan adegan dimaksudkan secara terus dan periksa aset hasil dalam susun atur sasaran, termasuk butiran, pemotongan dan sebarang tulisan, sebelum memilih arah visual untuk dikekalkan. 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": "929085bc4ad5ba67c7ee44e71ddf00c031a91c06b38b04cd4974d096eeb03598", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "recraft/recraft-v4.1Recraft V4.1 mencipta imej raster 1K dengan fotorealisme semula jadi, ilustrasi ekspresif dan komposisi disengajakan. Ia boleh membangunkan arah kreatif ringkas atau mengikuti arahan terperinci, dengan input imej dan gaya tersuai pilihan.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4.1 ialah model raster utama dalam keluarga V4.1 Recraft. Ia dibina untuk penciptaan imej ekspresif, termasuk foto kelihatan semula jadi, ilustrasi dan konsep visual berdimensi. Pengeluar memperkenalkannya sebagai model yang boleh membekalkan keputusan estetika daripada prompt ringkas sambil turut memberi respons kepada arah kreatif lebih terperinci. Gunakannya untuk penerokaan, pengkonsepan dan imej yang suasana, pencahayaan serta komposisinya menjadi sebahagian hasil tanpa terhad kepada pandangan hadapan produk mudah.
Kod tepat pengeluar ialah recraftv4_1. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan output segi empat sama 1024 × 1024 piksel dan 16:9 pada 1344 × 768. Nisbah disokong lain menggunakan dimensi sendiri. V4.1 Pro ialah edisi raster 2K berasingan, Vector mengembalikan SVG boleh sunting, dan Utility mengutamakan pencahayaan serta adegan lebih ringkas. Cabang ini menyediakan hasil berbeza dan tidak patut digabungkan menjadi satu set sifat output.
Pengeluar menonjolkan adegan fotografi lebih semula jadi, latar belakang lebih tenang, gradien lebih lancar dan julat ilustrasi luas. Contohnya termasuk tulisan ekspresif, ilustrasi watak rata dan helaian rujukan watak dilukis. Prompt ringkas boleh memberikan ruang tafsiran model; arahan terperinci boleh menetapkan subjek, pose, bahan, latar belakang dan komposisi. Untuk visual berdimensi, tetapkan olahan permukaan dan pencahayaan, sambil mengingati bahawa hasil ialah imej, bukannya mesh atau projek 3D boleh sunting.
Untuk konsep ruang membaca, minta foto intim sudut membaca kecil, cahaya siang hangat, buku dan satu objek seramik, dengan susunan santai dan bukan seperti bilik pameran. Arahan ilustrasi terkawal pula boleh menamakan subjek grafik, hubungan warna dan olahan garisan. Nyatakan nisbah bidang dimaksudkan serta keputusan visual terpenting. Ini memudahkan penentuan sama ada butiran tidak dijangka merupakan tafsiran kreatif berguna atau sesuatu yang perlu berubah dalam arahan berikutnya.
Rujukan penjanaan membenarkan prompt sehingga 10,000 aksara, seed rawak, warna pilihan dan warna latar belakang dikehendaki, dengan satu hingga enam output. Imej rujukan pilihan atau gaya tersimpan serasi boleh menetapkan bahasa visual dengan padanan fleksibel atau tepat. Ia tidak diwajibkan untuk edisi V4.1 utama. Pilih rujukan bersih yang saling sepadan dan gunakan prompt untuk kandungan baharu; penghasilan semula warna rujukan tidak dijamin. 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.
V4.1 turut menyokong aliran imej-ke-imej berasingan dengan imej sedia ada, teks dan kekuatan 0 hingga 1. Operasi menggunakan kekuatan untuk mengawal tahap kedekatan imej baharu dengan sumber, dan tidak menerima kawalan gaya tersuai V4.1. Rujukan penjanaan semasa model mengecualikan negative_prompt, gaya yang dikurasi, text_layout, artistic_level dan no_text. Huraikan adegan dimaksudkan secara terus dan periksa aset hasil dalam susun atur sasaran, termasuk butiran, pemotongan dan sebarang tulisan, sebelum memilih arah visual untuk dikekalkan. 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 | 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.07 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.07 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', '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
/v1/images