GPT Image 2 adalah model OpenAI untuk pembuatan dan pengeditan gambar dari masukan teks dan visual. Model ini membuat gambar baru dari brief tertulis dan dapat menggunakan gambar sumber untuk pengeditan atau pekerjaan yang dipandu referensi. Tugas praktis meliputi ilustrasi, konsep produk, komposisi visual dan perubahan aset yang ada. Ini adalah edisi terpisah dari model GPT Image 2.5 Sunburst dan Flare, dengan rentang kualitas dan perilaku fidelitas masukan tersendiri.
Untuk pembuatan, jelaskan subjek, adegan, komposisi, cahaya dan gaya yang dimaksud. Untuk pengeditan, sebutkan apa yang harus berubah dan apa yang harus mempertahankan tampilannya. Brief produk dapat meminta lampu keramik di atas permukaan pucat dengan siluet di tengah dan ruang untuk keterangan; pengeditan lanjutan dapat mengubah latar sambil mempertahankan bentuk lampu dan sudut pandang. Alur kerja pembuatan dan pengeditan langsung yang didokumentasikan menerima prompt hingga 32.000 karakter dan dapat mengembalikan satu hingga sepuluh gambar.
Pengeditan berbasis referensi menerima hingga enam belas gambar masukan. Tentukan tujuan setiap referensi agar subjek, latar dan perlakuan visual tidak tertukar. GPT Image 2 secara otomatis memproses setiap masukan gambar dengan fidelitas tinggi; input_fidelity perlu dihilangkan karena tidak dapat diatur pada edisi ini. Ini berbeda dari pilihan high atau low pada GPT Image 1 dan mode fidelitas masukan hanya low pada GPT Image 1 Mini. Pemrosesan masukan dengan fidelitas tinggi mendukung detail sumber tanpa menjamin setiap detail direproduksi tanpa perubahan.
Mask dapat mengidentifikasi wilayah yang akan diedit. Gambar sumber dan mask harus memiliki format serta dimensi yang sama dan berukuran di bawah 50 MB menurut persyaratan persiapan panduan; mask juga memerlukan kanal alfa. Jika beberapa gambar masukan diberikan, mask berlaku pada yang pertama. Model memperlakukan mask sebagai panduan berbasis prompt, bukan batas geometris yang ketat. Jelaskan perubahan lokal dan persyaratan pelestarian, lalu periksa area sekitarnya untuk perbedaan yang tidak diinginkan.
GPT Image 2 mendukung kualitas low, medium, high dan auto, dengan auto sebagai pengaturan bawaan. Pengaturan xhigh dan max keluarga 2.5 bukan bagian dari rentang kualitas edisi ini. Ukuran dapat berupa persegi, lanskap, potret, otomatis atau lebar dan tinggi khusus yang valid. Contoh pembuatnya meliputi 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 dan 2160 × 3840 piksel. Pilih orientasi dan tingkat detail sesuai tata letak sebenarnya, alih-alih menganggap kualitas dan dimensi sebagai kontrol yang sama.
Dimensi khusus harus merupakan kelipatan enam belas piksel, dengan sisi maksimal 3840 piksel, rasio sisi panjang terhadap pendek tidak lebih besar dari 3:1 dan luas dari 655.360 hingga 8.294.400 piksel. Syarat-syarat ini berlaku sekaligus. Resolusi di atas 2560 × 1440 ditandai eksperimental. Bingkai yang memenuhi satu aturan masih dapat melanggar aturan lain, sehingga pilih pasangan dimensi yang didukung dan jelaskan elemen yang peka terhadap pemotongan dalam brief.
Keluaran secara bawaan adalah PNG, dengan JPEG atau WebP juga tersedia. Kompresi dari 0 hingga 100 didukung untuk JPEG dan WebP. Latar dapat berupa opak atau otomatis; referensi tepat saat ini menjelaskan transparansi GPT Image 2 sebagai kemampuan pratinjau. Saat meminta transparansi, gunakan PNG atau WebP agar kanal alfa dapat dipertahankan. Alur kerja streaming yang didokumentasikan mengizinkan hingga tiga gambar parsial sebelum gambar jadi; simpan aset akhir, bukan pratinjau kemajuan. Antarmuka pembuatnya juga mendukung pemrosesan batch.
Evaluasi kejelasan teks, posisi objek dan pelestarian detail sumber dalam hasil sebenarnya. GPT Image dapat kesulitan dengan tulisan presisi, komposisi yang peka terhadap tata letak dan identitas visual berulang pada pembuatan terpisah. Untuk rangkaian pengeditan, gunakan hasil pilihan sebagai sumber berikutnya dan berikan perubahan konkret yang terkait dengan masalah yang terlihat. Keluaran GPT Image 2 yang berguna adalah gambar yang terhubung dengan brief pembuatan atau pengeditan yang jelas, dengan masukan berfidelitas tinggi, dimensi dan kualitas yang dipilih untuk tugas tersebut.
", "aboutText": "GPT Image 2 adalah model OpenAI untuk pembuatan dan pengeditan gambar dari masukan teks dan visual. Model ini membuat gambar baru dari brief tertulis dan dapat menggunakan gambar sumber untuk pengeditan atau pekerjaan yang dipandu referensi. Tugas praktis meliputi ilustrasi, konsep produk, komposisi visual dan perubahan aset yang ada. Ini adalah edisi terpisah dari model GPT Image 2.5 Sunburst dan Flare, dengan rentang kualitas dan perilaku fidelitas masukan tersendiri.\n\nUntuk pembuatan, jelaskan subjek, adegan, komposisi, cahaya dan gaya yang dimaksud. Untuk pengeditan, sebutkan apa yang harus berubah dan apa yang harus mempertahankan tampilannya. Brief produk dapat meminta lampu keramik di atas permukaan pucat dengan siluet di tengah dan ruang untuk keterangan; pengeditan lanjutan dapat mengubah latar sambil mempertahankan bentuk lampu dan sudut pandang. Alur kerja pembuatan dan pengeditan langsung yang didokumentasikan menerima prompt hingga 32.000 karakter dan dapat mengembalikan satu hingga sepuluh gambar.\n\nPengeditan berbasis referensi menerima hingga enam belas gambar masukan. Tentukan tujuan setiap referensi agar subjek, latar dan perlakuan visual tidak tertukar. GPT Image 2 secara otomatis memproses setiap masukan gambar dengan fidelitas tinggi; input_fidelity perlu dihilangkan karena tidak dapat diatur pada edisi ini. Ini berbeda dari pilihan high atau low pada GPT Image 1 dan mode fidelitas masukan hanya low pada GPT Image 1 Mini. Pemrosesan masukan dengan fidelitas tinggi mendukung detail sumber tanpa menjamin setiap detail direproduksi tanpa perubahan.\n\nMask dapat mengidentifikasi wilayah yang akan diedit. Gambar sumber dan mask harus memiliki format serta dimensi yang sama dan berukuran di bawah 50 MB menurut persyaratan persiapan panduan; mask juga memerlukan kanal alfa. Jika beberapa gambar masukan diberikan, mask berlaku pada yang pertama. Model memperlakukan mask sebagai panduan berbasis prompt, bukan batas geometris yang ketat. Jelaskan perubahan lokal dan persyaratan pelestarian, lalu periksa area sekitarnya untuk perbedaan yang tidak diinginkan.\n\nGPT Image 2 mendukung kualitas low, medium, high dan auto, dengan auto sebagai pengaturan bawaan. Pengaturan xhigh dan max keluarga 2.5 bukan bagian dari rentang kualitas edisi ini. Ukuran dapat berupa persegi, lanskap, potret, otomatis atau lebar dan tinggi khusus yang valid. Contoh pembuatnya meliputi 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 dan 2160 × 3840 piksel. Pilih orientasi dan tingkat detail sesuai tata letak sebenarnya, alih-alih menganggap kualitas dan dimensi sebagai kontrol yang sama.\n\nDimensi khusus harus merupakan kelipatan enam belas piksel, dengan sisi maksimal 3840 piksel, rasio sisi panjang terhadap pendek tidak lebih besar dari 3:1 dan luas dari 655.360 hingga 8.294.400 piksel. Syarat-syarat ini berlaku sekaligus. Resolusi di atas 2560 × 1440 ditandai eksperimental. Bingkai yang memenuhi satu aturan masih dapat melanggar aturan lain, sehingga pilih pasangan dimensi yang didukung dan jelaskan elemen yang peka terhadap pemotongan dalam brief.\n\nKeluaran secara bawaan adalah PNG, dengan JPEG atau WebP juga tersedia. Kompresi dari 0 hingga 100 didukung untuk JPEG dan WebP. Latar dapat berupa opak atau otomatis; referensi tepat saat ini menjelaskan transparansi GPT Image 2 sebagai kemampuan pratinjau. Saat meminta transparansi, gunakan PNG atau WebP agar kanal alfa dapat dipertahankan. Alur kerja streaming yang didokumentasikan mengizinkan hingga tiga gambar parsial sebelum gambar jadi; simpan aset akhir, bukan pratinjau kemajuan. Antarmuka pembuatnya juga mendukung pemrosesan batch.\n\nEvaluasi kejelasan teks, posisi objek dan pelestarian detail sumber dalam hasil sebenarnya. GPT Image dapat kesulitan dengan tulisan presisi, komposisi yang peka terhadap tata letak dan identitas visual berulang pada pembuatan terpisah. Untuk rangkaian pengeditan, gunakan hasil pilihan sebagai sumber berikutnya dan berikan perubahan konkret yang terkait dengan masalah yang terlihat. Keluaran GPT Image 2 yang berguna adalah gambar yang terhubung dengan brief pembuatan atau pengeditan yang jelas, dengan masukan berfidelitas tinggi, dimensi dan kualitas yang dipilih untuk tugas tersebut.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2f78001a6770d2ba957d0630bdf93dfb0cddb72fc8395d05a9d9cab7ddf8b583", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "gpt-image-2GPT Image 2 membuat dan mengedit gambar dari teks dan referensi visual. Model ini mendukung dimensi bingkai fleksibel dan secara otomatis memproses masukan gambar dengan fidelitas tinggi, dengan kontrol kualitas, format dan latar yang terpisah untuk aset jadi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
GPT Image 2 adalah model OpenAI untuk pembuatan dan pengeditan gambar dari masukan teks dan visual. Model ini membuat gambar baru dari brief tertulis dan dapat menggunakan gambar sumber untuk pengeditan atau pekerjaan yang dipandu referensi. Tugas praktis meliputi ilustrasi, konsep produk, komposisi visual dan perubahan aset yang ada. Ini adalah edisi terpisah dari model GPT Image 2.5 Sunburst dan Flare, dengan rentang kualitas dan perilaku fidelitas masukan tersendiri.
Untuk pembuatan, jelaskan subjek, adegan, komposisi, cahaya dan gaya yang dimaksud. Untuk pengeditan, sebutkan apa yang harus berubah dan apa yang harus mempertahankan tampilannya. Brief produk dapat meminta lampu keramik di atas permukaan pucat dengan siluet di tengah dan ruang untuk keterangan; pengeditan lanjutan dapat mengubah latar sambil mempertahankan bentuk lampu dan sudut pandang. Alur kerja pembuatan dan pengeditan langsung yang didokumentasikan menerima prompt hingga 32.000 karakter dan dapat mengembalikan satu hingga sepuluh gambar.
Pengeditan berbasis referensi menerima hingga enam belas gambar masukan. Tentukan tujuan setiap referensi agar subjek, latar dan perlakuan visual tidak tertukar. GPT Image 2 secara otomatis memproses setiap masukan gambar dengan fidelitas tinggi; input_fidelity perlu dihilangkan karena tidak dapat diatur pada edisi ini. Ini berbeda dari pilihan high atau low pada GPT Image 1 dan mode fidelitas masukan hanya low pada GPT Image 1 Mini. Pemrosesan masukan dengan fidelitas tinggi mendukung detail sumber tanpa menjamin setiap detail direproduksi tanpa perubahan.
Mask dapat mengidentifikasi wilayah yang akan diedit. Gambar sumber dan mask harus memiliki format serta dimensi yang sama dan berukuran di bawah 50 MB menurut persyaratan persiapan panduan; mask juga memerlukan kanal alfa. Jika beberapa gambar masukan diberikan, mask berlaku pada yang pertama. Model memperlakukan mask sebagai panduan berbasis prompt, bukan batas geometris yang ketat. Jelaskan perubahan lokal dan persyaratan pelestarian, lalu periksa area sekitarnya untuk perbedaan yang tidak diinginkan.
GPT Image 2 mendukung kualitas low, medium, high dan auto, dengan auto sebagai pengaturan bawaan. Pengaturan xhigh dan max keluarga 2.5 bukan bagian dari rentang kualitas edisi ini. Ukuran dapat berupa persegi, lanskap, potret, otomatis atau lebar dan tinggi khusus yang valid. Contoh pembuatnya meliputi 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 dan 2160 × 3840 piksel. Pilih orientasi dan tingkat detail sesuai tata letak sebenarnya, alih-alih menganggap kualitas dan dimensi sebagai kontrol yang sama.
Dimensi khusus harus merupakan kelipatan enam belas piksel, dengan sisi maksimal 3840 piksel, rasio sisi panjang terhadap pendek tidak lebih besar dari 3:1 dan luas dari 655.360 hingga 8.294.400 piksel. Syarat-syarat ini berlaku sekaligus. Resolusi di atas 2560 × 1440 ditandai eksperimental. Bingkai yang memenuhi satu aturan masih dapat melanggar aturan lain, sehingga pilih pasangan dimensi yang didukung dan jelaskan elemen yang peka terhadap pemotongan dalam brief.
Keluaran secara bawaan adalah PNG, dengan JPEG atau WebP juga tersedia. Kompresi dari 0 hingga 100 didukung untuk JPEG dan WebP. Latar dapat berupa opak atau otomatis; referensi tepat saat ini menjelaskan transparansi GPT Image 2 sebagai kemampuan pratinjau. Saat meminta transparansi, gunakan PNG atau WebP agar kanal alfa dapat dipertahankan. Alur kerja streaming yang didokumentasikan mengizinkan hingga tiga gambar parsial sebelum gambar jadi; simpan aset akhir, bukan pratinjau kemajuan. Antarmuka pembuatnya juga mendukung pemrosesan batch.
Evaluasi kejelasan teks, posisi objek dan pelestarian detail sumber dalam hasil sebenarnya. GPT Image dapat kesulitan dengan tulisan presisi, komposisi yang peka terhadap tata letak dan identitas visual berulang pada pembuatan terpisah. Untuk rangkaian pengeditan, gunakan hasil pilihan sebagai sumber berikutnya dan berikan perubahan konkret yang terkait dengan masalah yang terlihat. Keluaran GPT Image 2 yang berguna adalah gambar yang terhubung dengan brief pembuatan atau pengeditan yang jelas, dengan masukan berfidelitas tinggi, dimensi dan kualitas yang dipilih untuk tugas tersebut.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan gpt-image-2 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan1 |
Kolomresponse_format | Jenisstring | PersyaratanOpsional | Nilai & batasan url, b64_json | Bawaan— |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan | Bawaanfalse |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolommoderation | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolominput_fidelity | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolomstyle | Jenisstring | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Kolompartial_images | Jenisinteger | PersyaratanOpsional | Nilai & batasan Bergantung pada model | Bawaan— |
Teks ke gambar · Wajib: prompt
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional_controls | Kontraknull |
Parametercontent_type | Kontrakapplication/json |
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}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
POST /v1/images/generationsAiloot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nUnduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan setiap item data. Dekodekan setiap b64_json atau ambil data dari setiap URL bertanda tangan yang dikembalikan. Pilih ekstensi nama file berdasarkan MIME/bytes aktual.
Jika hasil pembuatan atau penyuntingan gambar perlu diperiksa, simpan operation_id/X-Client-Request-ID asli dan informasi hasil yang dikembalikan. Pulihkan hasil milik Anda yang sudah ada melalui pustaka media menggunakan nilai task_id atau asset_id aktual. Jangan mengirim ulang permintaan pembuatan/penyuntingan atau membuat URL polling dari operation_id.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenisinteger |
Kolomdata[].url | Jenisstring |
Kolomdata[].b64_json | Jenisbase64 string |
Kolomusage | Jenisobject |
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2GPT Image 2 membuat dan mengedit gambar dari teks dan referensi visual. Model ini mendukung dimensi bingkai fleksibel dan secara otomatis memproses masukan gambar dengan fidelitas tinggi, dengan kontrol kualitas, format dan latar yang terpisah untuk aset jadi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
GPT Image 2 adalah model OpenAI untuk pembuatan dan pengeditan gambar dari masukan teks dan visual. Model ini membuat gambar baru dari brief tertulis dan dapat menggunakan gambar sumber untuk pengeditan atau pekerjaan yang dipandu referensi. Tugas praktis meliputi ilustrasi, konsep produk, komposisi visual dan perubahan aset yang ada. Ini adalah edisi terpisah dari model GPT Image 2.5 Sunburst dan Flare, dengan rentang kualitas dan perilaku fidelitas masukan tersendiri.
Untuk pembuatan, jelaskan subjek, adegan, komposisi, cahaya dan gaya yang dimaksud. Untuk pengeditan, sebutkan apa yang harus berubah dan apa yang harus mempertahankan tampilannya. Brief produk dapat meminta lampu keramik di atas permukaan pucat dengan siluet di tengah dan ruang untuk keterangan; pengeditan lanjutan dapat mengubah latar sambil mempertahankan bentuk lampu dan sudut pandang. Alur kerja pembuatan dan pengeditan langsung yang didokumentasikan menerima prompt hingga 32.000 karakter dan dapat mengembalikan satu hingga sepuluh gambar.
Pengeditan berbasis referensi menerima hingga enam belas gambar masukan. Tentukan tujuan setiap referensi agar subjek, latar dan perlakuan visual tidak tertukar. GPT Image 2 secara otomatis memproses setiap masukan gambar dengan fidelitas tinggi; input_fidelity perlu dihilangkan karena tidak dapat diatur pada edisi ini. Ini berbeda dari pilihan high atau low pada GPT Image 1 dan mode fidelitas masukan hanya low pada GPT Image 1 Mini. Pemrosesan masukan dengan fidelitas tinggi mendukung detail sumber tanpa menjamin setiap detail direproduksi tanpa perubahan.
Mask dapat mengidentifikasi wilayah yang akan diedit. Gambar sumber dan mask harus memiliki format serta dimensi yang sama dan berukuran di bawah 50 MB menurut persyaratan persiapan panduan; mask juga memerlukan kanal alfa. Jika beberapa gambar masukan diberikan, mask berlaku pada yang pertama. Model memperlakukan mask sebagai panduan berbasis prompt, bukan batas geometris yang ketat. Jelaskan perubahan lokal dan persyaratan pelestarian, lalu periksa area sekitarnya untuk perbedaan yang tidak diinginkan.
GPT Image 2 mendukung kualitas low, medium, high dan auto, dengan auto sebagai pengaturan bawaan. Pengaturan xhigh dan max keluarga 2.5 bukan bagian dari rentang kualitas edisi ini. Ukuran dapat berupa persegi, lanskap, potret, otomatis atau lebar dan tinggi khusus yang valid. Contoh pembuatnya meliputi 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 dan 2160 × 3840 piksel. Pilih orientasi dan tingkat detail sesuai tata letak sebenarnya, alih-alih menganggap kualitas dan dimensi sebagai kontrol yang sama.
Dimensi khusus harus merupakan kelipatan enam belas piksel, dengan sisi maksimal 3840 piksel, rasio sisi panjang terhadap pendek tidak lebih besar dari 3:1 dan luas dari 655.360 hingga 8.294.400 piksel. Syarat-syarat ini berlaku sekaligus. Resolusi di atas 2560 × 1440 ditandai eksperimental. Bingkai yang memenuhi satu aturan masih dapat melanggar aturan lain, sehingga pilih pasangan dimensi yang didukung dan jelaskan elemen yang peka terhadap pemotongan dalam brief.
Keluaran secara bawaan adalah PNG, dengan JPEG atau WebP juga tersedia. Kompresi dari 0 hingga 100 didukung untuk JPEG dan WebP. Latar dapat berupa opak atau otomatis; referensi tepat saat ini menjelaskan transparansi GPT Image 2 sebagai kemampuan pratinjau. Saat meminta transparansi, gunakan PNG atau WebP agar kanal alfa dapat dipertahankan. Alur kerja streaming yang didokumentasikan mengizinkan hingga tiga gambar parsial sebelum gambar jadi; simpan aset akhir, bukan pratinjau kemajuan. Antarmuka pembuatnya juga mendukung pemrosesan batch.
Evaluasi kejelasan teks, posisi objek dan pelestarian detail sumber dalam hasil sebenarnya. GPT Image dapat kesulitan dengan tulisan presisi, komposisi yang peka terhadap tata letak dan identitas visual berulang pada pembuatan terpisah. Untuk rangkaian pengeditan, gunakan hasil pilihan sebagai sumber berikutnya dan berikan perubahan konkret yang terkait dengan masalah yang terlihat. Keluaran GPT Image 2 yang berguna adalah gambar yang terhubung dengan brief pembuatan atau pengeditan yang jelas, dengan masukan berfidelitas tinggi, dimensi dan kualitas yang dipilih untuk tugas tersebut.
POST /v1/images/generationstextimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan gpt-image-2 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang maksimum: 32.000 | Bawaan— |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Gunakan auto atau WIDTHxHEIGHT dengan kedua dimensi habis dibagi 16. Sisi terpanjang paling banyak 3,840 piksel dan ukuran total paling banyak 8,300,000 piksel. | Bawaanauto |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan transparent, opaque, auto | Bawaanauto |
Kolommoderation | Jenisstring | PersyaratanOpsional | Nilai & batasan low, auto Kondisi: Gunakan auto untuk moderasi konten standar. | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 10 | Bawaan1 |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, high, medium, low | Bawaanauto |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 0 Maksimum: 100 Kondisi: Berlaku untuk keluaran JPEG dan WebP; kirim nilai bilangan bulat yang didokumentasikan. | Bawaan100 |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan webp, png, jpeg | Bawaanpng |
Kolomstream | Jenisboolean | PersyaratanOpsional | Nilai & batasan false Kondisi: Rute ini mengembalikan satu respons JSON yang lengkap. | Bawaanfalse |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakprompt, model |
Parametermaterial_types | Kontraktext |
Parameteroptional | Kontraksize, background, moderation, n, quality, output_compression, output_format, stream |
Parameterconditions | KontrakLatar belakang transparan memerlukan PNG atau WebP., Kompresi keluaran berlaku untuk JPEG atau WebP., Metode yang dipilih membuat keluaran dari teks. Kontrol penyuntingan dan streaming yang dijelaskan untuk pembuat model merupakan kemampuan terpisah. |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah 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 pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.24576 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nUnduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSimpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2GPT Image 2 membuat dan mengedit gambar dari teks dan referensi visual. Model ini mendukung dimensi bingkai fleksibel dan secara otomatis memproses masukan gambar dengan fidelitas tinggi, dengan kontrol kualitas, format dan latar yang terpisah untuk aset jadi.
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
GPT Image 2 adalah model OpenAI untuk pembuatan dan pengeditan gambar dari masukan teks dan visual. Model ini membuat gambar baru dari brief tertulis dan dapat menggunakan gambar sumber untuk pengeditan atau pekerjaan yang dipandu referensi. Tugas praktis meliputi ilustrasi, konsep produk, komposisi visual dan perubahan aset yang ada. Ini adalah edisi terpisah dari model GPT Image 2.5 Sunburst dan Flare, dengan rentang kualitas dan perilaku fidelitas masukan tersendiri.
Untuk pembuatan, jelaskan subjek, adegan, komposisi, cahaya dan gaya yang dimaksud. Untuk pengeditan, sebutkan apa yang harus berubah dan apa yang harus mempertahankan tampilannya. Brief produk dapat meminta lampu keramik di atas permukaan pucat dengan siluet di tengah dan ruang untuk keterangan; pengeditan lanjutan dapat mengubah latar sambil mempertahankan bentuk lampu dan sudut pandang. Alur kerja pembuatan dan pengeditan langsung yang didokumentasikan menerima prompt hingga 32.000 karakter dan dapat mengembalikan satu hingga sepuluh gambar.
Pengeditan berbasis referensi menerima hingga enam belas gambar masukan. Tentukan tujuan setiap referensi agar subjek, latar dan perlakuan visual tidak tertukar. GPT Image 2 secara otomatis memproses setiap masukan gambar dengan fidelitas tinggi; input_fidelity perlu dihilangkan karena tidak dapat diatur pada edisi ini. Ini berbeda dari pilihan high atau low pada GPT Image 1 dan mode fidelitas masukan hanya low pada GPT Image 1 Mini. Pemrosesan masukan dengan fidelitas tinggi mendukung detail sumber tanpa menjamin setiap detail direproduksi tanpa perubahan.
Mask dapat mengidentifikasi wilayah yang akan diedit. Gambar sumber dan mask harus memiliki format serta dimensi yang sama dan berukuran di bawah 50 MB menurut persyaratan persiapan panduan; mask juga memerlukan kanal alfa. Jika beberapa gambar masukan diberikan, mask berlaku pada yang pertama. Model memperlakukan mask sebagai panduan berbasis prompt, bukan batas geometris yang ketat. Jelaskan perubahan lokal dan persyaratan pelestarian, lalu periksa area sekitarnya untuk perbedaan yang tidak diinginkan.
GPT Image 2 mendukung kualitas low, medium, high dan auto, dengan auto sebagai pengaturan bawaan. Pengaturan xhigh dan max keluarga 2.5 bukan bagian dari rentang kualitas edisi ini. Ukuran dapat berupa persegi, lanskap, potret, otomatis atau lebar dan tinggi khusus yang valid. Contoh pembuatnya meliputi 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 dan 2160 × 3840 piksel. Pilih orientasi dan tingkat detail sesuai tata letak sebenarnya, alih-alih menganggap kualitas dan dimensi sebagai kontrol yang sama.
Dimensi khusus harus merupakan kelipatan enam belas piksel, dengan sisi maksimal 3840 piksel, rasio sisi panjang terhadap pendek tidak lebih besar dari 3:1 dan luas dari 655.360 hingga 8.294.400 piksel. Syarat-syarat ini berlaku sekaligus. Resolusi di atas 2560 × 1440 ditandai eksperimental. Bingkai yang memenuhi satu aturan masih dapat melanggar aturan lain, sehingga pilih pasangan dimensi yang didukung dan jelaskan elemen yang peka terhadap pemotongan dalam brief.
Keluaran secara bawaan adalah PNG, dengan JPEG atau WebP juga tersedia. Kompresi dari 0 hingga 100 didukung untuk JPEG dan WebP. Latar dapat berupa opak atau otomatis; referensi tepat saat ini menjelaskan transparansi GPT Image 2 sebagai kemampuan pratinjau. Saat meminta transparansi, gunakan PNG atau WebP agar kanal alfa dapat dipertahankan. Alur kerja streaming yang didokumentasikan mengizinkan hingga tiga gambar parsial sebelum gambar jadi; simpan aset akhir, bukan pratinjau kemajuan. Antarmuka pembuatnya juga mendukung pemrosesan batch.
Evaluasi kejelasan teks, posisi objek dan pelestarian detail sumber dalam hasil sebenarnya. GPT Image dapat kesulitan dengan tulisan presisi, komposisi yang peka terhadap tata letak dan identitas visual berulang pada pembuatan terpisah. Untuk rangkaian pengeditan, gunakan hasil pilihan sebagai sumber berikutnya dan berikan perubahan konkret yang terkait dengan masalah yang terlihat. Keluaran GPT Image 2 yang berguna adalah gambar yang terhubung dengan brief pembuatan atau pengeditan yang jelas, dengan masukan berfidelitas tinggi, dimensi dan kualitas yang dipilih untuk tugas tersebut.
POST /v1/images/generationstext, imageimage| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan openai/gpt-image-2 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, low, medium, high | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, opaque | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 10 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 16 | Bawaan— |
Kolomoutput_compression | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 0 Maksimum: 100 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah 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 pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.24576 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nUnduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nSimpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images