Recraft V4.1 Utility adalah model Utility raster standar dalam keluarga V4.1 Recraft. Model mengutamakan adegan sederhana, pencahayaan merata, dan komposisi menghadap depan dibanding pilihan sudut, cahaya, serta suasana yang lebih ekspresif dari model V4.1 utama. Peran praktisnya adalah shot produk atau mockup jelas dengan objek dan detail penting mendominasi. Edisi Utility yang tepat ini terpisah dari Utility Pro, model V4.1 utama, dan varian vektor penghasil SVG.
Kode model produsen adalah recraftv4_1_utility. Model mengembalikan gambar raster 1K dalam WebP lossless atau PNG, dengan ukuran dipilih dari rasio aspek yang didukung. Gambar persegi berukuran 1024 × 1024 piksel dan gambar 4:3 berukuran 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, sehingga ukuran keluaran itu tidak boleh diterapkan pada Utility standar. Pilih bentuk listing atau mockup yang dimaksud sebelum menjelaskan adegan.
Brief berguna menyebut produk, sudut pandang, material, permukaan, latar, dan pencahayaan dengan istilah sederhana. Untuk listing produk, minta botol berinsulasi menghadap depan pada latar pucat, dengan cahaya merata, seluruh siluet terlihat, dan tanpa elemen adegan mengganggu. Jika produk mempunyai dimensi faktual atau bagian khas, berikan detail itu secara eksplisit. Kecenderungan Utility pada penyajian sederhana tidak menetapkan fakta tentang produk nyata yang tidak ada dalam brief.
Generasi mendukung prompt hingga 10.000 karakter, kendali warna pilihan dan warna latar, seed acak, serta satu hingga enam keluaran. Gaya khusus kompatibel atau gambar referensi opsional dapat memandu bahasa visual katalog. Gunakan aset referensi yang selaras dalam pencahayaan dan rendering, lalu pertahankan gaya kompatibel yang sama untuk brief produk berikutnya. Kecocokan warna tepat antara referensi dan keluaran tidak dijamin, sehingga bandingkan visual akhir dengan palet wajib. Untuk generasi bergaya referensi, gunakan satu hingga sepuluh gambar PNG, JPG, atau WebP, total tidak lebih dari 64 MB dan masing-masing di bawah 20 MB. Setiap referensi memerlukan sisi terpendek minimal 256 piksel, sisi terpanjang maksimal 4.096 piksel, dan resolusi maksimal 16 megapiksel. Gunakan referensi ini atau gaya tersimpan kompatibel, bukan keduanya. Untuk generasi bergaya referensi, pencocokan fleksibel mengizinkan penafsiran lebih longgar, sementara pencocokan presisi mengikuti rendering, palet, komposisi, dan pencahayaan lebih dekat.
Alur gambar ke gambar terpisah menggunakan gambar yang sudah ada dan prompt, dengan strength 0 hingga 1 mengendalikan tingkat perubahan. Strength lebih rendah menjaga hasil lebih dekat pada sumber; lebih tinggi mengizinkannya menjauh lebih banyak. Masukan dapat berupa PNG, JPG, WebP, atau SVG di bawah 20 MB, hingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya khusus V4.1 tidak diterima dalam operasi transformasi tersebut, yang berbeda dari melampirkan referensi gaya pada generasi baru.
V4.1 Utility tidak menerima nama gaya kurasi, negative_prompt, text_layout, artistic_level, atau kendali no_text. Berikan adegan akhir yang diinginkan langsung dalam prompt positif. Untuk seri aset produk, pertahankan instruksi pembingkaian serta latar, lalu bandingkan setiap gambar dengan bentuk, material, dan detail produk yang diberikan sebelum menggunakannya dalam tata letak. Utility standar merupakan alat raster terarah untuk penyajian sederhana; pilih format keluaran dan edisi tertentu yang sesuai dengan tugas.
", "aboutText": "Recraft V4.1 Utility adalah model Utility raster standar dalam keluarga V4.1 Recraft. Model mengutamakan adegan sederhana, pencahayaan merata, dan komposisi menghadap depan dibanding pilihan sudut, cahaya, serta suasana yang lebih ekspresif dari model V4.1 utama. Peran praktisnya adalah shot produk atau mockup jelas dengan objek dan detail penting mendominasi. Edisi Utility yang tepat ini terpisah dari Utility Pro, model V4.1 utama, dan varian vektor penghasil SVG.\n\nKode model produsen adalah recraftv4_1_utility. Model mengembalikan gambar raster 1K dalam WebP lossless atau PNG, dengan ukuran dipilih dari rasio aspek yang didukung. Gambar persegi berukuran 1024 × 1024 piksel dan gambar 4:3 berukuran 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, sehingga ukuran keluaran itu tidak boleh diterapkan pada Utility standar. Pilih bentuk listing atau mockup yang dimaksud sebelum menjelaskan adegan.\n\nBrief berguna menyebut produk, sudut pandang, material, permukaan, latar, dan pencahayaan dengan istilah sederhana. Untuk listing produk, minta botol berinsulasi menghadap depan pada latar pucat, dengan cahaya merata, seluruh siluet terlihat, dan tanpa elemen adegan mengganggu. Jika produk mempunyai dimensi faktual atau bagian khas, berikan detail itu secara eksplisit. Kecenderungan Utility pada penyajian sederhana tidak menetapkan fakta tentang produk nyata yang tidak ada dalam brief.\n\nGenerasi mendukung prompt hingga 10.000 karakter, kendali warna pilihan dan warna latar, seed acak, serta satu hingga enam keluaran. Gaya khusus kompatibel atau gambar referensi opsional dapat memandu bahasa visual katalog. Gunakan aset referensi yang selaras dalam pencahayaan dan rendering, lalu pertahankan gaya kompatibel yang sama untuk brief produk berikutnya. Kecocokan warna tepat antara referensi dan keluaran tidak dijamin, sehingga bandingkan visual akhir dengan palet wajib. Untuk generasi bergaya referensi, gunakan satu hingga sepuluh gambar PNG, JPG, atau WebP, total tidak lebih dari 64 MB dan masing-masing di bawah 20 MB. Setiap referensi memerlukan sisi terpendek minimal 256 piksel, sisi terpanjang maksimal 4.096 piksel, dan resolusi maksimal 16 megapiksel. Gunakan referensi ini atau gaya tersimpan kompatibel, bukan keduanya. Untuk generasi bergaya referensi, pencocokan fleksibel mengizinkan penafsiran lebih longgar, sementara pencocokan presisi mengikuti rendering, palet, komposisi, dan pencahayaan lebih dekat.\n\nAlur gambar ke gambar terpisah menggunakan gambar yang sudah ada dan prompt, dengan strength 0 hingga 1 mengendalikan tingkat perubahan. Strength lebih rendah menjaga hasil lebih dekat pada sumber; lebih tinggi mengizinkannya menjauh lebih banyak. Masukan dapat berupa PNG, JPG, WebP, atau SVG di bawah 20 MB, hingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya khusus V4.1 tidak diterima dalam operasi transformasi tersebut, yang berbeda dari melampirkan referensi gaya pada generasi baru.\n\nV4.1 Utility tidak menerima nama gaya kurasi, negative_prompt, text_layout, artistic_level, atau kendali no_text. Berikan adegan akhir yang diinginkan langsung dalam prompt positif. Untuk seri aset produk, pertahankan instruksi pembingkaian serta latar, lalu bandingkan setiap gambar dengan bentuk, material, dan detail produk yang diberikan sebelum menggunakannya dalam tata letak. Utility standar merupakan alat raster terarah untuk penyajian sederhana; pilih format keluaran dan edisi tertentu yang sesuai dengan tugas.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c4ca05facdfd75440b30dd10b87cd7de0983375fec67eeb65bb4932f90dfd242", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "recraft/recraft-v4.1-utilityRecraft V4.1 Utility menghasilkan gambar raster 1K untuk shot produk sederhana, mockup, dan adegan ringkas. Model mengutamakan pencahayaan merata dan komposisi menghadap depan, dengan prompt teks serta masukan gambar atau gaya opsional untuk arah visual yang dapat diprediksi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Recraft V4.1 Utility adalah model Utility raster standar dalam keluarga V4.1 Recraft. Model mengutamakan adegan sederhana, pencahayaan merata, dan komposisi menghadap depan dibanding pilihan sudut, cahaya, serta suasana yang lebih ekspresif dari model V4.1 utama. Peran praktisnya adalah shot produk atau mockup jelas dengan objek dan detail penting mendominasi. Edisi Utility yang tepat ini terpisah dari Utility Pro, model V4.1 utama, dan varian vektor penghasil SVG.
Kode model produsen adalah recraftv4_1_utility. Model mengembalikan gambar raster 1K dalam WebP lossless atau PNG, dengan ukuran dipilih dari rasio aspek yang didukung. Gambar persegi berukuran 1024 × 1024 piksel dan gambar 4:3 berukuran 1216 × 896. Edisi Pro Utility menggunakan dimensi 2K lebih besar, sehingga ukuran keluaran itu tidak boleh diterapkan pada Utility standar. Pilih bentuk listing atau mockup yang dimaksud sebelum menjelaskan adegan.
Brief berguna menyebut produk, sudut pandang, material, permukaan, latar, dan pencahayaan dengan istilah sederhana. Untuk listing produk, minta botol berinsulasi menghadap depan pada latar pucat, dengan cahaya merata, seluruh siluet terlihat, dan tanpa elemen adegan mengganggu. Jika produk mempunyai dimensi faktual atau bagian khas, berikan detail itu secara eksplisit. Kecenderungan Utility pada penyajian sederhana tidak menetapkan fakta tentang produk nyata yang tidak ada dalam brief.
Generasi mendukung prompt hingga 10.000 karakter, kendali warna pilihan dan warna latar, seed acak, serta satu hingga enam keluaran. Gaya khusus kompatibel atau gambar referensi opsional dapat memandu bahasa visual katalog. Gunakan aset referensi yang selaras dalam pencahayaan dan rendering, lalu pertahankan gaya kompatibel yang sama untuk brief produk berikutnya. Kecocokan warna tepat antara referensi dan keluaran tidak dijamin, sehingga bandingkan visual akhir dengan palet wajib. Untuk generasi bergaya referensi, gunakan satu hingga sepuluh gambar PNG, JPG, atau WebP, total tidak lebih dari 64 MB dan masing-masing di bawah 20 MB. Setiap referensi memerlukan sisi terpendek minimal 256 piksel, sisi terpanjang maksimal 4.096 piksel, dan resolusi maksimal 16 megapiksel. Gunakan referensi ini atau gaya tersimpan kompatibel, bukan keduanya. Untuk generasi bergaya referensi, pencocokan fleksibel mengizinkan penafsiran lebih longgar, sementara pencocokan presisi mengikuti rendering, palet, komposisi, dan pencahayaan lebih dekat.
Alur gambar ke gambar terpisah menggunakan gambar yang sudah ada dan prompt, dengan strength 0 hingga 1 mengendalikan tingkat perubahan. Strength lebih rendah menjaga hasil lebih dekat pada sumber; lebih tinggi mengizinkannya menjauh lebih banyak. Masukan dapat berupa PNG, JPG, WebP, atau SVG di bawah 20 MB, hingga 16 MP, dengan sisi antara 256 dan 4096 piksel. Gaya khusus V4.1 tidak diterima dalam operasi transformasi tersebut, yang berbeda dari melampirkan referensi gaya pada generasi baru.
V4.1 Utility tidak menerima nama gaya kurasi, negative_prompt, text_layout, artistic_level, atau kendali no_text. Berikan adegan akhir yang diinginkan langsung dalam prompt positif. Untuk seri aset produk, pertahankan instruksi pembingkaian serta latar, lalu bandingkan setiap gambar dengan bentuk, material, dan detail produk yang diberikan sebelum menggunakannya dalam tata letak. Utility standar merupakan alat raster terarah untuk penyajian sederhana; pilih format keluaran dan edisi tertentu yang sesuai dengan tugas.
POST /v1/images/generationstext, imageimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan recraft/recraft-v4.1-utility | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 4:3, 3:4, 16:9, 9:16, auto | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 6 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 1 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| Konfigurasigambar keluaran | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper gambar keluaran | Biaya Keluaran · gambar keluaran · Perkiraan hanya untuk perbandingan $0.07 per gambar keluaran |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.07 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
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\nUnduh setiap gambar yang dikembalikan atau simpan konten 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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Ailoot Ultra recraft/recraft-v4.1-utility
/v1/images