OpenAI: GPT Image 1
GPT Image 1 membuat dan mengedit gambar dari masukan teks dan visual, termasuk komposisi yang dipandu referensi dan perubahan bermask. Model ini mendukung fidelitas masukan yang dapat dipilih, ukuran bingkai standar, latar transparan dan keluaran PNG, JPEG atau WebP.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
GPT Image 1 adalah model gambar OpenAI yang secara bawaan multimodal, menerima masukan teks dan gambar serta menghasilkan keluaran gambar. Model ini dapat membuat adegan baru, menggunakan gambar referensi untuk membentuk komposisi atau mengedit aset yang ada melalui instruksi baru. Pekerjaan praktis meliputi ilustrasi, citra produk, konsep desain dan perubahan lokal yang dipandu mask. Ini adalah edisi bernama GPT Image 1, terpisah dari Image 1 Mini, Image 1.5 dan versi GPT Image berikutnya.
Siapkan brief yang menyatakan subjek, latar, komposisi, pencahayaan dan gaya visual. Jika tugas memerlukan teks yang terlihat, sertakan kata-kata persisnya dan jelaskan hierarki serta posisi yang dimaksud. Untuk komposisi referensi, tetapkan peran jelas untuk setiap gambar, seperti produk, lingkungan atau perlakuan visual. Alur kerja pembuatan dan pengeditan langsung mengizinkan prompt hingga 32.000 karakter dan satu hingga sepuluh hasil gambar. Bandingkan variasi yang dikembalikan dengan brief yang sama dan simpan aset pilihan untuk pekerjaan berikutnya.
Pengeditan dapat menerima hingga enam belas gambar referensi. GPT Image 1 mendukung input_fidelity low dan high, dengan low sebagai pengaturan bawaan. Kontrol ini memengaruhi upaya mempertahankan fitur dan gaya gambar sumber; kontrol ini terpisah dari kualitas perenderan dan ukuran keluaran. Pengeditan berfidelitas tinggi berguna ketika detail sumber penting, tetapi bukan jaminan bahwa setiap detail pengenal tetap identik. Nyatakan apa yang harus dipertahankan dan apa yang boleh berubah, alih-alih hanya mengandalkan pengaturan fidelitas.
Pengeditan bermask mengidentifikasi area yang akan diubah. Siapkan sumber dan mask dalam format serta dimensi yang sama, di bawah 50 MB menurut persyaratan panduan, dengan kanal alfa pada mask. Dengan beberapa gambar sumber, mask diterapkan pada yang pertama. Brief pengeditan yang berguna dapat meminta warna dinding berbeda sambil mempertahankan furnitur, sudut kamera dan pencahayaan. Model menggunakan mask sebagai panduan tanpa menjanjikan batas yang tepat, sehingga periksa area yang berubah maupun sekitarnya.
Ukuran keluaran standar yang didokumentasikan adalah 1024 × 1024, 1536 × 1024 dan 1024 × 1536 piksel, dengan pemilihan ukuran otomatis jika didukung. Kualitas adalah low, medium, high atau auto. GPT Image 1 menggunakan bingkai standar dan tingkat kualitas hingga high ini. Pilih bingkai standar berdasarkan tampilan yang dituju dan tingkat detail berdasarkan tujuan aset.
PNG adalah keluaran bawaan, dengan alternatif JPEG dan WebP. Kompresi dari 0 hingga 100 tersedia untuk JPEG dan WebP. Pilihan latar transparan, opak dan otomatis mendukung kebutuhan penyerahan berbeda; transparansi memerlukan PNG atau WebP. Untuk grafis terisolasi, gunakan format yang mempertahankan kanal alfanya sebelum menempatkannya dalam tata letak berikutnya. Untuk adegan lengkap, sertakan latar dan hubungan subjek dengannya dalam brief.
OpenAI mendokumentasikan pembuatan dan pengeditan langsung, dan kartu model juga mencakup penggunaan gambar dalam percakapan. Untuk pekerjaan berulang, pertahankan hasil pilihan sebagai sumber perubahan lanjutan, alih-alih secara tersirat memilih variasi berbeda. Referensi gambar mendokumentasikan streaming dengan hingga tiga gambar parsial; gambar ini menunjukkan kemajuan, bukan aset jadi tambahan. Simpan gambar yang selesai bersama brief agar pengeditan berikutnya merujuk pada komposisi sebenarnya. Antarmuka pembuatnya juga mendukung pemrosesan batch.
Model masih dapat kesulitan dengan penempatan teks yang tepat, tata letak yang sangat terstruktur dan konsistensi subjek yang berulang. Periksa tulisan, batas objek, perlakuan warna dan detail yang mengidentifikasi materi sumber pada ukuran yang dimaksud. Jika pengeditan perlu disempurnakan, jelaskan ketidaksesuaian yang terlihat dan elemen yang harus dipertahankan. GPT Image 1 berguna untuk urutan konkret berupa pembuatan, pengeditan yang dipandu referensi dan persiapan aset, dengan ukuran standar serta fidelitas masukan yang dapat dipilih tetap dibedakan dari edisi lain.
Ailoot Ultra · Gambar POST /v1/images/generations openai/gpt-image-1
openai/gpt-image-1Mulai
GPT Image 1 membuat dan mengedit gambar dari masukan teks dan visual, termasuk komposisi yang dipandu referensi dan perubahan bermask. Model ini mendukung fidelitas masukan yang dapat dipilih, ukuran bingkai standar, latar transparan dan keluaran PNG, JPEG atau WebP.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Gambar
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Gambar POST /v1/images/generations
- Masukan
text,image- Keluaran
image
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan openai/gpt-image-1 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 3:2, 2:3, auto | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, low, medium, high | Bawaan— |
Kolombackground | Jenisstring | PersyaratanOpsional | Nilai & batasan auto, transparent, 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 metode dan siklus hidup
| 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}
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.
| 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.32768 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
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"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan konten lain
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
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
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Alias
Alias model
Ailoot Ultra openai/gpt-image-1
Alias jalur metode
/v1/images
ID pemanggil terkait
FAQ · OpenAI: GPT Image 1
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·openai/gpt-image-1:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·openai/gpt-image-1:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,provider- Batasan apa yang berlaku?
POST /v1/images/generations·openai/gpt-image-1:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100