gpt image 2 official api integration guide id image 0 图示

Panduan Praktis 9 Langkah Mengintegrasikan gpt-image-2 dengan API Resmi: Dari Nol hingga Produksi

oleh

gpt-image-2 yang dirilis OpenAI pada April 2026 telah menjadi model yang paling banyak dibicarakan di ranah pembuatan gambar—dengan akurasi rendering teks tingkat karakter 99%, output 4K definisi tinggi, dukungan bahasa Mandarin/CJK asli, dan integrasi kemampuan penalaran seri O. Namun, pertanyaan pertama yang muncul bagi banyak pengembang setelah mendapatkan model ini adalah: Bagaimana cara menghubungkan gpt-image-2 ke API resmi? Parameter apa saja yang wajib diisi? Bagaimana cara mengatur base_url? Dan bagaimana cara menggunakan b64_json yang didapat dari respons?

Artikel ini adalah panduan praktis menghubungkan gpt-image-2 ke API resmi dari ujung ke ujung, yang mencakup semua detail teknis mulai dari instalasi SDK, konfigurasi base_url, hingga teks ke gambar, pengeditan gambar, inpainting, dan penanganan kesalahan. Semua kode didasarkan pada SDK resmi OpenAI dan saluran proksi API APIYI (100% konsisten dengan bidang resmi). Setelah mengikuti panduan ini, proyek Anda akan siap menggunakan gpt-image-2 di lingkungan produksi.

gpt-image-2-official-api-integration-guide-id 图示

Daftar Persiapan Menghubungkan gpt-image-2 ke API Resmi

Sebelum menulis baris kode pertama, Anda perlu menyiapkan lingkungan kerja. Daftar berikut mencakup 4 prasyarat utama untuk menghubungkan gpt-image-2 ke API resmi.

Daftar Lingkungan untuk Menghubungkan gpt-image-2 ke API Resmi

Item Persiapan Persyaratan Penjelasan
Kunci API Bearer Token yang valid Ajukan melalui konsol APIYI, daftar untuk mendapatkan kuota uji coba
SDK Python openai >= 1.50.0 Versi lama tidak mendukung parameter baru images.generate()
SDK Node.js openai >= 4.50.0 Tipe TypeScript sudah disinkronkan dengan versi resmi
Timeout HTTP ≥ 360 detik Kualitas tinggi + 2K/4K membutuhkan waktu 3-5 menit
Persyaratan Jaringan Dapat diakses langsung api.apiyi.com dapat diakses dari jaringan domestik/rumah/luar negeri

Instalasi SDK untuk Menghubungkan gpt-image-2 ke API Resmi

Apa pun bahasa yang Anda pilih, cukup instal SDK resmi OpenAI—saluran proksi API APIYI sepenuhnya konsisten dengan bidang resmi, sehingga tidak memerlukan pustaka klien tambahan.

# Python
pip install --upgrade openai

# Node.js
npm install openai@latest

# Jika menggunakan yarn / pnpm
yarn add openai
pnpm add openai

Proses Mendapatkan Kunci API untuk Menghubungkan gpt-image-2 ke API Resmi

Langkah-langkah untuk mendapatkan kunci API sangat sederhana:

  1. Kunjungi konsol APIYI di api.apiyi.com
  2. Setelah mendaftar akun, masuk ke halaman "API Token"
  3. Buat Token baru (disarankan menggunakan Token terpisah untuk proyek yang berbeda agar mudah diaudit)
  4. Simpan Token ke dalam variabel lingkungan (sangat tidak disarankan untuk melakukan hardcode ke dalam kode)

🚀 Saran Memulai Cepat: Saat pertama kali menghubungkan ke API resmi gpt-image-2, disarankan untuk mencoba alur kerja dengan kualitas rendah + 1024×1024 terlebih dahulu, baru kemudian beralih ke kualitas tinggi dan ukuran besar. Kami menyarankan untuk mengklaim kuota uji coba melalui platform APIYI apiyi.com, kuota gratis tersebut cukup untuk menyelesaikan verifikasi seluruh proses PoC.

# Tambahkan ke ~/.zshrc atau ~/.bashrc
export APIYI_KEY="sk-your-token-here"

Konfigurasi base_url untuk Integrasi API Resmi gpt-image-2

Dalam seluruh alur integrasi API resmi untuk gpt-image-2, satu-satunya hal yang berbeda dari SDK OpenAI asli adalah base_url. Cukup ganti api.openai.com menjadi api.apiyi.com, dan kode lainnya tetap sama persis.

gpt-image-2-official-api-integration-guide-id 图示

Dua Endpoint untuk Integrasi API Resmi gpt-image-2

APIYI menyediakan dua endpoint pembuatan gambar yang sepenuhnya kompatibel dengan OpenAI:

Endpoint Kegunaan Parameter Wajib
POST /v1/images/generations Teks ke gambar (generasi prompt murni) model, prompt
POST /v1/images/edits Pengeditan gambar, fusi multi-gambar, mask inpainting model, prompt, image

Inisialisasi Klien untuk Integrasi API Resmi gpt-image-2

Berikut adalah kode inisialisasi klien untuk Python dan Node.js. Pastikan untuk mengatur timeout ke 360 detik atau lebih.

# Python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("APIYI_KEY"),
    base_url="https://api.apiyi.com/v1",  # Arahkan ke saluran proksi API APIYI
    timeout=600.0,                         # Wajib diperpanjang untuk skenario kualitas tinggi
    max_retries=2
)

// Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.APIYI_KEY,
  baseURL: "https://api.apiyi.com/v1",  // Perhatikan penggunaan baseURL (camelCase)
  timeout: 600 * 1000,                  // Dalam milidetik
  maxRetries: 2
});

💡 Pengingat Timeout: Timeout default 60 detik pasti akan gagal dalam skenario kualitas tinggi (high) + 2K/4K. Kami menyarankan saat mengakses melalui APIYI apiyi.com, atur timeout permintaan klien di lingkungan produksi antara 360-600 detik untuk menghindari pemutusan koneksi yang tidak diinginkan pada permintaan yang memakan waktu lama.

Pemanggilan Teks ke Gambar untuk Integrasi API Resmi gpt-image-2

Mari kita mulai praktiknya. Berikut adalah cara melakukan pemanggilan teks ke gambar pertama untuk integrasi API resmi gpt-image-2 dalam tiga bahasa.

Teks ke Gambar dengan Python untuk Integrasi API Resmi gpt-image-2

import base64
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("APIYI_KEY"),
    base_url="https://api.apiyi.com/v1",
    timeout=600.0
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="A modern minimalist office desk with a vintage typewriter, soft morning light from the window, photorealistic, 8K",
    size="1536x1024",
    quality="high",
    output_format="jpeg",
    output_compression=92,
    n=1
)

# Kunci: APIYI mengembalikan string base64 murni, tanpa awalan data:image/...
b64 = response.data[0].b64_json
with open("output.jpg", "wb") as f:
    f.write(base64.b64decode(b64))

print("✓ Gambar telah disimpan ke output.jpg")

Teks ke Gambar dengan Node.js untuk Integrasi API Resmi gpt-image-2

import fs from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.APIYI_KEY,
  baseURL: "https://api.apiyi.com/v1",
  timeout: 600_000
});

const response = await client.images.generate({
  model: "gpt-image-2",
  prompt: "An e-commerce product photo of a leather backpack on a marble desk, studio lighting",
  size: "1024x1024",
  quality: "high",
  output_format: "png",
  n: 1
});

const b64 = response.data[0].b64_json;
await fs.writeFile("output.png", Buffer.from(b64, "base64"));
console.log("✓ Gambar telah disimpan");

Teks ke Gambar dengan cURL untuk Integrasi API Resmi gpt-image-2

cURL sangat cocok untuk memverifikasi ketersediaan kunci API dan menguji kombinasi parameter baru.

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A futuristic cyberpunk city at night, neon signs in mixed Chinese and English",
    "size": "2048x1152",
    "quality": "high",
    "output_format": "jpeg",
    "output_compression": 90,
    "n": 1
  }' | jq -r '.data[0].b64_json' | base64 -d > output.jpg

Perhatikan bahwa --max-time 600 wajib ditambahkan—cURL secara default tidak memiliki batas waktu, namun banyak shell wrapper yang akan memaksakan pemutusan koneksi setelah 60 detik.

Poin Penting Pemrosesan Respons Integrasi API Resmi gpt-image-2

Banyak pengembang terjebak saat melakukan parsing base64 untuk pertama kalinya. Berikut adalah beberapa kesalahan umum:

# ✗ Salah: APIYI tidak mengembalikan field url
url = response.data[0].url  # AttributeError

# ✓ Benar: Gunakan b64_json
b64 = response.data[0].b64_json

# ✗ Salah: Browser merender string b64 murni secara langsung
<img src="{b64}">  # Tidak akan muncul

# ✓ Benar: Browser memerlukan awalan manual untuk merender
data_uri = f"data:image/jpeg;base64,{b64}"
# <img src="{{ data_uri }}">

# ✓ Benar: Simpan ke disk di sisi server
with open("output.jpg", "wb") as f:
    f.write(base64.b64decode(b64))

Penjelasan Lengkap Parameter API Resmi gpt-image-2

Memahami rentang nilai dan skenario penggunaan setiap parameter adalah kunci untuk membawa integrasi API resmi gpt-image-2 ke lingkungan produksi.

gpt-image-2-official-api-integration-guide-id 图示

Tabel Parameter Inti Integrasi API Resmi gpt-image-2

Parameter Nilai Default Penjelasan
model "gpt-image-2" Wajib ID Model
prompt String Wajib Petunjuk, mendukung campuran bahasa
size 8 preset + kustom auto Lihat tabel di bawah
quality auto / low / medium / high auto Mempengaruhi biaya dan waktu
output_format png / jpeg / webp png Disarankan jpeg + kompresi 90
output_compression 1-100 100 Hanya berlaku untuk jpeg/webp
moderation auto / low auto low mengurangi sensitivitas moderasi
n 1-10 1 Jumlah gambar per permintaan

Opsi Lengkap Parameter size untuk API Resmi gpt-image-2

# 8 preset resmi
size = "1024x1024"   # 1:1 Standar persegi
size = "1536x1024"   # 3:2 Lanskap
size = "1024x1536"   # 2:3 Potret
size = "2048x2048"   # 2K persegi
size = "2048x1152"   # 16:9 Lanskap (cocok untuk wallpaper PC/poster)
size = "3840x2160"   # 4K Lanskap
size = "2160x3840"   # 4K Potret (cocok untuk wallpaper ponsel)
size = "auto"        # Dipilih otomatis oleh model

Jika Anda memerlukan ukuran kustom, Anda harus memenuhi batasan berikut:

✓ Panjang sisi adalah kelipatan 16
✓ Panjang sisi maksimum ≤ 3840px
✓ Rasio panjang-pendek ≤ 3:1
✓ Total piksel antara 655.360 ~ 8.294.400

Contoh: 1280x720 (720P) valid, sedangkan 3840x1080 (ultra-wide) akan ditolak karena rasio > 3:1.

Perbandingan quality dan Biaya Integrasi API Resmi gpt-image-2

quality adalah parameter yang paling mempengaruhi biaya. Berikut adalah tabel harga lengkap (per gambar).

Kualitas 1024×1024 1024×1536 1536×1024 Skenario Penggunaan
low $0.006 $0.005 $0.005 Sketsa, thumbnail, iterasi cepat
medium $0.053 $0.041 $0.041 Situs konten, ilustrasi media
high $0.211 $0.165 $0.165 Gambar produk, poster, materi iklan

💰 Optimasi Biaya: Tim konten yang menghasilkan 100 gambar per hari dapat menghemat 75% biaya dengan menggunakan kualitas medium dibandingkan high. Kami menyarankan untuk melakukan optimasi petunjuk menggunakan kualitas low melalui platform APIYI (apiyi.com) terlebih dahulu, lalu tingkatkan ke medium/high setelah hasil final disetujui. Ini dapat mengurangi anggaran pembuatan gambar bulanan sebesar 30-50%.

Pemilihan output_format Integrasi API Resmi gpt-image-2

Format output secara langsung mempengaruhi biaya penyimpanan dan kecepatan pemuatan:

# Butuh latar belakang transparan? gpt-image-2 tidak mendukung, akan menghasilkan error 400
# ✗ output_format="png", background="transparent" → 400 Bad Request

# Tampilan web/aplikasi: jpeg + kompresi 90
output_format="jpeg", output_compression=90

# Arsip fidelitas tinggi: png (lossless)
output_format="png"

# Aplikasi Web modern: webp dengan ukuran terkecil
output_format="webp", output_compression=85

Selain pembuatan gambar (teks ke gambar), gpt-image-2 juga mendukung tiga skenario pengeditan utama: pengeditan gambar, penggabungan banyak gambar, dan inpainting (pengisian bagian gambar yang hilang/diubah).

gpt-image-2-official-api-integration-guide-id 图示

Pengeditan gambar gpt-image-2 dengan API resmi (mode gambar referensi)

Pengeditan dengan gambar referensi akan secara otomatis mengaktifkan mode high-fidelity—jadi jangan sertakan parameter input_fidelity (karena akan ditolak).

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("APIYI_KEY"),
    base_url="https://api.apiyi.com/v1"
)

# Pengeditan satu gambar referensi
with open("source.jpg", "rb") as img:
    response = client.images.edit(
        model="gpt-image-2",
        image=img,
        prompt="Ubah latar belakang menjadi pantai saat matahari terbenam, pertahankan pose dan pakaian karakter di latar depan",
        size="1024x1024",
        quality="high"
    )

Penggabungan banyak gambar gpt-image-2 dengan API resmi (hingga 16 gambar)

Endpoint /images/edits mendukung input hingga 16 gambar referensi sekaligus, yang dapat dirujuk dalam prompt sebagai "Gambar 1/Gambar 2/Gambar 3".

images = [
    open("character.jpg", "rb"),     # Gambar 1: Karakter
    open("background.jpg", "rb"),    # Gambar 2: Latar belakang
    open("outfit.jpg", "rb"),        # Gambar 3: Referensi pakaian
]

response = client.images.edit(
    model="gpt-image-2",
    image=images,
    prompt="Tempatkan karakter dari Gambar 1 ke latar belakang Gambar 2, buat karakter mengenakan gaya pakaian dari Gambar 3, pertahankan kualitas sinematik",
    size="2048x1152",
    quality="high"
)

Kemampuan ini sangat kuat untuk skenario seperti penggantian latar belakang produk e-commerce, virtual try-on, hingga pembuatan storyboard komik.

Inpainting (局部重绘) gpt-image-2 dengan API resmi

Inpainting menentukan area yang akan digambar ulang melalui parameter mask. Aturan penting:

  • Mask harus memiliki dimensi yang sama dengan gambar referensi pertama.
  • Mask harus berupa file PNG dengan saluran alfa (alpha channel).
  • Area transparan = area yang akan digambar ulang.
  • Area tidak transparan = area yang dipertahankan dari gambar asli.
with open("photo.png", "rb") as img, open("mask.png", "rb") as msk:
    response = client.images.edit(
        model="gpt-image-2",
        image=img,
        mask=msk,
        prompt="Ganti area kotak merah dengan seekor kucing oranye",
        size="1024x1024",
        quality="high"
    )

Jika Anda perlu membuat mask secara terprogram di Python, Anda bisa menggunakan pustaka PIL:

from PIL import Image

# Buat mask dengan dimensi yang sama dengan gambar asli, default hitam (tidak transparan = pertahankan)
mask = Image.new("RGBA", (1024, 1024), (0, 0, 0, 255))

# Ubah area yang akan digambar ulang menjadi transparan (alpha=0)
for x in range(400, 700):
    for y in range(300, 600):
        mask.putpixel((x, y), (0, 0, 0, 0))

mask.save("mask.png")

Penanganan Error dan Praktik Produksi Integrasi API Resmi gpt-image-2

Saat membawa gpt-image-2 ke lingkungan produksi melalui API resmi, Anda wajib menangani tiga masalah utama: kode error, konkurensi, dan timeout.

Tabel Kode Error Lengkap Integrasi API Resmi gpt-image-2

Kode Status HTTP Arti Penanganan yang Disarankan
400 Parameter tidak valid (ukuran di luar batas, parameter tidak didukung) Validasi input; jangan kirim input_fidelity atau background:transparent
401 Token tidak valid Periksa Bearer Token, pastikan belum kedaluwarsa
403 Diblokir oleh moderasi konten Sesuaikan petunjuk, atau tambahkan moderation: "low"
429 Limit terlampaui / saldo tidak cukup Gunakan exponential backoff + cek saldo
5xx Error gateway atau backend Coba lagi 1-2 kali, jika masih gagal, kirim peringatan
Timeout Permintaan tertunda tidak merespons tepat waktu Atur timeout klien ke ≥ 360 detik

Exponential Backoff untuk Integrasi API Resmi gpt-image-2

Berikut adalah pembungkus (wrapper) percobaan ulang tingkat produksi untuk menangani error 429 dan 5xx:

import time
import random
from openai import OpenAI, RateLimitError, APIStatusError

client = OpenAI(
    api_key=os.getenv("APIYI_KEY"),
    base_url="https://api.apiyi.com/v1",
    timeout=600.0
)

def generate_with_retry(prompt: str, max_retries: int = 5):
    delay = 1.0
    for attempt in range(max_retries):
        try:
            return client.images.generate(
                model="gpt-image-2",
                prompt=prompt,
                size="1024x1024",
                quality="high"
            )
        except RateLimitError:
            sleep = delay + random.uniform(0, 0.5)
            print(f"429 Limit terlampaui, coba lagi setelah {sleep:.1f} detik ({attempt+1}/{max_retries})")
            time.sleep(sleep)
            delay *= 2
        except APIStatusError as e:
            if 500 <= e.status_code < 600 and attempt < max_retries - 1:
                time.sleep(delay)
                delay *= 2
                continue
            raise
    raise RuntimeError("Melebihi jumlah percobaan ulang maksimum")

Kontrol Konkurensi Integrasi API Resmi gpt-image-2

Untuk tugas batch, gunakan asyncio.Semaphore guna membatasi jumlah konkurensi agar tidak membebani sistem hilir secara mendadak:

import asyncio
from openai import AsyncOpenAI

aclient = AsyncOpenAI(
    api_key=os.getenv("APIYI_KEY"),
    base_url="https://api.apiyi.com/v1",
    timeout=600.0
)

async def gen_one(prompt: str, sem: asyncio.Semaphore):
    async with sem:
        return await aclient.images.generate(
            model="gpt-image-2",
            prompt=prompt,
            size="1024x1024",
            quality="medium"
        )

async def batch(prompts: list[str], concurrency: int = 30):
    sem = asyncio.Semaphore(concurrency)
    return await asyncio.gather(*[gen_one(p, sem) for p in prompts])

# Menjalankan 200 gambar, 30 konkurensi
prompts = [f"Variasi gambar skenario produk #{i}" for i in range(200)]
results = asyncio.run(batch(prompts))

Estimasi Biaya Integrasi API Resmi gpt-image-2

Lakukan estimasi biaya sebelum masuk ke tahap produksi. Berikut adalah estimasi biaya bulanan untuk beberapa skenario umum:

Skenario Bisnis Volume Harian Kualitas Estimasi Biaya Bulanan
Gambar media sosial 30 gambar medium ~$48
Gambar produk e-commerce 200 gambar high ~$1266
Pembuatan gambar pengguna SaaS 1000 kali medium ~$1590
Frame kunci game 500 gambar high ~$3165

🎯 Saran Deployment Produksi: Disarankan untuk mengajukan kunci API terpisah bagi setiap lini bisnis guna memudahkan atribusi biaya dan isolasi limit. Kami menyarankan untuk mengaktifkan peringatan tagihan melalui konsol APIYI apiyi.com agar Anda mendapatkan notifikasi otomatis saat penggunaan bulanan mencapai ambang batas, guna menghindari pembengkakan anggaran.

Observabilitas Integrasi API Resmi gpt-image-2

Pastikan untuk mencatat metrik utama setiap permintaan di lingkungan produksi:

import time
import logging

logger = logging.getLogger("gpt-image-2")

def call_with_metrics(prompt: str, **params):
    start = time.perf_counter()
    try:
        resp = client.images.generate(model="gpt-image-2", prompt=prompt, **params)
        latency = time.perf_counter() - start
        logger.info(
            "gpt-image-2 berhasil",
            extra={
                "latency_ms": int(latency * 1000),
                "size": params.get("size"),
                "quality": params.get("quality"),
                "n": params.get("n", 1)
            }
        )
        return resp
    except Exception as e:
        logger.error(f"gpt-image-2 gagal: {type(e).__name__}: {e}")
        raise

FAQ Seputar Integrasi API Resmi gpt-image-2

Q1: Mengapa muncul error 400 saat menggunakan input_fidelity pada integrasi API resmi gpt-image-2?

gpt-image-2 secara otomatis mengaktifkan high-fidelity di semua skenario pengeditan, sehingga parameter input_fidelity ditolak. Cukup hapus parameter tersebut. Jika kode Anda dimigrasi dari gpt-image-1, lakukan pencarian global untuk menghapusnya. Kami menyarankan untuk membandingkan perbedaan parameter model lama dan baru melalui dokumentasi APIYI di docs.apiyi.com.

Q2: Mengapa pemanggilan API resmi gpt-image-2 sering mengalami timeout?

Kualitas high + gambar 2K/4K membutuhkan waktu 3-5 menit. Jika timeout default klien adalah 60 detik, maka pasti akan gagal. Solusi: Atur timeout ke 360-600 detik. Python SDK menggunakan OpenAI(timeout=600), Node.js menggunakan timeout: 600_000, dan cURL menggunakan --max-time 600.

Q3: Bagaimana cara menampilkan b64_json dari API resmi gpt-image-2 langsung di halaman web?

API mengembalikan string base64 murni tanpa awalan, sehingga browser tidak bisa langsung merendernya. Anda perlu menyambungkannya:

const dataUri = `data:image/${format};base64,${b64}`;
imgElement.src = dataUri;

Jika menggunakan layanan backend, disarankan untuk mendekode base64 dan menyimpannya ke OSS/CDN, lalu frontend hanya menerima URL agar string base64 tidak memenuhi HTML dan memengaruhi kecepatan pemuatan awal. Kami menyarankan untuk menguji melalui platform APIYI apiyi.com menggunakan cURL + dekode base64 ke file lokal untuk memastikan alur lancar sebelum mengintegrasikan arsitektur penyimpanan dan distribusi yang lengkap.

Q4: Apakah integrasi API resmi gpt-image-2 mendukung latar belakang transparan?

Saat ini gpt-image-2 tidak mendukung latar belakang transparan; mengirim background: "transparent" akan ditolak dengan error 400. Solusi alternatif: buat gambar dengan latar belakang putih/hijau polos, lalu gunakan alat klien (seperti pustaka rembg) untuk menghapus latar belakang.

Q5: Bagaimana cara menggunakan parameter thinking pada integrasi API resmi gpt-image-2?

thinking adalah parameter penalaran yang diperkenalkan di gpt-image-2 (off / low / medium / high). Jika diaktifkan, model akan merencanakan tata letak sebelum menghasilkan gambar. Kualitasnya lebih tinggi, namun biaya akan meningkat signifikan (mode high sekitar 4-5 kali lipat dari harga dasar). Saran: Gunakan medium hanya untuk poster padat teks atau komposisi kompleks; untuk skenario biasa, biarkan tetap off. Kami menyarankan untuk melakukan A/B testing melalui antarmuka terpadu APIYI apiyi.com sebelum memutuskan untuk mengaktifkannya secara permanen.

Q6: Apa yang harus dilakukan jika menemui error 403 moderasi konten saat integrasi API resmi gpt-image-2?

Coba tambahkan moderation: "low" dalam permintaan untuk menurunkan sensitivitas. Jika masih diblokir, berarti petunjuk Anda memicu kebijakan keamanan inti (melibatkan kekerasan, konten tidak pantas untuk anak di bawah umur, potret tokoh terkenal, dll.) dan Anda perlu menulis ulang petunjuk tersebut. Catatan: moderation: "low" tidak mematikan moderasi, hanya melonggarkannya; konten berisiko tinggi tetap akan diblokir.

Q7: Apa yang terjadi jika base_url pada integrasi API resmi gpt-image-2 salah tulis?

Jika ditulis sebagai https://api.apiyi.com (tanpa /v1), SDK akan menggabungkannya menjadi api.apiyi.com/images/generations yang menyebabkan error 404. Penulisan yang benar adalah https://api.apiyi.com/v1. Python menggunakan base_url, Node.js menggunakan baseURL (camelCase), pastikan huruf besar/kecil benar.

Q8: Apa praktik terbaik untuk penggabungan banyak gambar pada integrasi API resmi gpt-image-2?

Mendukung hingga 16 gambar referensi, gunakan "Gambar 1/Gambar 2" dalam petunjuk untuk merujuknya. Tips kunci:

  1. Gambar referensi pertama biasanya digunakan sebagai "subjek utama", model akan memprioritaskan pelestarian strukturnya.
  2. Instruksi kompleks bisa dilakukan bertahap: tulis "Gunakan Gambar 1 sebagai subjek utama", lalu "Gabungkan dengan nada warna Gambar 2".
  3. Biaya pengeditan banyak gambar adalah 1,5-2 kali lipat dari teks ke gambar, gunakan dengan bijak jika anggaran terbatas.
  4. Disarankan untuk menjalankan logika dengan 2-3 gambar terlebih dahulu sebelum memperluas ke lebih banyak gambar referensi.

Ringkasan: Tinjauan Lengkap Jalur Integrasi API Resmi gpt-image-2

Setelah menyelesaikan 9 bab dalam artikel ini, Anda seharusnya sudah menguasai metode teknis lengkap untuk mengintegrasikan API resmi gpt-image-2:

  1. ✅ Persiapan —— Tingkatkan SDK ke versi terbaru, atur waktu tunggu (timeout) ke ≥ 360 detik.
  2. ✅ Konfigurasi base_url —— Ganti dengan https://api.apiyi.com/v1, kode lainnya tetap sama dengan standar resmi.
  3. ✅ Pemanggilan teks ke gambar —— Templat untuk tiga bahasa: Python/Node.js/cURL.
  4. ✅ Penjelasan parameter —— 8 preset ukuran + kustom, 3 tingkat kualitas, dan 3 pilihan format output.
  5. ✅ Pengeditan gambar —— Mendukung hingga 16 gambar referensi, gunakan "Gambar1/Gambar2" dalam petunjuk.
  6. ✅ Inpainting (Pengecatan Ulang) —— Menggunakan saluran alpha mask, pengecatan ulang pada area transparan.
  7. ✅ Penanganan error —— Solusi lengkap untuk kode error 400/401/403/429/5xx.
  8. ✅ Praktik produksi —— Exponential backoff, kontrol konkurensi, estimasi biaya, dan observabilitas.

Saran implementasi terakhir: Jalankan "hello world" terlebih dahulu menggunakan kualitas low + 1024×1024, baru kemudian tingkatkan kompleksitasnya secara bertahap. Cara ini membantu Anda menemukan masalah dasar seperti versi SDK, timeout, atau kunci API dengan cepat, sehingga Anda tidak membuang waktu debugging pada permintaan high quality + 4K yang memakan waktu lama.

Jika tim Anda sedang mengevaluasi solusi integrasi gpt-image-2, atau sudah menulis kode versi pertama namun menemui error parameter atau timeout, disarankan untuk segera mengajukan kunci API uji coba melalui APIYI di apiyi.com untuk menjalankan templat kode dalam artikel ini. Semua contoh didasarkan pada SDK resmi + layanan proksi API APIYI (bidang 100% konsisten), sehingga sangat universal dan dapat langsung digunakan kembali dalam proyek Anda.

Referensi

  1. Dokumentasi Model OpenAI gpt-image-2: Penjelasan resmi mengenai kemampuan model, parameter, dan harga.

    • Tautan: developers.openai.com/api/docs/models/gpt-image-2
    • Keterangan: Berisi fitur inti seperti rendering 4K, teks tingkat karakter, dan integrasi penalaran.

  2. Panduan Pembuatan Gambar OpenAI: Alur kerja lengkap untuk teks ke gambar, pengeditan, dan inpainting.

    • Tautan: developers.openai.com/api/docs/guides/image-generation
    • Keterangan: Mencakup penjelasan detail semua parameter ukuran/kualitas/format.

  3. Referensi API Create Image OpenAI: Bidang lengkap untuk endpoint /v1/images/generations.

    • Tautan: developers.openai.com/api/reference/resources/images/methods/generate
    • Keterangan: Referensi resmi untuk bidang permintaan/respons.

  4. Dokumentasi Integrasi Resmi APIYI: Panduan integrasi lengkap gpt-image-2 dalam bahasa Indonesia.

    • Tautan: docs.apiyi.com/api-capabilities/gpt-image-2/overview
    • Keterangan: Berisi contoh cURL/Python/Node.js dan penanganan kode error.

  5. OpenAI Cookbook · Rate Limits: Solusi exponential backoff untuk error 429.

    • Tautan: developers.openai.com/cookbook/examples/how_to_handle_rate_limits
    • Keterangan: Templat kode penanganan limitasi laju yang direkomendasikan secara resmi.

Penulis: Tim Teknis APIYI
Tanggal Publikasi: 27 April 2026
Kata Kunci: integrasi API resmi gpt-image-2, base_url, teks ke gambar, pengeditan gambar, inpainting, APIYI, SDK OpenAI

Tinggalkan komentar