{ "aboutHtml": "

FLUX 3 Image adalah model generasi dan penyuntingan gambar Black Forest Labs dengan kendali eksplisit atas komposisi. Deskripsi teks dapat membuat adegan baru; gambar yang diberikan dapat menetapkan subjek, adegan yang direvisi, atau beberapa elemen yang digabungkan. Kotak pembatas memungkinkan brief menentukan tempat setiap elemen dan bagian gambar yang sudah ada yang harus berubah. Hasilnya berupa gambar, dengan adegan, teks, dan tata letak yang diminta untuk diperiksa.

Buat adegan atau berikan instruksi suntingan

Untuk gambar baru, jelaskan subjek, aksi atau pose, latar, cahaya, dan pembingkaian. Letakkan kata-kata persis yang tampil dalam gambar di dalam tanda kutip dan nyatakan tempatnya. Brief produk orisinal dapat menampilkan mug berkemah merah di permukaan batu pucat, dengan judul besar di atasnya dan cahaya pagi lembut yang memperlihatkan gagang. Tentukan hubungan judul, produk, dan latar, alih-alih menawarkan kata-kata gaya yang tidak berkaitan.

Untuk penyuntingan, tentukan objek tertentu dan perubahannya: warnai ulang mug, ganti label, pindahkan sosok, atau ubah gaya adegan. Satu suntingan tidak memerlukan kotak yang digambar manual. Alur yang didokumentasikan memperluas instruksi sebelum generasi dan dapat menemukan elemen bernama serta menambahkan kotak secara otomatis. Prompt diperluas yang dikembalikan mencatat penafsiran itu, yang berguna ketika instruksi memilih objek salah atau memperkenalkan detail tidak diinginkan.

Gabungkan dan siapkan gambar referensi

Profil produsen yang tepat menerima satu hingga sepuluh referensi, berupa URL gambar atau data gambar terenkode. Setiap gambar harus minimal 256×256 piksel dan tidak lebih besar dari 16 megapiksel. Sebutkan referensi menurut posisi atau konten terlihat, lalu jelaskan perannya: orang dari Image 1, jaket dari Image 2, dan ruangan dari Image 3. Referensi gambar adalah sumber informasi visual, bukan instruksi menyalin setiap detail tidak berkaitan di dalamnya.

Pengaturan rasio aspek secara bawaan adalah auto. Dalam spesifikasi permintaan, rasio yang diminta dalam prompt mendapat prioritas; jika tidak, referensi pertama menetapkan pembingkaian, dengan keluaran persegi sebagai cadangan ketika tidak ada referensi maupun bentuk yang diminta yang menetapkannya. Untuk komposit, tempatkan referensi adegan yang dimaksud di awal atau pilih rasio secara eksplisit. Simpan gambar sumber dan urutannya bersama hasil agar revisi berikutnya menggunakan titik awal visual yang sama.

Tempatkan elemen dengan kotak pembatas

Prompt tata letak menggabungkan keterangan dengan larik JSON berisi baris elemen. Keterangan menyebut elemen melalui penanda seperti <cup_1>; baris memuat id, bbox, dan desc. Koordinat berupa bilangan bulat 0 hingga 1000 dalam urutan [top, left, bottom, right], diukur dari sudut kiri atas. Misalnya, [0, 0, 500, 500] menjelaskan seperempat kiri atas terlepas dari dimensi piksel gambar. Gunakan rasio aspek yang menjadi dasar desain tata letak karena kisi koordinat itu meregang mengikuti bingkai.

Baris suntingan menggunakan from, src_bbox, dan tgt_bbox bersama pengenal serta deskripsi. ref_image_0 berarti gambar pertama yang diberikan. Kotak sumber dan sasaran yang sama menambatkan elemen; kotak berbeda memindahkan atau mengubah ukurannya. Baris baru tanpa sumber menghasilkan deskripsinya di lokasi sasaran, memungkinkan penambahan, penggantian, atau pewarnaan ulang. Baris sumber tanpa sasaran menghapus elemen. Nyatakan penambahan dan penghapusan dalam instruksi tertulis maupun baris, serta pertahankan baris penambat untuk detail yang harus tetap di tempatnya.

Berikan kotak tersendiri pada huruf dan kutip kata-kata persisnya dalam desc. Kotak memandu penempatan dan skala; kotak bukan clipping mask, sehingga elemen dapat melampaui persegi panjang. Pembuat melaporkan bahwa objek baru dalam kotak sekitar 40×25 piksel sering gagal muncul dalam contohnya. Sediakan ruang terlihat yang cukup dan periksa batas suntingan. Piksel di luar sasaran biasanya tetap stabil, tetapi bayangan, pantulan, dan pencahayaan sekitar masih dapat berubah.

Grounding, kelas keluaran, dan catatan berguna

Profil yang didokumentasikan mengaktifkan grounding secara bawaan, sehingga pencarian web dan gambar dapat memberi informasi untuk generasi. Fitur dapat dinonaktifkan untuk brief yang hanya boleh menggunakan deskripsi dan referensinya. Untuk subjek dunia nyata, tentukan lokasi, peristiwa, atau objek dengan jelas dan pisahkan konten faktual dari pengolahan artistik. Gambar berbantuan pencarian tetap perlu dibandingkan dengan materi berwenang ketika label, objek, atau peristiwa yang digambarkan harus akurat.

Lima kelas resolusinya adalah 768sq, 1k, 1.5k, 2k, dan 4k, dengan 1k sebagai bawaan. Kelas tersebut mewakili tingkat luas piksel setara, sehingga lebar dan tinggi tepat bergantung pada rasio pilihan. Lima belas rasio tetap berkisar dari 21:9 melalui format persegi dan potret hingga 9:21. Profil model ini mengendalikan ukuran melalui rasio dan resolusi; profil tidak menyediakan kolom seed, width, atau height yang digunakan dalam profil permintaan FLUX.2. Pemilih versi yang didokumentasikan saat ini menamai rilis yang terus berubah, bukan menetapkan kecocokan bobot pemasok bertanggal.

Alur produsen mengembalikan gambar setelah pemrosesan asinkron, bersama prompt yang diperluas. Tautan unduhan gambar bertanda tangan berlaku selama satu jam. Simpan gambar sebenarnya, prompt akhir, dan referensi, alih-alih mengandalkan tautan sementara. Untuk aset yang ditinjau, bandingkan teks yang diminta, penempatan objek, identitas referensi, dan bagian yang diubah pada ukuran tampilan yang dimaksud. Generasi selesai merupakan titik awal pemeriksaan persyaratan visual itu.

", "aboutText": "FLUX 3 Image adalah model generasi dan penyuntingan gambar Black Forest Labs dengan kendali eksplisit atas komposisi. Deskripsi teks dapat membuat adegan baru; gambar yang diberikan dapat menetapkan subjek, adegan yang direvisi, atau beberapa elemen yang digabungkan. Kotak pembatas memungkinkan brief menentukan tempat setiap elemen dan bagian gambar yang sudah ada yang harus berubah. Hasilnya berupa gambar, dengan adegan, teks, dan tata letak yang diminta untuk diperiksa.\n\n### Buat adegan atau berikan instruksi suntingan\n\nUntuk gambar baru, jelaskan subjek, aksi atau pose, latar, cahaya, dan pembingkaian. Letakkan kata-kata persis yang tampil dalam gambar di dalam tanda kutip dan nyatakan tempatnya. Brief produk orisinal dapat menampilkan mug berkemah merah di permukaan batu pucat, dengan judul besar di atasnya dan cahaya pagi lembut yang memperlihatkan gagang. Tentukan hubungan judul, produk, dan latar, alih-alih menawarkan kata-kata gaya yang tidak berkaitan.\n\nUntuk penyuntingan, tentukan objek tertentu dan perubahannya: warnai ulang mug, ganti label, pindahkan sosok, atau ubah gaya adegan. Satu suntingan tidak memerlukan kotak yang digambar manual. Alur yang didokumentasikan memperluas instruksi sebelum generasi dan dapat menemukan elemen bernama serta menambahkan kotak secara otomatis. Prompt diperluas yang dikembalikan mencatat penafsiran itu, yang berguna ketika instruksi memilih objek salah atau memperkenalkan detail tidak diinginkan.\n\n### Gabungkan dan siapkan gambar referensi\n\nProfil produsen yang tepat menerima satu hingga sepuluh referensi, berupa URL gambar atau data gambar terenkode. Setiap gambar harus minimal 256×256 piksel dan tidak lebih besar dari 16 megapiksel. Sebutkan referensi menurut posisi atau konten terlihat, lalu jelaskan perannya: orang dari Image 1, jaket dari Image 2, dan ruangan dari Image 3. Referensi gambar adalah sumber informasi visual, bukan instruksi menyalin setiap detail tidak berkaitan di dalamnya.\n\nPengaturan rasio aspek secara bawaan adalah auto. Dalam spesifikasi permintaan, rasio yang diminta dalam prompt mendapat prioritas; jika tidak, referensi pertama menetapkan pembingkaian, dengan keluaran persegi sebagai cadangan ketika tidak ada referensi maupun bentuk yang diminta yang menetapkannya. Untuk komposit, tempatkan referensi adegan yang dimaksud di awal atau pilih rasio secara eksplisit. Simpan gambar sumber dan urutannya bersama hasil agar revisi berikutnya menggunakan titik awal visual yang sama.\n\n### Tempatkan elemen dengan kotak pembatas\n\nPrompt tata letak menggabungkan keterangan dengan larik JSON berisi baris elemen. Keterangan menyebut elemen melalui penanda seperti ; baris memuat id, bbox, dan desc. Koordinat berupa bilangan bulat 0 hingga 1000 dalam urutan [top, left, bottom, right], diukur dari sudut kiri atas. Misalnya, [0, 0, 500, 500] menjelaskan seperempat kiri atas terlepas dari dimensi piksel gambar. Gunakan rasio aspek yang menjadi dasar desain tata letak karena kisi koordinat itu meregang mengikuti bingkai.\n\nBaris suntingan menggunakan from, src_bbox, dan tgt_bbox bersama pengenal serta deskripsi. ref_image_0 berarti gambar pertama yang diberikan. Kotak sumber dan sasaran yang sama menambatkan elemen; kotak berbeda memindahkan atau mengubah ukurannya. Baris baru tanpa sumber menghasilkan deskripsinya di lokasi sasaran, memungkinkan penambahan, penggantian, atau pewarnaan ulang. Baris sumber tanpa sasaran menghapus elemen. Nyatakan penambahan dan penghapusan dalam instruksi tertulis maupun baris, serta pertahankan baris penambat untuk detail yang harus tetap di tempatnya.\n\nBerikan kotak tersendiri pada huruf dan kutip kata-kata persisnya dalam desc. Kotak memandu penempatan dan skala; kotak bukan clipping mask, sehingga elemen dapat melampaui persegi panjang. Pembuat melaporkan bahwa objek baru dalam kotak sekitar 40×25 piksel sering gagal muncul dalam contohnya. Sediakan ruang terlihat yang cukup dan periksa batas suntingan. Piksel di luar sasaran biasanya tetap stabil, tetapi bayangan, pantulan, dan pencahayaan sekitar masih dapat berubah.\n\n### Grounding, kelas keluaran, dan catatan berguna\n\nProfil yang didokumentasikan mengaktifkan grounding secara bawaan, sehingga pencarian web dan gambar dapat memberi informasi untuk generasi. Fitur dapat dinonaktifkan untuk brief yang hanya boleh menggunakan deskripsi dan referensinya. Untuk subjek dunia nyata, tentukan lokasi, peristiwa, atau objek dengan jelas dan pisahkan konten faktual dari pengolahan artistik. Gambar berbantuan pencarian tetap perlu dibandingkan dengan materi berwenang ketika label, objek, atau peristiwa yang digambarkan harus akurat.\n\nLima kelas resolusinya adalah 768sq, 1k, 1.5k, 2k, dan 4k, dengan 1k sebagai bawaan. Kelas tersebut mewakili tingkat luas piksel setara, sehingga lebar dan tinggi tepat bergantung pada rasio pilihan. Lima belas rasio tetap berkisar dari 21:9 melalui format persegi dan potret hingga 9:21. Profil model ini mengendalikan ukuran melalui rasio dan resolusi; profil tidak menyediakan kolom seed, width, atau height yang digunakan dalam profil permintaan FLUX.2. Pemilih versi yang didokumentasikan saat ini menamai rilis yang terus berubah, bukan menetapkan kecocokan bobot pemasok bertanggal.\n\nAlur produsen mengembalikan gambar setelah pemrosesan asinkron, bersama prompt yang diperluas. Tautan unduhan gambar bertanda tangan berlaku selama satu jam. Simpan gambar sebenarnya, prompt akhir, dan referensi, alih-alih mengandalkan tautan sementara. Untuk aset yang ditinjau, bandingkan teks yang diminta, penempatan objek, identitas referensi, dan bagian yang diubah pada ukuran tampilan yang dimaksud. Generasi selesai merupakan titik awal pemeriksaan persyaratan visual itu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e8c1370201099a97b4d55c9a5335cda7cf1615777ab21bc40769b910a6646269", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "
•

Black Forest Labs: FLUX.3 Image

Black Forest Labs /black-forest-labs/flux-3-image

Mulai

FLUX 3 Image membuat dan menyunting gambar dari brief tertulis dan hingga sepuluh referensi. Model menambahkan kotak pembatas berbasis prompt untuk komposisi dan perubahan lokal, grounding web dan gambar, serta lima kelas resolusi.

Masukan yang diterima
Teks · Gambar
Hasil
Gambar
Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

FLUX 3 Image adalah model generasi dan penyuntingan gambar Black Forest Labs dengan kendali eksplisit atas komposisi. Deskripsi teks dapat membuat adegan baru; gambar yang diberikan dapat menetapkan subjek, adegan yang direvisi, atau beberapa elemen yang digabungkan. Kotak pembatas memungkinkan brief menentukan tempat setiap elemen dan bagian gambar yang sudah ada yang harus berubah. Hasilnya berupa gambar, dengan adegan, teks, dan tata letak yang diminta untuk diperiksa.

Buat adegan atau berikan instruksi suntingan

Untuk gambar baru, jelaskan subjek, aksi atau pose, latar, cahaya, dan pembingkaian. Letakkan kata-kata persis yang tampil dalam gambar di dalam tanda kutip dan nyatakan tempatnya. Brief produk orisinal dapat menampilkan mug berkemah merah di permukaan batu pucat, dengan judul besar di atasnya dan cahaya pagi lembut yang memperlihatkan gagang. Tentukan hubungan judul, produk, dan latar, alih-alih menawarkan kata-kata gaya yang tidak berkaitan.

Untuk penyuntingan, tentukan objek tertentu dan perubahannya: warnai ulang mug, ganti label, pindahkan sosok, atau ubah gaya adegan. Satu suntingan tidak memerlukan kotak yang digambar manual. Alur yang didokumentasikan memperluas instruksi sebelum generasi dan dapat menemukan elemen bernama serta menambahkan kotak secara otomatis. Prompt diperluas yang dikembalikan mencatat penafsiran itu, yang berguna ketika instruksi memilih objek salah atau memperkenalkan detail tidak diinginkan.

Gabungkan dan siapkan gambar referensi

Profil produsen yang tepat menerima satu hingga sepuluh referensi, berupa URL gambar atau data gambar terenkode. Setiap gambar harus minimal 256×256 piksel dan tidak lebih besar dari 16 megapiksel. Sebutkan referensi menurut posisi atau konten terlihat, lalu jelaskan perannya: orang dari Image 1, jaket dari Image 2, dan ruangan dari Image 3. Referensi gambar adalah sumber informasi visual, bukan instruksi menyalin setiap detail tidak berkaitan di dalamnya.

Pengaturan rasio aspek secara bawaan adalah auto. Dalam spesifikasi permintaan, rasio yang diminta dalam prompt mendapat prioritas; jika tidak, referensi pertama menetapkan pembingkaian, dengan keluaran persegi sebagai cadangan ketika tidak ada referensi maupun bentuk yang diminta yang menetapkannya. Untuk komposit, tempatkan referensi adegan yang dimaksud di awal atau pilih rasio secara eksplisit. Simpan gambar sumber dan urutannya bersama hasil agar revisi berikutnya menggunakan titik awal visual yang sama.

Tempatkan elemen dengan kotak pembatas

Prompt tata letak menggabungkan keterangan dengan larik JSON berisi baris elemen. Keterangan menyebut elemen melalui penanda seperti <cup_1>; baris memuat id, bbox, dan desc. Koordinat berupa bilangan bulat 0 hingga 1000 dalam urutan [top, left, bottom, right], diukur dari sudut kiri atas. Misalnya, [0, 0, 500, 500] menjelaskan seperempat kiri atas terlepas dari dimensi piksel gambar. Gunakan rasio aspek yang menjadi dasar desain tata letak karena kisi koordinat itu meregang mengikuti bingkai.

Baris suntingan menggunakan from, src_bbox, dan tgt_bbox bersama pengenal serta deskripsi. ref_image_0 berarti gambar pertama yang diberikan. Kotak sumber dan sasaran yang sama menambatkan elemen; kotak berbeda memindahkan atau mengubah ukurannya. Baris baru tanpa sumber menghasilkan deskripsinya di lokasi sasaran, memungkinkan penambahan, penggantian, atau pewarnaan ulang. Baris sumber tanpa sasaran menghapus elemen. Nyatakan penambahan dan penghapusan dalam instruksi tertulis maupun baris, serta pertahankan baris penambat untuk detail yang harus tetap di tempatnya.

Berikan kotak tersendiri pada huruf dan kutip kata-kata persisnya dalam desc. Kotak memandu penempatan dan skala; kotak bukan clipping mask, sehingga elemen dapat melampaui persegi panjang. Pembuat melaporkan bahwa objek baru dalam kotak sekitar 40×25 piksel sering gagal muncul dalam contohnya. Sediakan ruang terlihat yang cukup dan periksa batas suntingan. Piksel di luar sasaran biasanya tetap stabil, tetapi bayangan, pantulan, dan pencahayaan sekitar masih dapat berubah.

Grounding, kelas keluaran, dan catatan berguna

Profil yang didokumentasikan mengaktifkan grounding secara bawaan, sehingga pencarian web dan gambar dapat memberi informasi untuk generasi. Fitur dapat dinonaktifkan untuk brief yang hanya boleh menggunakan deskripsi dan referensinya. Untuk subjek dunia nyata, tentukan lokasi, peristiwa, atau objek dengan jelas dan pisahkan konten faktual dari pengolahan artistik. Gambar berbantuan pencarian tetap perlu dibandingkan dengan materi berwenang ketika label, objek, atau peristiwa yang digambarkan harus akurat.

Lima kelas resolusinya adalah 768sq, 1k, 1.5k, 2k, dan 4k, dengan 1k sebagai bawaan. Kelas tersebut mewakili tingkat luas piksel setara, sehingga lebar dan tinggi tepat bergantung pada rasio pilihan. Lima belas rasio tetap berkisar dari 21:9 melalui format persegi dan potret hingga 9:21. Profil model ini mengendalikan ukuran melalui rasio dan resolusi; profil tidak menyediakan kolom seed, width, atau height yang digunakan dalam profil permintaan FLUX.2. Pemilih versi yang didokumentasikan saat ini menamai rilis yang terus berubah, bukan menetapkan kecocokan bobot pemasok bertanggal.

Alur produsen mengembalikan gambar setelah pemrosesan asinkron, bersama prompt yang diperluas. Tautan unduhan gambar bertanda tangan berlaku selama satu jam. Simpan gambar sebenarnya, prompt akhir, dan referensi, alih-alih mengandalkan tautan sementara. Untuk aset yang ditinjau, bandingkan teks yang diminta, penempatan objek, identitas referensi, dan bagian yang diubah pada ukuran tampilan yang dimaksud. Generasi selesai merupakan titik awal pemeriksaan persyaratan visual itu.

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Gambar POST /v1/images/generations
Masukan
text, image
Keluaran
image
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
black-forest-labs/flux-3-image
Bawaan—
KolompromptJenisstringPersyaratanWajibNilai & batasan
Panjang minimum: 1
Bawaan—
KolomresolutionJenisstringPersyaratanOpsionalNilai & batasan
768, 1K, 1.5K, 2K, 4K
Bawaan—
Kolomaspect_ratioJenisstringPersyaratanOpsionalNilai & batasan
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
Bawaan—
KolomnJenisintegerPersyaratanOpsionalNilai & batasan
Minimum: 1
Maksimum: 1
Bawaan—
Kolominput_referencesJenisarrayPersyaratanOpsionalNilai & batasan
Item minimum: 0
Item maksimum: 10
Bawaan—
KolomproviderJenisobjectPersyaratanOpsionalNilai & batasanBawaan—
Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt
Parametermaterial_typesKontraktext, 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}

Paket

Cara menghitung biaya akhir

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.

Mode Fast
Tidak ditentukan Saat mode fast dipilih
Mode Flex
Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum
Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiJadwal tarifJumlah perkiraanBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarJumlah perkiraan—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
KonfigurasiPerkiraan biaya pembuatanJadwal tarif—Jumlah perkiraanestimasi satu kali pembuatanBiaya
Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.082 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 →

Contoh permintaan

Ailoot Ultra · Gambar

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': 'black-forest-labs/flux-3-image', '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 · Gambar

Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Pembacaan konten 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 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.

Jika respons asli perlu diperiksa

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 respons
KolomJenis
KolomcreatedJenis
Kolomdata[].urlJenis
Kolomdata[].b64_jsonJenis
KolomusageJenis

Alias

Alias model

Ailoot Ultra black-forest-labs/flux-3-image

Alias jalur metode

/v1/images

ID pemanggil terkait

black-forest-labs/flux-3-image

", "method_identity": { "effective_request_model_id": "black-forest-labs/flux-3-image", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "black-forest-labs/flux-3-image", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|black-forest-labs%2Fflux-3-image", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "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 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." }, "outputs": { "all_results": "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.", "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": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "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": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "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": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "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 aktual yang dikembalikan atau catatan 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" } ] }, { "basis": "Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Perkiraan biaya pembuatan", "units": [ { "amount": "0.082", "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.082", "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': 'black-forest-labs/flux-3-image', '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\"; baris memuat id, bbox, dan desc. Koordinat berupa bilangan bulat 0 hingga 1000 dalam urutan [top, left, bottom, right], diukur dari sudut kiri atas. Misalnya, [0, 0, 500, 500] menjelaskan seperempat kiri atas terlepas dari dimensi piksel gambar. Gunakan rasio aspek yang menjadi dasar desain tata letak karena kisi koordinat itu meregang mengikuti bingkai.\n\nBaris suntingan menggunakan from, src_bbox, dan tgt_bbox bersama pengenal serta deskripsi. ref_image_0 berarti gambar pertama yang diberikan. Kotak sumber dan sasaran yang sama menambatkan elemen; kotak berbeda memindahkan atau mengubah ukurannya. Baris baru tanpa sumber menghasilkan deskripsinya di lokasi sasaran, memungkinkan penambahan, penggantian, atau pewarnaan ulang. Baris sumber tanpa sasaran menghapus elemen. Nyatakan penambahan dan penghapusan dalam instruksi tertulis maupun baris, serta pertahankan baris penambat untuk detail yang harus tetap di tempatnya.\n\nBerikan kotak tersendiri pada huruf dan kutip kata-kata persisnya dalam desc. Kotak memandu penempatan dan skala; kotak bukan clipping mask, sehingga elemen dapat melampaui persegi panjang. Pembuat melaporkan bahwa objek baru dalam kotak sekitar 40×25 piksel sering gagal muncul dalam contohnya. Sediakan ruang terlihat yang cukup dan periksa batas suntingan. Piksel di luar sasaran biasanya tetap stabil, tetapi bayangan, pantulan, dan pencahayaan sekitar masih dapat berubah.\n\n### Grounding, kelas keluaran, dan catatan berguna\n\nProfil yang didokumentasikan mengaktifkan grounding secara bawaan, sehingga pencarian web dan gambar dapat memberi informasi untuk generasi. Fitur dapat dinonaktifkan untuk brief yang hanya boleh menggunakan deskripsi dan referensinya. Untuk subjek dunia nyata, tentukan lokasi, peristiwa, atau objek dengan jelas dan pisahkan konten faktual dari pengolahan artistik. Gambar berbantuan pencarian tetap perlu dibandingkan dengan materi berwenang ketika label, objek, atau peristiwa yang digambarkan harus akurat.\n\nLima kelas resolusinya adalah 768sq, 1k, 1.5k, 2k, dan 4k, dengan 1k sebagai bawaan. Kelas tersebut mewakili tingkat luas piksel setara, sehingga lebar dan tinggi tepat bergantung pada rasio pilihan. Lima belas rasio tetap berkisar dari 21:9 melalui format persegi dan potret hingga 9:21. Profil model ini mengendalikan ukuran melalui rasio dan resolusi; profil tidak menyediakan kolom seed, width, atau height yang digunakan dalam profil permintaan FLUX.2. Pemilih versi yang didokumentasikan saat ini menamai rilis yang terus berubah, bukan menetapkan kecocokan bobot pemasok bertanggal.\n\nAlur produsen mengembalikan gambar setelah pemrosesan asinkron, bersama prompt yang diperluas. Tautan unduhan gambar bertanda tangan berlaku selama satu jam. Simpan gambar sebenarnya, prompt akhir, dan referensi, alih-alih mengandalkan tautan sementara. Untuk aset yang ditinjau, bandingkan teks yang diminta, penempatan objek, identitas referensi, dan bagian yang diubah pada ukuran tampilan yang dimaksud. Generasi selesai merupakan titik awal pemeriksaan persyaratan visual itu.", "alias_of": null, "aliases": [], "author": "Black Forest Labs", "capabilities": { "context_length": 46864, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.082", "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.082", "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" } ], "summary": "Informasi lengkap harga konfigurasi tersedia di bagian detail." } ], "ctx": null, "formats": [ "images" ], "id": "black-forest-labs/flux-3-image", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "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 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." }, "outputs": { "all_results": "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.", "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": [ "black-forest-labs/flux-3-image" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "enum_known": true, "name": "resolution", "required": false, "type": "string" }, { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "maximum": 1, "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": 0, "name": "input_references", "required": false, "type": "array" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "21:9", "2:1", "16:9", "3:2", "7:5", "4:3", "5:4", "1:1", "4:5", "3:4", "5:7", "2:3", "9:16", "1:2", "9:21", "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": 0, "type": "array" }, "model": { "enum": [ "black-forest-labs/flux-3-image" ], "type": "string" }, "n": { "maximum": 1, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "resolution": { "enum": [ "768", "1K", "1.5K", "2K", "4K" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "black-forest-labs/flux-3-image", "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 aktual yang dikembalikan atau catatan 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" } ] }, { "basis": "Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Perkiraan biaya pembuatan", "units": [ { "amount": "0.082", "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.082", "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': 'black-forest-labs/flux-3-image', '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\"