Recraft V4 Styles Pro ialah model raster resolusi lebih tinggi dalam keluarga V4 Styles khusus Recraft. Ia mencipta imej baharu daripada arahan teks dan gaya visual yang diberikan melalui imej rujukan atau gaya tersimpan. Model ditujukan untuk kempen, ilustrasi jenama dan set imej lain yang pemaparan, tekstur serta sifat komposisinya perlu berterusan daripada satu aset ke aset seterusnya. Ia berasingan daripada Recraft V4 Pro dan V4.1 Pro, yang input gayanya pilihan dan bukan keperluan penentu model.
Styles Pro menghasilkan output raster 2K, dengan format WebP tanpa kehilangan atau PNG. Output segi empat sama dalam jadual saiz pengeluar ialah 2048 × 2048 piksel, sementara output 16:9 ialah 2688 × 1536; nisbah disokong lain mempunyai dimensi sendiri. Output lebih besar Pro boleh berguna untuk visual kempen terperinci dan susun atur lebih besar. Varian vektor pula menghasilkan SVG dan tiada saiz piksel tetap, jadi edisi Pro raster ini tidak patut dipilih apabila hasil dimaksudkan ialah fail vektor boleh sunting.
Setiap penjanaan dalam keluarga Styles memerlukan gaya. Berikan satu hingga sepuluh imej rujukan PNG, JPG atau WebP, atau gunakan semula gaya tersimpan serasi; pengecam gaya dan rujukan baharu ialah input alternatif, bukannya pasangan untuk digabungkan. Aliran pengeluar membenarkan jumlah rujukan sehingga 64 MB, dengan setiap fail di bawah 20 MB. Penciptaan gaya tidak memerlukan langkah latihan yang dijalankan pengguna. Satu rujukan jelas boleh menetapkan arah padu, dan beberapa rujukan membantu apabila semuanya sudah berkongsi bahasa visual sama tanpa rupa bersaing. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.
Padanan gaya fleksibel ialah lalai dan membenarkan tafsiran rujukan lebih longgar. Padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat. Rujukan menentukan bahasa visual; arahan teks masih perlu menghuraikan subjek baharu, tindakan, adegan dan pembingkaian. Untuk kempen produk terperinci, tetapkan botol kaca di atas permukaan batu pucat, pandangan tiga suku, cahaya sisi lembut dan ruang jelas untuk tajuk, sementara rujukan yang diberikan membawa olahan fotografi.
Model menerima prompt sehingga 10,000 aksara, menyokong warna pilihan dan warna latar belakang dikehendaki, serta boleh menggunakan seed rawak. Aliran penjanaan yang didokumenkan boleh mengembalikan satu hingga enam imej. Kawalan bergunanya berbeza daripada edisi Recraft lama: nama gaya yang dikurasi, negative_prompt dan text_layout tidak disokong, dan keluarga Styles tidak menyediakan imej-ke-imej atau inpainting. Rujukan ialah sumber gaya, bukan topeng atau arahan mengekalkan foto sedia ada piksel demi piksel.
Sediakan aset rujukan bersih yang cukup terperinci dan gunakan semula gaya sama ketika membangunkan set. Jika output menjadi berulang, ubah subjek, pose, sudut kamera atau adegan dalam arahan teks tanpa menambah rujukan tidak berkaitan. Padanan warna tepat antara rujukan dan output tidak dijamin; kawalan warna pilihan menyatakan arah, bukannya hasil pembuktian warna. Untuk aset kempen akhir, nilai imej pada saiz paparan atau cetakan dimaksudkan dan semak sama ada subjek, ruang kosong berguna serta olahan visual sepadan dengan arahan.
", "aboutText": "Recraft V4 Styles Pro ialah model raster resolusi lebih tinggi dalam keluarga V4 Styles khusus Recraft. Ia mencipta imej baharu daripada arahan teks dan gaya visual yang diberikan melalui imej rujukan atau gaya tersimpan. Model ditujukan untuk kempen, ilustrasi jenama dan set imej lain yang pemaparan, tekstur serta sifat komposisinya perlu berterusan daripada satu aset ke aset seterusnya. Ia berasingan daripada Recraft V4 Pro dan V4.1 Pro, yang input gayanya pilihan dan bukan keperluan penentu model.\n\nStyles Pro menghasilkan output raster 2K, dengan format WebP tanpa kehilangan atau PNG. Output segi empat sama dalam jadual saiz pengeluar ialah 2048 × 2048 piksel, sementara output 16:9 ialah 2688 × 1536; nisbah disokong lain mempunyai dimensi sendiri. Output lebih besar Pro boleh berguna untuk visual kempen terperinci dan susun atur lebih besar. Varian vektor pula menghasilkan SVG dan tiada saiz piksel tetap, jadi edisi Pro raster ini tidak patut dipilih apabila hasil dimaksudkan ialah fail vektor boleh sunting.\n\nSetiap penjanaan dalam keluarga Styles memerlukan gaya. Berikan satu hingga sepuluh imej rujukan PNG, JPG atau WebP, atau gunakan semula gaya tersimpan serasi; pengecam gaya dan rujukan baharu ialah input alternatif, bukannya pasangan untuk digabungkan. Aliran pengeluar membenarkan jumlah rujukan sehingga 64 MB, dengan setiap fail di bawah 20 MB. Penciptaan gaya tidak memerlukan langkah latihan yang dijalankan pengguna. Satu rujukan jelas boleh menetapkan arah padu, dan beberapa rujukan membantu apabila semuanya sudah berkongsi bahasa visual sama tanpa rupa bersaing. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.\n\nPadanan gaya fleksibel ialah lalai dan membenarkan tafsiran rujukan lebih longgar. Padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat. Rujukan menentukan bahasa visual; arahan teks masih perlu menghuraikan subjek baharu, tindakan, adegan dan pembingkaian. Untuk kempen produk terperinci, tetapkan botol kaca di atas permukaan batu pucat, pandangan tiga suku, cahaya sisi lembut dan ruang jelas untuk tajuk, sementara rujukan yang diberikan membawa olahan fotografi.\n\nModel menerima prompt sehingga 10,000 aksara, menyokong warna pilihan dan warna latar belakang dikehendaki, serta boleh menggunakan seed rawak. Aliran penjanaan yang didokumenkan boleh mengembalikan satu hingga enam imej. Kawalan bergunanya berbeza daripada edisi Recraft lama: nama gaya yang dikurasi, negative_prompt dan text_layout tidak disokong, dan keluarga Styles tidak menyediakan imej-ke-imej atau inpainting. Rujukan ialah sumber gaya, bukan topeng atau arahan mengekalkan foto sedia ada piksel demi piksel.\n\nSediakan aset rujukan bersih yang cukup terperinci dan gunakan semula gaya sama ketika membangunkan set. Jika output menjadi berulang, ubah subjek, pose, sudut kamera atau adegan dalam arahan teks tanpa menambah rujukan tidak berkaitan. Padanan warna tepat antara rujukan dan output tidak dijamin; kawalan warna pilihan menyatakan arah, bukannya hasil pembuktian warna. Untuk aset kempen akhir, nilai imej pada saiz paparan atau cetakan dimaksudkan dan semak sama ada subjek, ruang kosong berguna serta olahan visual sepadan dengan arahan.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2ee3ad27d22aa55ff1822e44f265b88ba81159a9ca15c2355a7b6a8eb1f3cb2b", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "recraft/recraft-v4-styles-proRecraft V4 Styles Pro menjana imej raster 2K dalam gaya visual ditentukan rujukan. Ia direka untuk aset kempen terperinci dan set imej yang tekstur, pemaparan, palet serta rupa keseluruhannya perlu konsisten ketika subjek berubah.
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Recraft V4 Styles Pro ialah model raster resolusi lebih tinggi dalam keluarga V4 Styles khusus Recraft. Ia mencipta imej baharu daripada arahan teks dan gaya visual yang diberikan melalui imej rujukan atau gaya tersimpan. Model ditujukan untuk kempen, ilustrasi jenama dan set imej lain yang pemaparan, tekstur serta sifat komposisinya perlu berterusan daripada satu aset ke aset seterusnya. Ia berasingan daripada Recraft V4 Pro dan V4.1 Pro, yang input gayanya pilihan dan bukan keperluan penentu model.
Styles Pro menghasilkan output raster 2K, dengan format WebP tanpa kehilangan atau PNG. Output segi empat sama dalam jadual saiz pengeluar ialah 2048 × 2048 piksel, sementara output 16:9 ialah 2688 × 1536; nisbah disokong lain mempunyai dimensi sendiri. Output lebih besar Pro boleh berguna untuk visual kempen terperinci dan susun atur lebih besar. Varian vektor pula menghasilkan SVG dan tiada saiz piksel tetap, jadi edisi Pro raster ini tidak patut dipilih apabila hasil dimaksudkan ialah fail vektor boleh sunting.
Setiap penjanaan dalam keluarga Styles memerlukan gaya. Berikan satu hingga sepuluh imej rujukan PNG, JPG atau WebP, atau gunakan semula gaya tersimpan serasi; pengecam gaya dan rujukan baharu ialah input alternatif, bukannya pasangan untuk digabungkan. Aliran pengeluar membenarkan jumlah rujukan sehingga 64 MB, dengan setiap fail di bawah 20 MB. Penciptaan gaya tidak memerlukan langkah latihan yang dijalankan pengguna. Satu rujukan jelas boleh menetapkan arah padu, dan beberapa rujukan membantu apabila semuanya sudah berkongsi bahasa visual sama tanpa rupa bersaing. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.
Padanan gaya fleksibel ialah lalai dan membenarkan tafsiran rujukan lebih longgar. Padanan tepat mengikuti pemaparan, palet, komposisi dan pencahayaan dengan lebih rapat. Rujukan menentukan bahasa visual; arahan teks masih perlu menghuraikan subjek baharu, tindakan, adegan dan pembingkaian. Untuk kempen produk terperinci, tetapkan botol kaca di atas permukaan batu pucat, pandangan tiga suku, cahaya sisi lembut dan ruang jelas untuk tajuk, sementara rujukan yang diberikan membawa olahan fotografi.
Model menerima prompt sehingga 10,000 aksara, menyokong warna pilihan dan warna latar belakang dikehendaki, serta boleh menggunakan seed rawak. Aliran penjanaan yang didokumenkan boleh mengembalikan satu hingga enam imej. Kawalan bergunanya berbeza daripada edisi Recraft lama: nama gaya yang dikurasi, negative_prompt dan text_layout tidak disokong, dan keluarga Styles tidak menyediakan imej-ke-imej atau inpainting. Rujukan ialah sumber gaya, bukan topeng atau arahan mengekalkan foto sedia ada piksel demi piksel.
Sediakan aset rujukan bersih yang cukup terperinci dan gunakan semula gaya sama ketika membangunkan set. Jika output menjadi berulang, ubah subjek, pose, sudut kamera atau adegan dalam arahan teks tanpa menambah rujukan tidak berkaitan. Padanan warna tepat antara rujukan dan output tidak dijamin; kawalan warna pilihan menyatakan arah, bukannya hasil pembuktian warna. Untuk aset kempen akhir, nilai imej pada saiz paparan atau cetakan dimaksudkan dan semak sama ada subjek, ruang kosong berguna serta olahan visual sepadan dengan arahan.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had recraft/recraft-v4-styles-pro | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, auto | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 6 | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 1 Item maksimum: 10 | 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 | Syarat pengebilan | Caj |
|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Syarat 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 |
| KonfigurasiRujukan input | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap permintaan | Syarat pengebilanPenciptaan gaya apabila menjana dengan rujukan gaya; sekali bagi setiap permintaan, sebagai tambahan kepada harga imej output. | Caj Input · Rujukan input · Anggaran untuk perbandingan sahaja $0.01 bagi setiap permintaan |
| Konfigurasiimej keluaran | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap imej keluaran | Syarat pengebilan— | Caj Output · imej keluaran · Anggaran untuk perbandingan sahaja $0.2 bagi setiap imej keluaran |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Syarat pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.2 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-styles-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-styles-pro
/v1/images