Recraft V4.1 Utility Pro ialah varian raster resolusi lebih tinggi cabang Utility dalam Recraft V4.1. Pengeluar membezakan persembahan mudah Utility daripada pilihan sudut, pencahayaan dan komposisi lebih ekspresif model V4.1 utama. Utility mengutamakan adegan ringkas, pencahayaan rata dan subjek menghadap hadapan. Oleh itu, ia sesuai untuk visual penyenaraian produk, mockup dan kerja lain yang objeknya perlu mudah difahami serta komposisi tenang membantu tugas.
Kod model tepat ialah recraftv4_1_utility_pro. Rujukan pengeluarnya menyenaraikan output raster 2K dengan butiran lebih halus, dalam WebP tanpa kehilangan atau PNG. Jadual saiz memberikan 2048 × 2048 piksel untuk imej segi empat sama dan 2432 × 1792 untuk 4:3, dengan nisbah bidang disokong lain menggunakan dimensi sendiri. Ini membezakan Utility Pro daripada output 1K Utility standard. Ia tidak menukar imej menjadi fail vektor boleh sunting; edisi Vector membekalkan SVG untuk tujuan itu.
Mulakan dengan arahan yang menamakan objek, bahan, sudut pandangan, latar belakang dan beberapa butiran yang mesti kelihatan. Untuk penyenaraian produk, minta balang simpanan seramik menghadap hadapan di atas permukaan neutral cerah, pencahayaan sekata, penutup tertutup dan ruang jelas di sekeliling siluet. Jika adegan mesti kekal mudah, nyatakannya secara eksplisit tanpa bergantung pada nama Utility untuk merangkumi semua pilihan persembahan. Untuk satu siri imej penyenaraian, kekalkan keperluan pembingkaian serta latar belakang sambil mengubah penerangan produk.
Rujukan penjanaan V4.1 menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersimpan serasi atau imej rujukan pilihan boleh memandu rupa; keluarga V4 Styles khusus ialah rangkaian berasingan yang sentiasa mewajibkan gaya. Untuk rujukan pilihan, gunakan aset jelas dengan arah visual sepadan. Penghasilan semula warna tepat daripada rujukan tidak dijamin, jadi keperluan warna jenama masih memerlukan arahan eksplisit serta semakan output. 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. Untuk penjanaan gaya rujukan, padanan fleksibel membenarkan tafsiran lebih longgar, sementara padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat.
Recraft turut mendokumenkan imej-ke-imej untuk rangkaian V4.1, menggabungkan imej sedia ada dengan prompt dan kekuatan 0 hingga 1. Kekuatan lebih rendah kekal lebih dekat dengan sumber dan nilai lebih tinggi membenarkan perubahan lebih besar. Ini berguna apabila komposisi permulaan atau subjek perlu mempengaruhi versi baharu. Ia tidak menerima kawalan gaya tersuai V4.1 dalam operasi transformasi sama. Had input imej pengeluarnya ialah di bawah 20 MB, sehingga 16 MP dan sisi antara 256 dan 4096 piksel.
Utility Pro berkongsi sekatan V4.1 terhadap kawalan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text. Berikan penerangan positif adegan dimaksudkan dan simpan kerja tulisan atau susun atur tepat untuk langkah kemasan sesuai apabila diperlukan. Semak visual produk dari segi bahan, bentuk dan butiran perlu yang diberikan sebelum menganggapnya aset penyenaraian setia. Hasil berguna ialah komposisi raster lebih besar yang disediakan untuk arahan produk atau mockup jelas, sementara fakta produk tepat kekal seperti diberikan dalam tugas.
", "aboutText": "Recraft V4.1 Utility Pro ialah varian raster resolusi lebih tinggi cabang Utility dalam Recraft V4.1. Pengeluar membezakan persembahan mudah Utility daripada pilihan sudut, pencahayaan dan komposisi lebih ekspresif model V4.1 utama. Utility mengutamakan adegan ringkas, pencahayaan rata dan subjek menghadap hadapan. Oleh itu, ia sesuai untuk visual penyenaraian produk, mockup dan kerja lain yang objeknya perlu mudah difahami serta komposisi tenang membantu tugas.\n\nKod model tepat ialah recraftv4_1_utility_pro. Rujukan pengeluarnya menyenaraikan output raster 2K dengan butiran lebih halus, dalam WebP tanpa kehilangan atau PNG. Jadual saiz memberikan 2048 × 2048 piksel untuk imej segi empat sama dan 2432 × 1792 untuk 4:3, dengan nisbah bidang disokong lain menggunakan dimensi sendiri. Ini membezakan Utility Pro daripada output 1K Utility standard. Ia tidak menukar imej menjadi fail vektor boleh sunting; edisi Vector membekalkan SVG untuk tujuan itu.\n\nMulakan dengan arahan yang menamakan objek, bahan, sudut pandangan, latar belakang dan beberapa butiran yang mesti kelihatan. Untuk penyenaraian produk, minta balang simpanan seramik menghadap hadapan di atas permukaan neutral cerah, pencahayaan sekata, penutup tertutup dan ruang jelas di sekeliling siluet. Jika adegan mesti kekal mudah, nyatakannya secara eksplisit tanpa bergantung pada nama Utility untuk merangkumi semua pilihan persembahan. Untuk satu siri imej penyenaraian, kekalkan keperluan pembingkaian serta latar belakang sambil mengubah penerangan produk.\n\nRujukan penjanaan V4.1 menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersimpan serasi atau imej rujukan pilihan boleh memandu rupa; keluarga V4 Styles khusus ialah rangkaian berasingan yang sentiasa mewajibkan gaya. Untuk rujukan pilihan, gunakan aset jelas dengan arah visual sepadan. Penghasilan semula warna tepat daripada rujukan tidak dijamin, jadi keperluan warna jenama masih memerlukan arahan eksplisit serta semakan output. 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. Untuk penjanaan gaya rujukan, padanan fleksibel membenarkan tafsiran lebih longgar, sementara padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat.\n\nRecraft turut mendokumenkan imej-ke-imej untuk rangkaian V4.1, menggabungkan imej sedia ada dengan prompt dan kekuatan 0 hingga 1. Kekuatan lebih rendah kekal lebih dekat dengan sumber dan nilai lebih tinggi membenarkan perubahan lebih besar. Ini berguna apabila komposisi permulaan atau subjek perlu mempengaruhi versi baharu. Ia tidak menerima kawalan gaya tersuai V4.1 dalam operasi transformasi sama. Had input imej pengeluarnya ialah di bawah 20 MB, sehingga 16 MP dan sisi antara 256 dan 4096 piksel.\n\nUtility Pro berkongsi sekatan V4.1 terhadap kawalan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text. Berikan penerangan positif adegan dimaksudkan dan simpan kerja tulisan atau susun atur tepat untuk langkah kemasan sesuai apabila diperlukan. Semak visual produk dari segi bahan, bentuk dan butiran perlu yang diberikan sebelum menganggapnya aset penyenaraian setia. Hasil berguna ialah komposisi raster lebih besar yang disediakan untuk arahan produk atau mockup jelas, sementara fakta produk tepat kekal seperti diberikan dalam tugas.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2d2471f4cfb50dafab6e5a665844cab81fb04dcf2feeb43b26f443b3e3a0ebf8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "recraft/recraft-v4.1-utility-proRecraft V4.1 Utility Pro menjana imej raster 2K dengan fokus pada adegan ringkas yang boleh dijangka, pencahayaan rata dan komposisi pandangan hadapan. Ia sesuai untuk syot produk terperinci dan mockup yang memerlukan persembahan jelas berbanding arah seni ekspresif.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4.1 Utility Pro ialah varian raster resolusi lebih tinggi cabang Utility dalam Recraft V4.1. Pengeluar membezakan persembahan mudah Utility daripada pilihan sudut, pencahayaan dan komposisi lebih ekspresif model V4.1 utama. Utility mengutamakan adegan ringkas, pencahayaan rata dan subjek menghadap hadapan. Oleh itu, ia sesuai untuk visual penyenaraian produk, mockup dan kerja lain yang objeknya perlu mudah difahami serta komposisi tenang membantu tugas.
Kod model tepat ialah recraftv4_1_utility_pro. Rujukan pengeluarnya menyenaraikan output raster 2K dengan butiran lebih halus, dalam WebP tanpa kehilangan atau PNG. Jadual saiz memberikan 2048 × 2048 piksel untuk imej segi empat sama dan 2432 × 1792 untuk 4:3, dengan nisbah bidang disokong lain menggunakan dimensi sendiri. Ini membezakan Utility Pro daripada output 1K Utility standard. Ia tidak menukar imej menjadi fail vektor boleh sunting; edisi Vector membekalkan SVG untuk tujuan itu.
Mulakan dengan arahan yang menamakan objek, bahan, sudut pandangan, latar belakang dan beberapa butiran yang mesti kelihatan. Untuk penyenaraian produk, minta balang simpanan seramik menghadap hadapan di atas permukaan neutral cerah, pencahayaan sekata, penutup tertutup dan ruang jelas di sekeliling siluet. Jika adegan mesti kekal mudah, nyatakannya secara eksplisit tanpa bergantung pada nama Utility untuk merangkumi semua pilihan persembahan. Untuk satu siri imej penyenaraian, kekalkan keperluan pembingkaian serta latar belakang sambil mengubah penerangan produk.
Rujukan penjanaan V4.1 menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersimpan serasi atau imej rujukan pilihan boleh memandu rupa; keluarga V4 Styles khusus ialah rangkaian berasingan yang sentiasa mewajibkan gaya. Untuk rujukan pilihan, gunakan aset jelas dengan arah visual sepadan. Penghasilan semula warna tepat daripada rujukan tidak dijamin, jadi keperluan warna jenama masih memerlukan arahan eksplisit serta semakan output. 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. Untuk penjanaan gaya rujukan, padanan fleksibel membenarkan tafsiran lebih longgar, sementara padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat.
Recraft turut mendokumenkan imej-ke-imej untuk rangkaian V4.1, menggabungkan imej sedia ada dengan prompt dan kekuatan 0 hingga 1. Kekuatan lebih rendah kekal lebih dekat dengan sumber dan nilai lebih tinggi membenarkan perubahan lebih besar. Ini berguna apabila komposisi permulaan atau subjek perlu mempengaruhi versi baharu. Ia tidak menerima kawalan gaya tersuai V4.1 dalam operasi transformasi sama. Had input imej pengeluarnya ialah di bawah 20 MB, sehingga 16 MP dan sisi antara 256 dan 4096 piksel.
Utility Pro berkongsi sekatan V4.1 terhadap kawalan negative_prompt, nama gaya yang dikurasi, text_layout, artistic_level dan no_text. Berikan penerangan positif adegan dimaksudkan dan simpan kerja tulisan atau susun atur tepat untuk langkah kemasan sesuai apabila diperlukan. Semak visual produk dari segi bahan, bentuk dan butiran perlu yang diberikan sebelum menganggapnya aset penyenaraian setia. Hasil berguna ialah komposisi raster lebih besar yang disediakan untuk arahan produk atau mockup jelas, sementara fakta produk tepat kekal seperti diberikan dalam tugas.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had recraft/recraft-v4.1-utility-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-utility-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-utility-pro
/v1/images