GPT-Image-2 API qo‘llanmasi

GPT-Image-2 — OpenAI Image Generation API

TokenHub yagona API orqali OpenAI'ning eng so‘nggi image generation modeliga murojaat qiling. To‘liq OpenAI-compatible, sinxron javob bilan (polling kerak emas), 4K gacha bo‘lgan bir nechta o‘lchamlar, sifat darajalari va PNG/JPEG/WebP output formatlarini qo‘llab-quvvatlaydi. Ham text-to-image (t2i), ham image-to-image editing (i2i, multi-image composition va inpainting) mavjud. Ushbu qo‘llanma sizni integratsiyaning to‘liq jarayoni bo‘ylab olib boradi.

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

1API Key oling

Akkount yaratish uchun tokenhub.store ga tashrif buyuring (GitHub / Google orqali kirish qo‘llab-quvvatlanadi)
Dashboard → API Keys ga o‘ting va "Create New Key" ni bosing
Credits qo‘shish uchun Dashboard → Billing ga o‘ting (1 Credit = $1 USD)
API Key ni nusxalang (format: th-xxxxxxxxxxxx...)

⚠️ API Key faqat yaratilganda bir marta ko‘rsatiladi. Uni xavfsiz saqlang. Agar yo‘qolsa, yangisini yaratishingiz kerak bo‘ladi.

2API umumiy ko‘rinishi

Base URL

https://tokenhub.store/api/v1

Autentifikatsiya

Barcha so‘rovlar headerda API Key talab qiladi:

Header

Authorization: Bearer th-your-api-key

Endpointlar (Sinxron, OpenAI-compatible)

POST

/images/generations

Text-to-image. Matn promptidan image yarating.

POST

/images/edits

Image-to-image editing. Bitta image tahriri, multi-image composition va mask bilan ixtiyoriy inpaintingni qo‘llab-quvvatlaydi.

3Narxlash

Daraja	Narx	Rezolyutsiya diapazoni
1K	$0.125 / image	Eng uzun tomoni ≤ 1536 px (masalan, 1024×1024, 1024×1536)
2K	$0.250 / image	Eng uzun tomoni ≤ 2048 px (masalan, 2048×2048)
4K	$0.500 / image	Eng uzun tomoni > 2048 px (masalan, 4096×4096)

Chiqish o‘lcham darajasiga asoslangan, tasvir boshiga qat’iy narxlash (daraja tasvirning eng uzun tomoni bo‘yicha aniqlanadi). n ta tasvir = birlik narxi × n. Muvaffaqiyatsiz chaqiriqlar uchun haq olinmaydi.

Eng uzun tomon bo‘yicha daraja mosligi: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Misollar: 1024×1024 va 1024×1536 ikkalasi ham 1K; 2048×2048 — 2K; 4096×4096 — 4K.

4So‘rov parametrlari

Parametr	Turi	Majburiy	Standart	Tavsif
model	string	Majburiy	—	Model ID. "openai/gpt-image-2" (yoki qisqa shakl "gpt-image-2") dan foydalaning.
prompt	string	Majburiy	—	Yaratiladigan tasvirni tasvirlaydigan matnli prompt.
n	integer	Ixtiyoriy	1	Yaratiladigan tasvirlar soni (1–10).
size	string	Ixtiyoriy	1024x1024	Chiqish o‘lchamlari. Variantlar: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Ixtiyoriy	auto	Yaratish sifati. Variantlar: auto, low, medium, high. Yuqoriroq sifat ko‘proq Tokens sarflaydi.
format	string	Ixtiyoriy	png	Chiqish tasviri formati. Variantlar: png, jpeg, webp.

/images/edits (i2i) uchun qo‘shimcha maydonlar

Parametr	Turi	Majburiy	Standart	Tavsif
image	file / string \| array	Majburiy	—	Tahrirlash uchun kirish tasvir(lar)i. multipart orqali fayl(lar)ni yoki JSON ichida URL / base64 data URI ni qabul qiladi. Bir nechta tasvir bersangiz, ular bitta chiqishga birlashtiriladi.
mask	file / string	Ixtiyoriy	—	Ixtiyoriy inpainting maskasi. Shaffof joylar qayta yaratiladi; opak joylar saqlanadi.
input_fidelity	string	Ixtiyoriy	low	Kirishni qanchalik yaqin saqlash kerakligi. Variantlar: low, high. Identitet/tartibni saqlash uchun high ni, dadilroq o‘zgartirishlar uchun low ni ishlating.
output_format	string	Ixtiyoriy	png	Edit endpoint uchun 'format' ning aliasi. Variantlar: png, jpeg, webp.
output_compression	integer	Ixtiyoriy	100	Siqish darajasi 0–100 (faqat jpeg / webp uchun).

5To‘liq curl namunasi

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"
  }'

Javob:

json

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

6Python uchun to‘liq misol

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], "...")

7JavaScript / Node.js uchun to‘liq misol

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), "...");

8Foydali maslahatlar

Odatda inglizcha promptlar eng yaxshi natija beradi; xitoy tili ham qo‘llab-quvvatlanadi.
Response data[].url oddiy https URL yoki data URI (base64) bo‘lishi mumkin. Diskka saqlashda ikkala holatni ham qayta ishlang.
Xarajatni kamaytirish uchun qoralamalarida low/medium sifatni ishlating va faqat yakuniy natija uchun high/4K o‘lchamlaridan foydalaning.
Endpoint sinxron ishlaydi — task id ham, polling ham yo‘q. So‘rov odatda o‘lcham va sifatga qarab 5–30 soniyada yakunlanadi.
Katta tasvirlarda muddatidan oldin uzilib qolmaslik uchun mijoz tomonda HTTP timeout ni ≥ 120s qilib o‘rnating.

9FAQ

Boshlashga tayyormisiz?

TokenHub ga ro‘yxatdan o‘ting va GPT-Image-2 API dan hozir foydalanishni boshlang

API Key oling Creditsni to‘ldirish