Panduan API GPT-Image-2

GPT-Image-2 — API Generasi Gambar OpenAI

Akses model generasi gambar terbaru OpenAI melalui API terpadu TokenHub. Sepenuhnya OpenAI-compatible, dengan respons sinkron (tanpa perlu polling), berbagai ukuran hingga 4K, tingkat kualitas, dan format output PNG/JPEG/WebP. Mendukung text-to-image (t2i) dan image-to-image editing (i2i, komposisi multi-gambar & inpainting). Panduan ini menjelaskan integrasi lengkapnya.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Dapatkan API Key Anda

Kunjungi tokenhub.store untuk membuat akun (login GitHub / Google didukung)
Buka Dashboard → API Keys, klik "Create New Key"
Buka Dashboard → Billing untuk menambahkan Credits (1 Credit = $1 USD)
Salin API Key Anda (format: th-xxxxxxxxxxxx...)

⚠️ API Key hanya ditampilkan sekali saat dibuat. Simpan dengan aman. Jika hilang, Anda perlu membuat yang baru.

2Ikhtisar API

Base URL

https://tokenhub.store/api/v1

Autentikasi

Semua request memerlukan API Key di header:

Header

Authorization: Bearer th-your-api-key

Endpoint (Sinkron, OpenAI-compatible)

POST

/images/generations

Text-to-image. Hasilkan gambar dari prompt teks.

POST

/images/edits

Image-to-image editing. Mendukung edit satu gambar, komposisi multi-gambar, dan inpainting opsional dengan mask.

3Harga

Tingkat	Harga	Rentang resolusi
1K	$0.125 / image	Sisi terpanjang ≤ 1536 px (mis. 1024×1024, 1024×1536)
2K	$0.250 / image	Sisi terpanjang ≤ 2048 px (mis. 2048×2048)
4K	$0.500 / image	Sisi terpanjang > 2048 px (mis. 4096×4096)

Harga tetap per gambar berdasarkan tier resolusi output (ditentukan oleh sisi terpanjang ukuran). n gambar = harga satuan × n. Panggilan yang gagal tidak dikenakan biaya.

Pemetaan tier berdasarkan sisi terpanjang: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Contoh: 1024×1024 dan 1024×1536 keduanya 1K; 2048×2048 adalah 2K; 4096×4096 adalah 4K.

4Parameter Permintaan

Parameter	Tipe	Wajib	Default	Deskripsi
model	string	Wajib	—	ID model. Gunakan "openai/gpt-image-2" (atau bentuk singkat "gpt-image-2").
prompt	string	Wajib	—	Prompt teks yang menjelaskan gambar yang akan dibuat.
n	integer	Opsional	1	Jumlah gambar yang akan dibuat (1–10).
size	string	Opsional	1024x1024	Dimensi output. Opsi: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Opsional	auto	Kualitas generasi. Opsi: auto, low, medium, high. Kualitas lebih tinggi menggunakan lebih banyak token.
format	string	Opsional	png	Format gambar output. Opsi: png, jpeg, webp.

Field tambahan untuk /images/edits (i2i)

Parameter	Tipe	Wajib	Default	Deskripsi
image	file / string \| array	Wajib	—	Gambar input yang akan diedit. Menerima file melalui multipart, atau URL / data URI base64 dalam JSON. Dapat menyediakan beberapa gambar untuk digabungkan menjadi satu output.
mask	file / string	Opsional	—	Mask inpainting opsional. Area transparan akan dibuat ulang; area opak dipertahankan.
input_fidelity	string	Opsional	low	Seberapa dekat mempertahankan input. Opsi: low, high. Gunakan high untuk menjaga identitas/tata letak; gunakan low untuk transformasi yang lebih berani.
output_format	string	Opsional	png	Alias dari 'format' untuk endpoint edit. Opsi: png, jpeg, webp.
output_compression	integer	Opsional	100	Tingkat kompresi 0–100 (hanya untuk jpeg / webp).

5Contoh curl Lengkap

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Respons:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Contoh Lengkap Python

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Contoh Lengkap JavaScript / Node.js

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Tips Penggunaan

Prompt dalam bahasa Inggris biasanya memberikan hasil terbaik; bahasa Mandarin juga didukung.
data[].url pada respons bisa berupa URL https biasa atau data URI (base64). Tangani kedua kasus saat menyimpan ke disk.
Untuk menekan biaya, gunakan kualitas low/medium untuk draft dan hanya gunakan ukuran high/4K untuk output final.
Endpoint ini sinkron — tidak ada task id, tidak ada polling. Permintaan biasanya selesai dalam 5–30 detik tergantung ukuran dan kualitas.
Atur timeout HTTP di sisi klien ke ≥ 120s agar tidak terputus terlalu cepat pada gambar berukuran besar.

9FAQ

Siap Memulai?

Daftar di TokenHub dan mulai menggunakan GPT-Image-2 API sekarang

Dapatkan API Key Isi Ulang Credits