APIMart API orqali GPT Image 2.5 yordamida tasvirlar yaratish

Bu loyiha nimalarni taqdim etadi

image2.5 Prompt Gallery GPT Image 2.5 orqali ishga tushirilgan va natijada olingan rasmlar bilan birga e’lon qilingan 12 ta promptdan iborat amaliy to‘plamdir. Har bir retsept prompt, model versiyasi, tomonlar nisbati va natijani qayd etadi. Bu promptni o‘zingizning ilovangizga moslashtirishdan oldin baholashni osonlashtiradi.

Misollarda https://api.apimart.ai/v1 manzilidagi APIMart’ning OpenAI bilan mos keluvchi endpointidan foydalaniladi. Relay qilingan yo‘nalish asinxron ishlaydi: ilovangiz rasm so‘rovini yuboradi, vazifa identifikatorini oladi, vazifa endpointini tekshiradi va qayta ishlash tugagach rasmni yuklab oladi.

Asosiy imkoniyatlar

• OpenAI bilan mos generatsiya yo‘li: so‘rovlar POST /v1/images/generations manziliga yuboriladi.
• Ikki relay varianti: kundalik generatsiya uchun version: "flare" yoki tahrirlash va referens asosidagi ishlar uchun version: "sunburst" dan foydalaning.
• Bir nechta chiqish darajasi: 1K, 2K yoki 4K ni tanlang.
• Moslashuvchan kadr: auto yoki qo‘llab-quvvatlanadigan o‘nta tomonlar nisbatidan birini, jumladan 1:1, 16:9, 9:16 va 4:3 ni ishlating.
• Ommaviy chiqish: n yordamida birdan to‘rttagacha rasm so‘rang.
• Referens rasmini qo‘llab-quvvatlash: image_urls ichida 16 tagacha URL yoki data URL taqdim eting.
• Har bir chaqiruv bo‘yicha xarajat hisoboti: tugallangan vazifa ma’lumotlarida cost va credits_cost mavjud bo‘ladi.
• Idempotent qayta urinishlar: API bir xil yuborishni qayta amalga oshirganda takroriy ishlarning oldini olishga yordam beruvchi Idempotency-Key sarlavhasini qabul qiladi.

To‘g‘ri model yo‘nalishini tanlang

APIMart relay qilingan va rasmiy GPT Image 2.5 yo‘nalishlarini taqdim etadi. Ularning so‘rov maydonlari va hisob-kitob usullari farq qiladi, shuning uchun integratsiyani yozishdan oldin yo‘nalishni tanlang.

Relay qilingan, har bir rasm uchun yo‘nalish

model ni gpt-image-2.5-ext ga o‘rnating va version: "flare" yoki version: "sunburst" ni kiriting. Galereya misollarida ishlatiladigan bu yo‘nalishda haq har bir yetkazilgan rasm uchun olinadi.

• flare: kundalik generatsiyalar va ommaviy qoralamalar uchun mos.
• sunburst: tahrirlash aniqligi hamda referenslar, obyektlar, logotiplar yoki mahsulot yorliqlarini saqlash zarur bo‘lgan ishlar uchun mos.

Rasmiy, token asosida hisoblanadigan yo‘nalish

Bevosita gpt-image-2.5-flare yoki gpt-image-2.5-sunburst dan foydalaning. Bu model identifikatorlari bilan version maydonini yubormang. Rasmiy yo‘nalishda haq tokenlar asosida olinadi; u low dan max gacha bo‘lgan sifat darajalarini, shuningdek aniq piksel o‘lchamlarini qo‘llab-quvvatlaydi.

Yo‘nalish formatlarini aralashtirmang. gpt-image-2.5-ext taxallusi versiya tanlagichni talab qiladi, rasmiy model identifikatorlari esa uni o‘z ichiga olmasligi kerak.

O‘rnatish va sozlash

1. Hisob yarating va mablag‘ kiriting

API kalitini APIMart kalitlar sahifasidan oling. Repozitoriy ma’lumotlariga ko‘ra, xizmat bepul kvotaga ega emas va $1 dan boshlab hisobni to‘ldirishni qo‘llab-quvvatlaydi.

2. Kalitni muhit o‘zgaruvchisida saqlang

export APIMART_API_KEY="your-api-key"

Kalitni to‘g‘ridan-to‘g‘ri ilova manba kodiga joylashtirmang yoki uni versiyalarni boshqarish tizimiga yubormang.

3. Python bog‘liqligini o‘rnating

Python misolida uchinchi tomonning requests paketi ishlatiladi.

python -m pip install requests

Agar curl’dan foydalanishni ma’qul ko‘rsangiz, qobiq muhitida curl va uuidgen kabi UUID generatori mavjudligiga ishonch hosil qiling.

curl yordamida ilk rasm so‘rovingizni yuboring

Quyidagi so‘rov relay qilingan flare varianti bilan kvadrat 1K rasm yaratadi:

IDEMPOTENCY_KEY="$(uuidgen)"
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --header "X-APIMart-Response-Version: 2026-07-27" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{
    "model": "gpt-image-2.5-ext",
    "version": "flare",
    "prompt": "A cozy reading nook beside a window on a rainy day, warm table lamp, cinematic lighting",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Muvaffaqiyatli yuborish 202 HTTP javobini qaytaradi. Vazifa identifikatorini data.id dan o‘qing yoki qaytarilgan data.poll_url dan foydalaning.

Vazifani tekshiring

curl --request GET \
  --url "https://api.apimart.ai/v1/tasks/TASK_ID" \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "X-APIMart-Response-Version: 2026-07-27"

Vazifa odatda pending holatidan processing holatiga o‘tadi, so‘ng completed yoki failed holatida yakunlanadi. Yakunlangach, yaratilgan URL manzillarni result.images[].url dan oling.

Yaratilgan rasm URL manzillarida expires_at vaqt tamg‘asi mavjud. Har bir faylni URL muddati tugashidan oldin yuklab oling va saqlang.

To‘liq Python mijozini yarating

Bu misol bitta so‘rov yuboradi, HTTP xatolarini tekshiradi, har besh soniyada vazifani tekshiradi va yakunlangan vazifa yozuvini qaytaradi. Har bir yangi generatsiya uchun yangi idempotentlik kalitini yaratadi.

import os
import time
import uuid
import requests

BASE_URL = "https://api.apimart.ai/v1"
API_KEY = os.environ["APIMART_API_KEY"]

COMMON_HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "X-APIMart-Response-Version": "2026-07-27",
}

def generate_image(prompt, version="flare", resolution="1K", size="1:1"):
    submit_headers = {
        **COMMON_HEADERS,
        "Idempotency-Key": str(uuid.uuid4()),
    }

    response = requests.post(
        f"{BASE_URL}/images/generations",
        headers=submit_headers,
        timeout=60,
        json={
            "model": "gpt-image-2.5-ext",
            "version": version,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
        },
    )
    response.raise_for_status()
    task_id = response.json()["data"]["id"]

    while True:
        poll_response = requests.get(
            f"{BASE_URL}/tasks/{task_id}",
            headers=COMMON_HEADERS,
            timeout=60,
        )
        poll_response.raise_for_status()
        task = poll_response.json()["data"]

        if task["status"] == "completed":
            return task
        if task["status"] == "failed":
            raise RuntimeError(f"Generation failed: {task}")

        time.sleep(5)

result = generate_image(
    "Studio product hero of a matte ceramic espresso cup on a warm stone pedestal, soft window light, 85mm lens look, minimal beige backdrop, crisp shadow"
)

print("Cost:", result.get("cost"))
for image in result["result"]["images"]:
    print("Image URL:", image["url"])
    print("Expires at:", image.get("expires_at"))

Xavfsiz qayta urinish

Agar yuborish jarayoni vaqt tugashi sababli to‘xtasa yoki qayta urinish mumkin bo‘lgan javob qaytsa, xuddi shu mantiqiy so‘rovni ayni Idempotency-Key bilan qayta yuboring. Yangi rasmni ataylab yaratishda yangi kalitdan foydalaning. Agar tugallangan vazifa manbasi yoki referensi o‘zgargani sababli qayta yaratilishi kerak bo‘lsa, yangi kalitdan ham foydalaning.

Asosiy so‘rov maydonlarini tushunish

• model: majburiy; uzatiladigan yo‘nalish uchun gpt-image-2.5-ext dan foydalaning.
• version: flare yoki sunburst; standart qiymati flare.
• prompt: majburiy va bo‘sh joylardan iborat bo‘lmagan matnni o‘z ichiga olishi kerak.
• resolution: 1K, 2K yoki 4K; standart qiymati 1K.
• size: standart qiymati auto. Qo‘llab-quvvatlanadigan nisbatlar: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 va 21:9.
• n: uzatiladigan yo‘nalishda birdan to‘rtgacha bo‘lgan rasmlar soni.
• image_urls: ko‘pi bilan 16 ta rasm URL manzili yoki data URL manzilini o‘z ichiga olishi mumkin bo‘lgan ixtiyoriy massiv.

Ishonchliroq promptlar yozish

Galereya promptni noaniq sifatlar ro‘yxati sifatida emas, balki ixcham ishlab chiqarish topshirig‘i sifatida ko‘radi. Foydali tuzilma: obyekt, material, yoritish, kadr yoki obyektiv va yakuniy uslub.

1. Obyektni nomlang: asosiy buyum, shaxs, sahna yoki muhitni aniqlang.
2. Jismoniy materiallarni belgilang: matte ceramic, frosted glass yoki clay render kabi iboralardan foydalaning.
3. Yoritishni belgilang: yumshoq deraza nuri, tabiiy yon yorug‘lik, yuqori kalitli studiya yoritishi yoki dramatik orqa yoritishni tasvirlang.
4. Kadrni aniq belgilang: markazlashtirilgan kompozitsiya, yuqoridan olingan flat lay, keng kinematik kompozitsiya yoki boshqa ko‘zlangan joylashuvni ko‘rsating.
5. Obyektiv tilini qo‘shing: 85mm, 24mm, macro va focus stacked kabi atamalar perspektiva hamda tafsilotlarni boshqarishga yordam beradi.
6. Yakuniy uslubni tanlang: rassomona tafsilot, tijoriy mahsulot fotosurati yoki aniq vektor qirralari kabi iboralar vizual ishlovni boshqaradi.

Masalan:

Cosmetics packshot of a frosted glass bottle with amber serum,
water droplets on the surface, seamless pale pink backdrop,
high detail commercial product photography

Referens rasmlardan foydalanish

Rasmdan rasmga o‘tkazish yoki referensga asoslangan ish uchun uzatiladigan so‘rovga image_urls massivini qo‘shing. Yo‘nalish ko‘pi bilan 16 ta referensni qabul qiladi.

{
  "model": "gpt-image-2.5-ext",
  "version": "sunburst",
  "prompt": "Preserve the product and label, replace the background with soft off-white, and add a natural cast shadow",
  "image_urls": [
    "https://example.com/product-reference.jpg"
  ],
  "size": "1:1",
  "resolution": "2K",
  "n": 1
}

Barqaror va foydalanish mumkin bo‘lgan referens URL manzillaridan foydalaning. Agar vazifa referens URL manzilining muddati tugagani sababli bajarilmasa, rasmni boshqa hostingga joylang va yangi idempotentlik kaliti bilan yangi vazifa yuboring.

Rasmiy yo‘nalishga murojaat qilish

Rasmiy yo‘nalishda uzatiladigan yo‘nalishdagi version tanlagichi o‘rniga bevosita model identifikatori va quality sozlamasidan foydalaniladi.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "Preserve the product label, replace the background with soft off-white, add a natural cast shadow",
    "size": "1:1",
    "resolution": "1k",
    "quality": "high",
    "n": 1
  }'

Joriy maydon tafsilotlari uchun rasmiy yo‘nalish hujjatlari va rele qilingan yo‘nalish hujjatlari bilan tanishing.

Ilg‘or ishlab chiqarish bo‘yicha maslahatlar

Yuborishni qayta ishlashdan ajrating

Qaytarilgan vazifa identifikatorini veb-so‘rovni ochiq holda ushlab turish o‘rniga navbat yoki ma’lumotlar bazasida saqlang. Fon ishchisi tugallanmagan vazifalarni tekshirishi va yakunlangan natijalarni saqlashi mumkin.

O‘rtacha tekshirish intervallaridan foydalaning

Repository misollarida har besh soniyada tekshiruv amalga oshiriladi. Keraksiz trafik yaratadigan zich sikllardan saqlaning. Kattaroq ish yuklamalari uchun vazifa kutilayotgan yoki qayta ishlanayotgan vaqtda intervalni bosqichma-bosqich oshiring.

Haqiqiy xarajatlarni qayd eting

Har bir yakunlangan vazifadan cost yoki credits_cost qiymatini saqlang. Bu faqat taxminlarga tayanish o‘rniga har bir chaqiruv bo‘yicha xarajatlar qaydini beradi.

README hujjatida yetkazilgan 1K tasvir uchun $0.0085, 2K uchun $0.014 va 4K flare uchun $0.021 miqdoridagi kuzatilgan rele yo‘nalishi narxi ko‘rsatilgan. 4K sunburst narxi jadvalda belgilanmagan. Bu raqamlar 2026-yil sentyabrida kuzatilgan, shuning uchun budjet tuzish yoki ko‘lamni oshirishdan oldin joriy narxlarni tekshiring.

Natijalarni darhol yuklab oling

result.images[].url manzilini doimiy saqlash joyi deb qaramang. Faylni expires_at vaqtidan oldin yuklab oling, so‘ng uni ilovangiz boshqaradigan saqlash joyiga ko‘chiring.

Kengaytirishdan oldin kichikdan boshlang

Promptni 1K va n: 1 bilan tekshiring. Obyekt, kompozitsiya va uslub barqarorlashgandan keyingina ruxsatni oshiring yoki bir nechta natija so‘rang.

Tomonlar nisbatini maqsadga moslang

• Ikonkalar, mahsulot kartalari va kvadrat ijtimoiy tarmoq materiallari uchun 1:1.
• Kinematik sahnalar, boshqaruv panellari va taqdimot sarlavhalari uchun 16:9.
• Vertikal mobil va ijtimoiy tarmoq maketlari uchun 9:16.
• Tahririy illustratsiyalar va taomlar fotosurati uchun 4:3.
• Portretlar va moda kompozitsiyalari uchun 3:4.

Muammolarni bartaraf etish

• 401 yoki yaroqsiz API kaliti: kalitni qayta nusxalang va unda bo‘sh joylar yoki yangi qator belgilar bor-yo‘qligini tekshiring. Sarlavhada Authorization: Bearer $APIMART_API_KEY ishlatilishi kerak.
• Balans yoki kredit xatosi: hisobga mablag‘ qo‘shing; repository ma’lumotlariga ko‘ra, bepul zaxira kvotasi mavjud emas.
• 429 javobi: parallellikni kamaytiring, kutish vaqtini oshiring va ayni idempotentlik kaliti bilan o‘sha yuborishni qayta urinib ko‘ring.
• 400 yoki model topilmadi: gpt-image-2.5-ext versiyani o‘z ichiga olganini, bevosita rasmiy model identifikatorlari esa versiyani o‘z ichiga olmasligini tekshiring.
• Vazifa holati failed: prompt rad etilganini yoki havola qilingan URL muddati tugaganini tekshiring. Kiritilgan ma’lumotni tuzating va yangi kalit bilan yangi vazifa yuboring.
• Chiqish URL manzili ishlamayapti: vaqtinchalik URL muddati tugagan bo‘lishi mumkin. Kelajakda yakunlangan natijalarni tezda yuklab oling.

Xulosa

image2.5 Prompt Gallery GPT Image 2.5 yordamida materiallar yaratishning takrorlanadigan jarayonini namoyish etadi: to‘g‘ri yo‘nalishni tanlang, ishlab chiqarish uslubidagi prompt yozing, asinxron so‘rovni yuboring, uning vazifa identifikatorini tekshiring, ko‘rsatilgan xarajatni qayd eting va natijani muddati tugashidan oldin yuklab oling. Bitta 1K tasvirdan boshlang, sifat va hisob-kitobni tekshiring, so‘ng yuqoriroq ruxsatlar, paketli so‘rovlar yoki havolaga asoslangan sunburst jarayonlariga o‘ting.