{ "aboutHtml": "

Recraft V4 Styles ialah edisi raster standard dalam keluarga penjanaan konsisten gaya khusus Recraft. Ia mencipta imej baharu daripada prompt teks sambil mengikuti gaya ditetapkan aset rujukan. Model berguna untuk satu siri ilustrasi, sepanduk atau adegan produk yang perlu berkongsi olahan visual mudah dikenali. Rujukan membawa logik pemaparan, tekstur dan warna; prompt memperkenalkan subjek serta adegan bagi setiap aset baharu.

Pengeluar menyenaraikan output raster 1K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 1024 × 1024 piksel, dan saiz 16:9 yang didokumenkan ialah 1344 × 768; potret serta nisbah disokong lain menggunakan saiz sendiri. Edisi ini berbeza daripada output raster 2K Styles Pro dan model Vector yang menghasilkan SVG. Pilih nisbah bidang untuk susun atur akhir tanpa menganggap label 1K bermaksud setiap imej mempunyai lebar dan tinggi sama.

Gaya diwajibkan. Gunakan satu hingga sepuluh rujukan PNG, JPG atau WebP atau gaya serasi yang disimpan daripada penciptaan gaya terdahulu. Aliran yang didokumenkan tidak menerima pengecam gaya tersimpan bersama rujukan baharu. Rujukan boleh berupa aset jenama atau kempen sedia ada dan tidak semestinya imej yang asalnya dijana Recraft. Ia mestilah di bawah 20 MB setiap fail dan jumlah tidak melebihi 64 MB. Tiada tugas latihan berasingan yang dijalankan pengguna sebelum gaya boleh digunakan. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.

Mulakan dengan satu rujukan kuat atau beberapa rujukan yang sudah sepadan bahasa visualnya. Rujukan konsisten membantu menerapkan gaya melangkaui satu objek atau pose; moodboard tidak berkaitan boleh memperkenalkan motif bersaing. Padanan fleksibel ialah lalai dan memberikan lebih ruang tafsiran; padanan tepat mengikuti pemaparan, palet, komposisi serta pencahayaan rujukan dengan lebih rapat. Penghasilan semula warna tepat masih tidak dijamin.

Untuk siri sepanduk, huraikan kurier meletakkan bungkusan di ambang pintu, komposisi mendatar tenang dan ruang terbuka pada satu sisi untuk teks kemudian. Arahan seterusnya boleh mengubah peristiwa atau sudut kamera sambil mengekalkan gaya sama. Pengeluar membenarkan prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak dan satu hingga enam imej. Ia tidak menyokong negative_prompt, nama gaya yang dikurasi atau text_layout, jadi huraikan subjek serta susun atur dimaksudkan secara terus dalam arahan.

Rangkaian Styles tidak menawarkan imej-ke-imej atau inpainting. Rujukan gaya memandu imej baharu yang dijana tanpa menjamin pemeliharaan objek atau piksel rujukan. Jika set kelihatan berulang, pinda pose, tindakan, pembingkaian atau butiran adegan tanpa menambah rujukan bercanggah. Nilai setiap hasil dalam susun atur dimaksudkan dari segi kejelasan subjek, ruang berguna dan pemaparan padu, kemudian kekalkan gaya serasi sama untuk aset seterusnya. Ini menjadikan model praktikal untuk bahasa visual boleh ulang dengan kandungan berubah.

", "aboutText": "Recraft V4 Styles ialah edisi raster standard dalam keluarga penjanaan konsisten gaya khusus Recraft. Ia mencipta imej baharu daripada prompt teks sambil mengikuti gaya ditetapkan aset rujukan. Model berguna untuk satu siri ilustrasi, sepanduk atau adegan produk yang perlu berkongsi olahan visual mudah dikenali. Rujukan membawa logik pemaparan, tekstur dan warna; prompt memperkenalkan subjek serta adegan bagi setiap aset baharu.\n\nPengeluar menyenaraikan output raster 1K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 1024 × 1024 piksel, dan saiz 16:9 yang didokumenkan ialah 1344 × 768; potret serta nisbah disokong lain menggunakan saiz sendiri. Edisi ini berbeza daripada output raster 2K Styles Pro dan model Vector yang menghasilkan SVG. Pilih nisbah bidang untuk susun atur akhir tanpa menganggap label 1K bermaksud setiap imej mempunyai lebar dan tinggi sama.\n\nGaya diwajibkan. Gunakan satu hingga sepuluh rujukan PNG, JPG atau WebP atau gaya serasi yang disimpan daripada penciptaan gaya terdahulu. Aliran yang didokumenkan tidak menerima pengecam gaya tersimpan bersama rujukan baharu. Rujukan boleh berupa aset jenama atau kempen sedia ada dan tidak semestinya imej yang asalnya dijana Recraft. Ia mestilah di bawah 20 MB setiap fail dan jumlah tidak melebihi 64 MB. Tiada tugas latihan berasingan yang dijalankan pengguna sebelum gaya boleh digunakan. 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\nMulakan dengan satu rujukan kuat atau beberapa rujukan yang sudah sepadan bahasa visualnya. Rujukan konsisten membantu menerapkan gaya melangkaui satu objek atau pose; moodboard tidak berkaitan boleh memperkenalkan motif bersaing. Padanan fleksibel ialah lalai dan memberikan lebih ruang tafsiran; padanan tepat mengikuti pemaparan, palet, komposisi serta pencahayaan rujukan dengan lebih rapat. Penghasilan semula warna tepat masih tidak dijamin.\n\nUntuk siri sepanduk, huraikan kurier meletakkan bungkusan di ambang pintu, komposisi mendatar tenang dan ruang terbuka pada satu sisi untuk teks kemudian. Arahan seterusnya boleh mengubah peristiwa atau sudut kamera sambil mengekalkan gaya sama. Pengeluar membenarkan prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak dan satu hingga enam imej. Ia tidak menyokong negative_prompt, nama gaya yang dikurasi atau text_layout, jadi huraikan subjek serta susun atur dimaksudkan secara terus dalam arahan.\n\nRangkaian Styles tidak menawarkan imej-ke-imej atau inpainting. Rujukan gaya memandu imej baharu yang dijana tanpa menjamin pemeliharaan objek atau piksel rujukan. Jika set kelihatan berulang, pinda pose, tindakan, pembingkaian atau butiran adegan tanpa menambah rujukan bercanggah. Nilai setiap hasil dalam susun atur dimaksudkan dari segi kejelasan subjek, ruang berguna dan pemaparan padu, kemudian kekalkan gaya serasi sama untuk aset seterusnya. Ini menjadikan model praktikal untuk bahasa visual boleh ulang dengan kandungan berubah.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d8bf7a8f25a8b0ec8a01e6fda81d58e12cca54274d5cbf443808557c1d376384", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "
•

Recraft: Recraft V4 Styles

Recraft /recraft/recraft-v4-styles

Pengenalan

Recraft V4 Styles menjana imej raster 1K dalam gaya visual ditentukan rujukan. Ia direka untuk kerja jenama dan kempen harian yang setiap subjek baharunya perlu mengekalkan pemaparan, tekstur dan rupa keseluruhan sama.

Input yang diterima
Teks · Imej
Hasil
Imej
Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Recraft V4 Styles ialah edisi raster standard dalam keluarga penjanaan konsisten gaya khusus Recraft. Ia mencipta imej baharu daripada prompt teks sambil mengikuti gaya ditetapkan aset rujukan. Model berguna untuk satu siri ilustrasi, sepanduk atau adegan produk yang perlu berkongsi olahan visual mudah dikenali. Rujukan membawa logik pemaparan, tekstur dan warna; prompt memperkenalkan subjek serta adegan bagi setiap aset baharu.

Pengeluar menyenaraikan output raster 1K dalam WebP tanpa kehilangan atau PNG. Saiz segi empat sama ialah 1024 × 1024 piksel, dan saiz 16:9 yang didokumenkan ialah 1344 × 768; potret serta nisbah disokong lain menggunakan saiz sendiri. Edisi ini berbeza daripada output raster 2K Styles Pro dan model Vector yang menghasilkan SVG. Pilih nisbah bidang untuk susun atur akhir tanpa menganggap label 1K bermaksud setiap imej mempunyai lebar dan tinggi sama.

Gaya diwajibkan. Gunakan satu hingga sepuluh rujukan PNG, JPG atau WebP atau gaya serasi yang disimpan daripada penciptaan gaya terdahulu. Aliran yang didokumenkan tidak menerima pengecam gaya tersimpan bersama rujukan baharu. Rujukan boleh berupa aset jenama atau kempen sedia ada dan tidak semestinya imej yang asalnya dijana Recraft. Ia mestilah di bawah 20 MB setiap fail dan jumlah tidak melebihi 64 MB. Tiada tugas latihan berasingan yang dijalankan pengguna sebelum gaya boleh digunakan. Setiap rujukan mesti mempunyai sisi terpendek sekurang-kurangnya 256 piksel, sisi terpanjang tidak melebihi 4,096 piksel dan jumlah resolusi tidak melebihi 16 megapiksel.

Mulakan dengan satu rujukan kuat atau beberapa rujukan yang sudah sepadan bahasa visualnya. Rujukan konsisten membantu menerapkan gaya melangkaui satu objek atau pose; moodboard tidak berkaitan boleh memperkenalkan motif bersaing. Padanan fleksibel ialah lalai dan memberikan lebih ruang tafsiran; padanan tepat mengikuti pemaparan, palet, komposisi serta pencahayaan rujukan dengan lebih rapat. Penghasilan semula warna tepat masih tidak dijamin.

Untuk siri sepanduk, huraikan kurier meletakkan bungkusan di ambang pintu, komposisi mendatar tenang dan ruang terbuka pada satu sisi untuk teks kemudian. Arahan seterusnya boleh mengubah peristiwa atau sudut kamera sambil mengekalkan gaya sama. Pengeluar membenarkan prompt sehingga 10,000 aksara, warna pilihan, warna latar belakang dikehendaki, seed rawak dan satu hingga enam imej. Ia tidak menyokong negative_prompt, nama gaya yang dikurasi atau text_layout, jadi huraikan subjek serta susun atur dimaksudkan secara terus dalam arahan.

Rangkaian Styles tidak menawarkan imej-ke-imej atau inpainting. Rujukan gaya memandu imej baharu yang dijana tanpa menjamin pemeliharaan objek atau piksel rujukan. Jika set kelihatan berulang, pinda pose, tindakan, pembingkaian atau butiran adegan tanpa menambah rujukan bercanggah. Nilai setiap hasil dalam susun atur dimaksudkan dari segi kejelasan subjek, ruang berguna dan pemaparan padu, kemudian kekalkan gaya serasi sama untuk aset seterusnya. Ini menjadikan model praktikal untuk bahasa visual boleh ulang dengan kandungan berubah.

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Imej POST /v1/images/generations
Input
text, image
Output
image
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
recraft/recraft-v4-styles
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & had
Panjang minimum: 1
Lalai—
Medanaspect_ratioJenisstringKeperluanPilihanNilai & 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—
MedannJenisintegerKeperluanPilihanNilai & had
Minimum: 1
Maksimum: 6
Lalai—
Medaninput_referencesJenisarrayKeperluanPilihanNilai & had
Item minimum: 1
Item maksimum: 10
Lalai—
MedanproviderJenisobjectKeperluanPilihanNilai & hadLalai—
Parameter kaedah dan kitar hayat
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt
Parametermaterial_typesKontraktext, 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}

Pelan harga

Cara caj akhir dikira

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.

Mod pantas
Tidak dinyatakan Apabila mod pantas dipilih
Mod flex
Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum
Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

KonfigurasiJadual kadarKuantiti ramalanUnit pengebilanSyarat pengebilanCaj
KonfigurasiKadar asas tokenJadual kadarKadar asasKuantiti 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 inputJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap permintaanSyarat 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 keluaranJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap imej keluaranSyarat pengebilan—Caj
Output · imej keluaran · Anggaran untuk perbandingan sahaja $0.07 bagi setiap imej keluaran
KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanUnit pengebilan—Syarat 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 →

Contoh permintaan

Ailoot Ultra · Imej

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', '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\n

Terima dan simpan hasil

Ailoot Ultra · Imej

Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya

Pembacaan kandungan lain
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.\n
Simpan semua hasil yang selesai

Simpan 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.

Jika respons asal perlu disemak

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 respons
MedanJenis
MedancreatedJenis
Medandata[].urlJenis
Medandata[].b64_jsonJenis
MedanusageJenis

Alias

Alias model

Ailoot Ultra recraft/recraft-v4-styles

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

recraft/recraft-v4-styles

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4-styles", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4-styles", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4-styles", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "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." }, "outputs": { "all_results": "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.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "recraft/recraft-v4-styles" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "2:1", "1:2", "3:2", "2:3", "4:3", "3:4", "5:4", "4:5", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 10, "minimum_items": 1, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "2:1", "1:2", "3:2", "2:3", "4:3", "3:4", "5:4", "4:5", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 10, "minItems": 1, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4-styles" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4-styles", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "task_id sebenar yang dikembalikan atau rekod pustaka media", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "Penciptaan gaya apabila menjana dengan rujukan gaya; sekali bagi setiap permintaan, sebagai tambahan kepada harga imej output.", "quoted_unit": "per request" }, "label": "Rujukan input", "units": [ { "amount": "0.01", "amount_unit": "usd_per_request", "billing_input": false, "estimate_only": true, "key": "image_input_reference_request", "label": "Input reference", "native_amount_usd_per_unit": "0.01", "native_quantity": 1, "public_unit_label": "per request", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "request" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.07", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.07", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anggaran kos penjanaan", "units": [ { "amount": "0.07", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.07", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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', '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\"