Recraft V4.1 Utility ialah model Utility raster standard dalam keluarga V4.1 Recraft. Ia mengutamakan adegan ringkas, pencahayaan rata dan komposisi pandangan hadapan berbanding pilihan sudut, cahaya dan suasana lebih ekspresif model V4.1 utama. Peranan praktikalnya ialah syot produk atau mockup jelas yang menonjolkan objek serta butiran diperlukan. Edisi Utility tepat ini berasingan daripada Utility Pro, model V4.1 utama dan varian vektor yang menghasilkan SVG.
Kod model pengeluar ialah recraftv4_1_utility. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan saiz dipilih daripada nisbah bidang disokong. Imej segi empat sama ialah 1024 × 1024 piksel dan imej 4:3 ialah 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, jadi saiz output itu tidak patut diberikan kepada Utility standard. Pilih bentuk penyenaraian atau mockup dimaksudkan sebelum menghuraikan adegan.
Arahan berguna menamakan produk, sudut pandangan, bahan, permukaan, latar belakang dan pencahayaan secara mudah. Untuk penyenaraian produk, minta botol berpenebat menghadap hadapan pada latar pucat, bercahaya sekata, dengan seluruh siluet kelihatan dan tanpa unsur adegan mengganggu. Jika produk mempunyai dimensi sebenar atau bahagian tersendiri, berikan butiran itu secara eksplisit. Keutamaan Utility terhadap persembahan mudah tidak menetapkan fakta produk sebenar yang tiada dalam arahan.
Penjanaan menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersuai serasi atau imej rujukan pilihan boleh memandu bahasa visual katalog. Gunakan aset rujukan yang sepadan dalam pencahayaan dan pemaparan, serta kekalkan gaya serasi sama untuk arahan produk berikutnya. Padanan warna tepat antara rujukan dan output tidak dijamin, jadi bandingkan visual akhir dengan palet diperlukan. 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.
Aliran imej-ke-imej berasingan menggunakan imej sedia ada dan prompt, dengan kekuatan 0 hingga 1 mengawal tahap perubahan. Kekuatan lebih rendah mengekalkan hasil lebih dekat dengan sumber; kekuatan lebih tinggi membolehkannya menyimpang lebih jauh. Inputnya boleh berupa PNG, JPG, WebP atau SVG di bawah 20 MB, sehingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya tersuai V4.1 tidak diterima dalam operasi transformasi itu, yang berbeza daripada melampirkan rujukan gaya pada penjanaan baharu.
V4.1 Utility tidak menerima nama gaya yang dikurasi, negative_prompt, text_layout, artistic_level atau kawalan no_text. Berikan adegan siap dikehendaki secara terus dalam prompt positif. Untuk satu siri aset produk, kekalkan arahan pembingkaian dan latar belakang, kemudian bandingkan setiap imej dengan bentuk, bahan dan butiran produk yang diberikan sebelum menggunakannya dalam susun atur. Utility standard ialah alat raster terarah untuk persembahan terkawal; pilih format output dan edisi khusus yang sepadan dengan tugas.
", "aboutText": "Recraft V4.1 Utility ialah model Utility raster standard dalam keluarga V4.1 Recraft. Ia mengutamakan adegan ringkas, pencahayaan rata dan komposisi pandangan hadapan berbanding pilihan sudut, cahaya dan suasana lebih ekspresif model V4.1 utama. Peranan praktikalnya ialah syot produk atau mockup jelas yang menonjolkan objek serta butiran diperlukan. Edisi Utility tepat ini berasingan daripada Utility Pro, model V4.1 utama dan varian vektor yang menghasilkan SVG.\n\nKod model pengeluar ialah recraftv4_1_utility. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan saiz dipilih daripada nisbah bidang disokong. Imej segi empat sama ialah 1024 × 1024 piksel dan imej 4:3 ialah 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, jadi saiz output itu tidak patut diberikan kepada Utility standard. Pilih bentuk penyenaraian atau mockup dimaksudkan sebelum menghuraikan adegan.\n\nArahan berguna menamakan produk, sudut pandangan, bahan, permukaan, latar belakang dan pencahayaan secara mudah. Untuk penyenaraian produk, minta botol berpenebat menghadap hadapan pada latar pucat, bercahaya sekata, dengan seluruh siluet kelihatan dan tanpa unsur adegan mengganggu. Jika produk mempunyai dimensi sebenar atau bahagian tersendiri, berikan butiran itu secara eksplisit. Keutamaan Utility terhadap persembahan mudah tidak menetapkan fakta produk sebenar yang tiada dalam arahan.\n\nPenjanaan menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersuai serasi atau imej rujukan pilihan boleh memandu bahasa visual katalog. Gunakan aset rujukan yang sepadan dalam pencahayaan dan pemaparan, serta kekalkan gaya serasi sama untuk arahan produk berikutnya. Padanan warna tepat antara rujukan dan output tidak dijamin, jadi bandingkan visual akhir dengan palet diperlukan. 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\nAliran imej-ke-imej berasingan menggunakan imej sedia ada dan prompt, dengan kekuatan 0 hingga 1 mengawal tahap perubahan. Kekuatan lebih rendah mengekalkan hasil lebih dekat dengan sumber; kekuatan lebih tinggi membolehkannya menyimpang lebih jauh. Inputnya boleh berupa PNG, JPG, WebP atau SVG di bawah 20 MB, sehingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya tersuai V4.1 tidak diterima dalam operasi transformasi itu, yang berbeza daripada melampirkan rujukan gaya pada penjanaan baharu.\n\nV4.1 Utility tidak menerima nama gaya yang dikurasi, negative_prompt, text_layout, artistic_level atau kawalan no_text. Berikan adegan siap dikehendaki secara terus dalam prompt positif. Untuk satu siri aset produk, kekalkan arahan pembingkaian dan latar belakang, kemudian bandingkan setiap imej dengan bentuk, bahan dan butiran produk yang diberikan sebelum menggunakannya dalam susun atur. Utility standard ialah alat raster terarah untuk persembahan terkawal; pilih format output dan edisi khusus yang sepadan dengan tugas.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6627ac3702f4ee80c387c049cae693b3669a1f04017b2eee0f76af06bd1a27af", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility menjana imej raster 1K untuk syot produk, mockup dan adegan ringkas yang mudah. Ia mengutamakan pencahayaan rata dan komposisi pandangan hadapan, dengan prompt teks serta input imej atau gaya pilihan untuk arah visual yang boleh dijangka.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4.1 Utility ialah model Utility raster standard dalam keluarga V4.1 Recraft. Ia mengutamakan adegan ringkas, pencahayaan rata dan komposisi pandangan hadapan berbanding pilihan sudut, cahaya dan suasana lebih ekspresif model V4.1 utama. Peranan praktikalnya ialah syot produk atau mockup jelas yang menonjolkan objek serta butiran diperlukan. Edisi Utility tepat ini berasingan daripada Utility Pro, model V4.1 utama dan varian vektor yang menghasilkan SVG.
Kod model pengeluar ialah recraftv4_1_utility. Ia mengembalikan imej raster 1K dalam WebP tanpa kehilangan atau PNG, dengan saiz dipilih daripada nisbah bidang disokong. Imej segi empat sama ialah 1024 × 1024 piksel dan imej 4:3 ialah 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, jadi saiz output itu tidak patut diberikan kepada Utility standard. Pilih bentuk penyenaraian atau mockup dimaksudkan sebelum menghuraikan adegan.
Arahan berguna menamakan produk, sudut pandangan, bahan, permukaan, latar belakang dan pencahayaan secara mudah. Untuk penyenaraian produk, minta botol berpenebat menghadap hadapan pada latar pucat, bercahaya sekata, dengan seluruh siluet kelihatan dan tanpa unsur adegan mengganggu. Jika produk mempunyai dimensi sebenar atau bahagian tersendiri, berikan butiran itu secara eksplisit. Keutamaan Utility terhadap persembahan mudah tidak menetapkan fakta produk sebenar yang tiada dalam arahan.
Penjanaan menyokong prompt sehingga 10,000 aksara, kawalan warna pilihan dan warna latar belakang, seed rawak serta satu hingga enam output. Gaya tersuai serasi atau imej rujukan pilihan boleh memandu bahasa visual katalog. Gunakan aset rujukan yang sepadan dalam pencahayaan dan pemaparan, serta kekalkan gaya serasi sama untuk arahan produk berikutnya. Padanan warna tepat antara rujukan dan output tidak dijamin, jadi bandingkan visual akhir dengan palet diperlukan. 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.
Aliran imej-ke-imej berasingan menggunakan imej sedia ada dan prompt, dengan kekuatan 0 hingga 1 mengawal tahap perubahan. Kekuatan lebih rendah mengekalkan hasil lebih dekat dengan sumber; kekuatan lebih tinggi membolehkannya menyimpang lebih jauh. Inputnya boleh berupa PNG, JPG, WebP atau SVG di bawah 20 MB, sehingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya tersuai V4.1 tidak diterima dalam operasi transformasi itu, yang berbeza daripada melampirkan rujukan gaya pada penjanaan baharu.
V4.1 Utility tidak menerima nama gaya yang dikurasi, negative_prompt, text_layout, artistic_level atau kawalan no_text. Berikan adegan siap dikehendaki secara terus dalam prompt positif. Untuk satu siri aset produk, kekalkan arahan pembingkaian dan latar belakang, kemudian bandingkan setiap imej dengan bentuk, bahan dan butiran produk yang diberikan sebelum menggunakannya dalam susun atur. Utility standard ialah alat raster terarah untuk persembahan terkawal; pilih format output dan edisi khusus yang sepadan dengan tugas.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had recraft/recraft-v4.1-utility | 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-utility', '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
/v1/images