{ "aboutHtml": "

Recraft V4.1 Flash ialah model teks-ke-imej Recraft untuk lelaran pantas dan kerja visual berskala tinggi. Pengeluar mengenal pasti fotografi, potret, suasana, adegan kompleks, media campuran dan konsep logo sebagai kegunaan kuat. Arahan bertulis menjadi imej raster yang boleh dibandingkan dengan arah kreatif lain sebelum aset akhir dibangunkan. Flash ialah anggota khusus keluarga V4.1, dengan saiz output dan kawalan disokong sendiri.

Output natif berada dalam kelas imej raster 1K Recraft. Pilih kanvas berdasarkan tempat penggunaan dimaksudkan: ilustrasi mendatar untuk pengepala halaman, potret menegak atau visual segi empat sama untuk kad padat. Format output ialah WebP tanpa kehilangan dan PNG.

Mulakan arahan dengan subjek utama dan tujuan visual, kemudian huraikan pembingkaian, latar, pencahayaan dan medium. Untuk konsep produk, arahan berguna ialah: “Radio kompak berwarna krim di atas meja walnut, pandangan hadapan tiga suku, cahaya tingkap lembut, foto editorial tenang, ruang kosong luas di sebelah kiri.” Untuk ilustrasi, kenal pasti bahasa bentuk, palet dan hubungan antara unsur. Nyatakan butiran penentu idea secara eksplisit tanpa menambah kata sifat tidak berkaitan. Peruntukan prompt Flash yang didokumenkan ialah sehingga 10,000 aksara, jadi adegan terperinci boleh diterangkan apabila tugas memerlukannya.

Kawalan pengeluar merangkumi warna pilihan dan warna latar belakang dikehendaki. Seed boleh diberikan untuk hasil boleh ulang, dan antara muka penjanaannya mendokumenkan satu hingga enam imej dalam satu permintaan. Kawalan ini menyokong tugas perbandingan berguna: kekalkan subjek dan komposisi, ubah satu arah visual dan semak imej hasil untuk susun atur dimaksudkan. Pilihan warna menerangkan hasil diminta; bandingkan warna jenama penting dengan aset siap sebelum menggabungkannya dengan sistem reka bentuk sedia ada.

Flash menghasilkan grafik raster. Konsep logo boleh membantu memilih siluet, suasana atau susunan, sementara laluan boleh sunting milik model Vector bernama berasingan. Flash juga tidak mempunyai varian Pro. Rangkaian penuh V4.1 menyediakan pilihan berasingan itu apabila penyuntingan vektor atau butiran resolusi lebih tinggi menjadi teras hasil. Pengeluar menerangkan langkah penambahbaikan kemudian untuk membawa draf pilihan ke imej lebih terperinci; langkah itu ialah operasi berbeza, bukannya saiz output natif Flash lain.

Edisi ini tidak menyokong input imej-ke-imej, gaya tersuai, pengecam gaya, padanan gaya atau imej rujukan gaya. Antara muka yang didokumenkan turut mengecualikan prompt negatif dan kawalan susun atur teks eksplisit. Masukkan rupa dan komposisi diminta dalam arahan positif. Apabila tulisan menjadi sebahagian konsep, apit perkataan dimaksudkan dengan tanda petikan dan periksa huruf terpapar; gunakan peringkat susun atur berasingan apabila tipografi serta kedudukan tepat penting.

Hasil praktikal Flash ialah arah visual pilihan dengan arahan jelas, nisbah bidang sesuai dan fail raster boleh guna. Bandingkan subjek, pembingkaian, latar belakang dan butiran penting pada saiz imej akan muncul. Simpan prompt berjaya bersama fail pilihan supaya langkah kreatif seterusnya mengikuti arah terpilih. Lelaran pantas membantu menerokai reka bentuk; output vektor natif, padanan gaya rujukan dan resolusi edisi V4.1 lain kekal pilihan model berasingan.

", "aboutText": "Recraft V4.1 Flash ialah model teks-ke-imej Recraft untuk lelaran pantas dan kerja visual berskala tinggi. Pengeluar mengenal pasti fotografi, potret, suasana, adegan kompleks, media campuran dan konsep logo sebagai kegunaan kuat. Arahan bertulis menjadi imej raster yang boleh dibandingkan dengan arah kreatif lain sebelum aset akhir dibangunkan. Flash ialah anggota khusus keluarga V4.1, dengan saiz output dan kawalan disokong sendiri.\n\nOutput natif berada dalam kelas imej raster 1K Recraft. Pilih kanvas berdasarkan tempat penggunaan dimaksudkan: ilustrasi mendatar untuk pengepala halaman, potret menegak atau visual segi empat sama untuk kad padat. Format output ialah WebP tanpa kehilangan dan PNG.\n\nMulakan arahan dengan subjek utama dan tujuan visual, kemudian huraikan pembingkaian, latar, pencahayaan dan medium. Untuk konsep produk, arahan berguna ialah: “Radio kompak berwarna krim di atas meja walnut, pandangan hadapan tiga suku, cahaya tingkap lembut, foto editorial tenang, ruang kosong luas di sebelah kiri.” Untuk ilustrasi, kenal pasti bahasa bentuk, palet dan hubungan antara unsur. Nyatakan butiran penentu idea secara eksplisit tanpa menambah kata sifat tidak berkaitan. Peruntukan prompt Flash yang didokumenkan ialah sehingga 10,000 aksara, jadi adegan terperinci boleh diterangkan apabila tugas memerlukannya.\n\nKawalan pengeluar merangkumi warna pilihan dan warna latar belakang dikehendaki. Seed boleh diberikan untuk hasil boleh ulang, dan antara muka penjanaannya mendokumenkan satu hingga enam imej dalam satu permintaan. Kawalan ini menyokong tugas perbandingan berguna: kekalkan subjek dan komposisi, ubah satu arah visual dan semak imej hasil untuk susun atur dimaksudkan. Pilihan warna menerangkan hasil diminta; bandingkan warna jenama penting dengan aset siap sebelum menggabungkannya dengan sistem reka bentuk sedia ada.\n\nFlash menghasilkan grafik raster. Konsep logo boleh membantu memilih siluet, suasana atau susunan, sementara laluan boleh sunting milik model Vector bernama berasingan. Flash juga tidak mempunyai varian Pro. Rangkaian penuh V4.1 menyediakan pilihan berasingan itu apabila penyuntingan vektor atau butiran resolusi lebih tinggi menjadi teras hasil. Pengeluar menerangkan langkah penambahbaikan kemudian untuk membawa draf pilihan ke imej lebih terperinci; langkah itu ialah operasi berbeza, bukannya saiz output natif Flash lain.\n\nEdisi ini tidak menyokong input imej-ke-imej, gaya tersuai, pengecam gaya, padanan gaya atau imej rujukan gaya. Antara muka yang didokumenkan turut mengecualikan prompt negatif dan kawalan susun atur teks eksplisit. Masukkan rupa dan komposisi diminta dalam arahan positif. Apabila tulisan menjadi sebahagian konsep, apit perkataan dimaksudkan dengan tanda petikan dan periksa huruf terpapar; gunakan peringkat susun atur berasingan apabila tipografi serta kedudukan tepat penting.\n\nHasil praktikal Flash ialah arah visual pilihan dengan arahan jelas, nisbah bidang sesuai dan fail raster boleh guna. Bandingkan subjek, pembingkaian, latar belakang dan butiran penting pada saiz imej akan muncul. Simpan prompt berjaya bersama fail pilihan supaya langkah kreatif seterusnya mengikuti arah terpilih. Lelaran pantas membantu menerokai reka bentuk; output vektor natif, padanan gaya rujukan dan resolusi edisi V4.1 lain kekal pilihan model berasingan.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "fcc9e82ea7075f348478a2df12e85c62f573cd06cfb12a5ef1a149d1570fa848", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "
•

Recraft: Recraft V4.1 Flash

Recraft /recraft/recraft-v4.1-flash

Pengenalan

Recraft V4.1 Flash menjana imej raster 1K daripada teks untuk lelaran visual pantas. Ia menyokong fotografi, potret, adegan kompleks dan konsep logo, dengan output PNG atau WebP tanpa kehilangan serta pilihan warna eksplisit.

Input yang diterima
Teks
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.1 Flash ialah model teks-ke-imej Recraft untuk lelaran pantas dan kerja visual berskala tinggi. Pengeluar mengenal pasti fotografi, potret, suasana, adegan kompleks, media campuran dan konsep logo sebagai kegunaan kuat. Arahan bertulis menjadi imej raster yang boleh dibandingkan dengan arah kreatif lain sebelum aset akhir dibangunkan. Flash ialah anggota khusus keluarga V4.1, dengan saiz output dan kawalan disokong sendiri.

Output natif berada dalam kelas imej raster 1K Recraft. Pilih kanvas berdasarkan tempat penggunaan dimaksudkan: ilustrasi mendatar untuk pengepala halaman, potret menegak atau visual segi empat sama untuk kad padat. Format output ialah WebP tanpa kehilangan dan PNG.

Mulakan arahan dengan subjek utama dan tujuan visual, kemudian huraikan pembingkaian, latar, pencahayaan dan medium. Untuk konsep produk, arahan berguna ialah: “Radio kompak berwarna krim di atas meja walnut, pandangan hadapan tiga suku, cahaya tingkap lembut, foto editorial tenang, ruang kosong luas di sebelah kiri.” Untuk ilustrasi, kenal pasti bahasa bentuk, palet dan hubungan antara unsur. Nyatakan butiran penentu idea secara eksplisit tanpa menambah kata sifat tidak berkaitan. Peruntukan prompt Flash yang didokumenkan ialah sehingga 10,000 aksara, jadi adegan terperinci boleh diterangkan apabila tugas memerlukannya.

Kawalan pengeluar merangkumi warna pilihan dan warna latar belakang dikehendaki. Seed boleh diberikan untuk hasil boleh ulang, dan antara muka penjanaannya mendokumenkan satu hingga enam imej dalam satu permintaan. Kawalan ini menyokong tugas perbandingan berguna: kekalkan subjek dan komposisi, ubah satu arah visual dan semak imej hasil untuk susun atur dimaksudkan. Pilihan warna menerangkan hasil diminta; bandingkan warna jenama penting dengan aset siap sebelum menggabungkannya dengan sistem reka bentuk sedia ada.

Flash menghasilkan grafik raster. Konsep logo boleh membantu memilih siluet, suasana atau susunan, sementara laluan boleh sunting milik model Vector bernama berasingan. Flash juga tidak mempunyai varian Pro. Rangkaian penuh V4.1 menyediakan pilihan berasingan itu apabila penyuntingan vektor atau butiran resolusi lebih tinggi menjadi teras hasil. Pengeluar menerangkan langkah penambahbaikan kemudian untuk membawa draf pilihan ke imej lebih terperinci; langkah itu ialah operasi berbeza, bukannya saiz output natif Flash lain.

Edisi ini tidak menyokong input imej-ke-imej, gaya tersuai, pengecam gaya, padanan gaya atau imej rujukan gaya. Antara muka yang didokumenkan turut mengecualikan prompt negatif dan kawalan susun atur teks eksplisit. Masukkan rupa dan komposisi diminta dalam arahan positif. Apabila tulisan menjadi sebahagian konsep, apit perkataan dimaksudkan dengan tanda petikan dan periksa huruf terpapar; gunakan peringkat susun atur berasingan apabila tipografi serta kedudukan tepat penting.

Hasil praktikal Flash ialah arah visual pilihan dengan arahan jelas, nisbah bidang sesuai dan fail raster boleh guna. Bandingkan subjek, pembingkaian, latar belakang dan butiran penting pada saiz imej akan muncul. Simpan prompt berjaya bersama fail pilihan supaya langkah kreatif seterusnya mengikuti arah terpilih. Lelaran pantas membantu menerokai reka bentuk; output vektor natif, padanan gaya rujukan dan resolusi edisi V4.1 lain kekal pilihan model berasingan.

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Imej POST /v1/images/generations
Input
text
Output
image
Format output
Fail imej
Bilangan output
1 output
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
recraft/recraft-v4.1-flash
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & had
Panjang minimum: 1
Syarat: Prompt UTF8 yang tidak kosong. Tiada had aksara menyeluruh pengeluar direka-reka.
Lalai—
MedannJenisintegerKeperluanPilihanNilai & had
1
Lalai1
Medanresponse_formatJenisstringKeperluanPilihanNilai & had
url, b64_json
Lalai—
MedanstreamJenisbooleanKeperluanPilihanNilai & had
false
Lalaifalse
Gabungan bahan input

Teks kepada imej · Diperlukan: prompt

Parameter kaedah dan kitar hayat
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt
Parametermaterial_typesKontraktext
ParameteroptionalKontrakn, response_format, stream
ParameternKontrak1
ParameterstreamKontrakfalse
Parameterresponse_formatKontrakurl, b64_json
Parameterreference_imagesKontrakfalse
ParametereditKontrakfalse
Parameteroutput_format_optionalKontrak
Parameterresolution_controlKontraknull
Parameteraspect_ratio_controlKontraknull
Parameterother_fieldsKontrakditolak kecuali penghalaan pembekal dalaman tepat yang dipinkan

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}

Jana satu imej daripada prompt.

Simpan setiap item data; url/b64_json ialah pengekodan hasil.

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 pengebilanCaj
KonfigurasiKadar asas tokenJadual kadarKadar asasKuantiti 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
KonfigurasiUltraJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap imej keluaranCaj
Output · keluaran imej · Anggaran untuk perbandingan sahaja $0.014 bagi setiap imej keluaran
KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanUnit pengebilan—Caj
Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.014 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 →

Butiran tarif rujukan

Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.

Konfigurasi harga imej

Harga mengikut konfigurasi

KonfigurasiSyarat pengebilanCaj
KonfigurasiImej outputSyarat pengebilanTiada varian harga diisytiharkan.Caj
Output · Imej keluaran $0.014 bagi setiap imej

Penyenaraian setara menerangkan caj yang sama; ia tidak menambah fi kedua.

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=json.loads('{"model": "recraft/recraft-v4.1-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\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

Simpan semua hasil yang selesai

Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.

Simpan setiap item data. Nyahkod setiap b64_json atau dapatkan setiap URL bertandatangan yang dikembalikan. Pilih sambungan nama fail berdasarkan MIME/bait sebenar.

Jika respons asal perlu disemak

Jika hasil penjanaan atau penyuntingan imej memerlukan semakan, simpan operation_id/X-Client-Request-ID asal serta maklumat hasil yang dikembalikan. Pulihkan hasil sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan penjanaan/penyuntingan atau bina URL tinjauan status daripada operation_id.

Medan respons
MedanJenis
MedancreatedJenisinteger
Medandata[].urlJenisstring
Medandata[].b64_jsonJenisbase64 string
MedanusageJenisobject
Ralat dan langkah seterusnya
ResponsSyaratLangkah seterusnya
Respons400 · invalid_request_errorSyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sahLangkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu.
Responsserver_errorSyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakanLangkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan.

Alias

Alias model

Ailoot Ultra recraft/recraft-v4.1-flash

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

recraft/recraft-v4.1-flash

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-flash", "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": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Medan wajib, perwakilan bahan atau nilai parameter tidak sah", "http_status": 400, "recovery": "Betulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu.", "type": "invalid_request_error" }, { "code": null, "condition": "Respons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan", "http_status": null, "recovery": "Simpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "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": "Jika hasil penjanaan atau penyuntingan imej memerlukan semakan, simpan operation_id/X-Client-Request-ID asal serta maklumat hasil yang dikembalikan. Pulihkan hasil sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan penjanaan/penyuntingan atau bina URL tinjauan status daripada operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Simpan setiap item data. Nyahkod setiap b64_json atau dapatkan setiap URL bertandatangan yang dikembalikan. Pilih sambungan nama fail berdasarkan MIME/bait sebenar.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "recraft/recraft-v4.1-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Prompt UTF8 yang tidak kosong. Tiada had aksara menyeluruh pengeluar direka-reka.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Jana satu imej daripada prompt.", "Simpan setiap item data; url/b64_json ialah pengekodan hasil." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "ditolak kecuali penghalaan pembekal dalaman tepat yang dipinkan", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "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": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "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": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.014", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.014", "native_quantity": 1, "public_unit_label": "per image output", "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.014", "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.014", "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=json.loads('{\"model\": \"recraft/recraft-v4.1-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\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\"