APIMart orqali GPT-Image-2.5 yordamida tasvirlar yaratish va tahrirlash

image2.5 APIMart shlyuzi nima qiladi

image2.5 shlyuzi APIMart API orqali GPT Image 2.5 tasvir yaratish va tahrirlash oilasidan foydalanish imkonini beradi. Har bir tasvir modeli uchun alohida hisob maʼlumotlari va soʻrov formatini integratsiya qilish oʻrniga, bitta asosiy URL, bitta bearer token va OpenAI uslubidagi /v1/images/generations endpointidan foydalanasiz.

API asinxron ishlaydi. Tasvir yaratish soʻrovi ichki tasvir oʻrniga topshiriq identifikatorini qaytaradi. Keyin ilovangiz jarayon tugaguncha yoki xatolik yuz berguncha topshiriq endpointini soʻrovlar bilan tekshiradi. Muvaffaqiyatli topshiriqlar vaqtinchalik natija URLlarini oʻz ichiga oladi; ularni muddati tugashidan oldin yuklab olish kerak.

APIMart — repozitoriyda hujjatlashtirilgan xizmat. gpt-image-2.5-ext endpointi uchinchi tomon relay yoʻnalishi, gpt-image-2.5-flare va gpt-image-2.5-sunburst esa token asosida haq olinadigan yoʻnalishlardir. Ishlab chiqarish ishga tushirilishidan oldin amaldagi limitlar va narxlarni tekshiring.

Asosiy imkoniyatlar

• Bitta API asosiy URLi: Soʻrovlar https://api.apimart.ai/v1 manzilidan foydalanadi.
• Modelning ikki varianti: Kundalik yaratish va paketli qoralamalar uchun Flareʼni, tahrirlash aniqligi va ishlab chiqarishga yoʻnaltirilgan materiallar uchun Sunburstʼni tanlang.
• Hisob-kitobning ikki usuli: Relay yoʻnalishida har bir yetkazilgan tasvir uchun haq olinadi, rasmiy yoʻnalishlarda esa token asosidagi hisob-kitob qoʻllanadi.
• Asinxron ishlov berish: Soʻrov yuboring va jarayonni kuzatish uchun GET /v1/tasks/{task_id} endpointini tekshiring.
• Bir nechta natija darajasi: Relay yoʻnalishi 1K, 2K va 4K formatlarini qoʻllab-quvvatlaydi.
• Moslashuvchan kompozitsiyalar: Oʻnta tomonlar nisbatidan birini tanlang yoki auto qiymatidan foydalaning.
• Namunaga asoslangan yaratish: Tasvirdan tasvirga oʻtkazish yoki tahrirlash uchun image_urls ichida 16 tagacha element yuboring.
• Kichik paketlar: Relay yoʻnalishida n parametri orqali birdan toʻrttagacha yetkaziladigan tasvir soʻrang.

Toʻgʻri model yoʻnalishini tanlang

Tasvir boshiga haq olinadigan relay yoʻnalishi

Har bir yetkazilgan tasvir uchun belgilangan haq kerak boʻlsa, model: "gpt-image-2.5-ext" dan foydalaning. Asosiy variantni version: "flare" yoki version: "sunburst" orqali tanlang.

• flare katta hajmdagi yaratish, kundalik tasvirlar va qoralamalar uchun moʻljallangan.
• sunburst tahrirlash va namunaga asoslangan ishlab chiqarish ishlari uchun moʻljallangan.

Repozitoriy 2026-yil 16-sentabrda ikkala variant uchun ham yetkazilgan 1K tasvir boshiga $0.0085 narxini qayd etgan. Shuningdek, 2K uchun $0.014, 4K Flare uchun $0.021 qayd etilgan va 4K Sunburst uchun joriy narxni tekshirish tavsiya qilingan. Bular kuzatuv sanasidagi qiymatlar boʻlib, doimiy kafolat emas.

Rasmiy token asosidagi yoʻnalishlar

Token asosida haq toʻlash uchun bevosita gpt-image-2.5-flare yoki gpt-image-2.5-sunburst dan foydalaning. Bu yoʻnalishlarda version maydoni boʻlmaydi va low, medium, high, xhigh hamda max sifat darajalari qoʻllab-quvvatlanadi. Rasmiy yoʻnalish aniq piksel oʻlchamlarini ham qoʻllab-quvvatlaydi.

Amaliy qoida shuki, tasvir boshiga xarajatning oldindan aniq boʻlishi muhim boʻlsa relay yoʻnalishidan foydalaning; sifat boshqaruvlari yoki aniq oʻlchamlar kerak boʻlsa, rasmiy yoʻnalishni koʻrib chiqing.

Natijalar diapazoniga misol

Repozitoriy mahsulot fotografiyasi, portretlar, arxitektura, UI materiallari, illustratsiyalar, oʻyin sanʼati, taom fotografiyasi va makro tasvirlar uchun promptlarni namoyish etadi. Quyidagi taqdim etilgan tasvirlar loyiha tarkibidagi vizual natijalar turini koʻrsatadi.

Oʻrnatish va sozlash

1. API kalitini yarating

Kalitni APIMart API kalitlari sahifasi orqali oling. Uni manba kodiga toʻgʻridan-toʻgʻri joylashtirish oʻrniga muhit oʻzgaruvchisida saqlang.

export APIMART_API_KEY="your-api-key"

2. Mijozni tanlang

cURL uchun standart buyruq qatori oʻrnatilishidan boshqa loyiha bogʻliqligi talab qilinmaydi. Python misoli uchun requests paketini oʻrnating:

python -m pip install requests

Repozitoriy Node.js 18 yoki undan yangiroq versiyasi uchun JavaScript misolini ham oʻz ichiga oladi; bu versiyalarda fetch global tarzda mavjud.

3. Soʻrov sarlavhalarini tushuning

API kalitini Authorization sarlavhasida yuboring. Relay yoʻnalishi misollarida javob versiyasi sarlavhasi va noyob idempotentlik kalitidan ham foydalaniladi.

• Authorization: Bearer $APIMART_API_KEY
• Content-Type: application/json
• X-APIMart-Response-Version: 2026-07-27
• Idempotency-Key: unique-request-value

Aynan bir xil yuborishni qayta urinayotganda oʻsha idempotentlik kalitini qayta ishlating. Ataylab yangi tasvir topshirigʻini yaratmoqchi boʻlsangiz, yangi kalit yarating.

Asosiy foydalanish: cURL orqali tasvir yarating

Quyidagi soʻrov tasvir boshiga haq olinadigan yoʻnalishdan foydalanadi, Flareʼni tanlaydi va bitta kvadrat 1K tasvir soʻraydi:

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": "Yomg‘irli kunda deraza yonidagi shinam kitob o‘qish burchagi, iliq stol chirog‘i, kinematografik yoritish",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Muvaffaqiyatli yuborilganda HTTP 202 qaytariladi. Vazifa identifikatorini data.id dan o‘qing yoki qaytarilgan data.poll_url dan foydalaning.

Vazifani tekshirish

task_01EXAMPLE o‘rniga qaytarilgan vazifa identifikatorini qo‘ying:

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

Vazifa holati pending va processing bosqichlaridan o‘tib, completed yoki failed holatiga yetadi. Javobda progress, cost va credits_cost ham ko‘rsatilishi mumkin. Jarayon tugagach, rasm URL manzilini result.images[].url dan oling va expires_at ni tekshiring.

Python’da boshidan oxirigacha misol

Bu misol bitta rasm yuboradi va vazifa yakuniy holatga kelguncha uni har besh soniyada tekshiradi:

import os
import time
import uuid
import requests

BASE_URL = "https://api.apimart.ai/v1"
COMMON_HEADERS = {
    "Authorization": f"Bearer {os.environ['APIMART_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,
        json={
            "model": "gpt-image-2.5-ext",
            "version": version,
            "prompt": prompt,
            "size": size,
            "resolution": resolution,
            "n": 1,
        },
        timeout=60,
    )
    response.raise_for_status()
    task_id = response.json()["data"]["id"]

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

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

        time.sleep(5)

result = generate_image(
    "Tongdagi osmon bog‘i, arxitektura fotografiyasi",
    version="flare",
    resolution="1K",
    size="16:9",
)

for image in result["result"]["images"]:
    print(image["url"], image.get("expires_at"))

Ishlab chiqarish uchun mo‘ljallangan mijozda faqat URL manzilini qaytarish o‘rniga xarajat, jarayon, amal qilish muddati va xato ma’lumotlarini saqlab qolish uchun to‘liq vazifa obyektini qaytaring yoki saqlang.

Tahrirlash uchun namunaviy rasmlardan foydalanish

Uzatma yo‘nalishida rasmdan rasm yaratish yoki tahrirlashni amalga oshirish uchun image_urls massivini qo‘shing. U 16 tagacha URL yoki ma’lumot URL manzilini o‘z ichiga olishi mumkin. Repozitoriyda ushbu yo‘nalishda namunaviy rasmlar uchun alohida to‘lov olinmasligi ko‘rsatilgan.

{
  "model": "gpt-image-2.5-ext",
  "version": "sunburst",
  "prompt": "Mahsulot yorlig‘ini saqlang, fonni mayin oqish rangga almashtiring va tabiiy tushuvchi soya qo‘shing",
  "image_urls": [
    "https://example.com/source-product.jpg"
  ],
  "size": "1:1",
  "resolution": "2K",
  "n": 1
}

Sunburst repozitoriyning tahrirlash aniqligi va namunaga asoslangan ishlar uchun tavsiya qilgan varianti hisoblanadi. Foydalanish mumkin bo‘lgan URL yoki yaroqli ma’lumot URL manzillaridan foydalaning va ro‘yxatni hujjatlashtirilgan limit doirasida saqlang.

Uzatma yo‘nalishi uchun so‘rov maydonlari ma’lumotnomasi

• model: Majburiy. Uni gpt-image-2.5-ext ga o‘rnating.
• version: flare yoki sunburst qiymatlarini qabul qiladi; standart qiymat Flare.
• prompt: Majburiy va bo‘sh joylar olib tashlangandan keyin bo‘sh bo‘lmasligi kerak.
• resolution: 1K, 2K yoki 4K qiymatlarini qabul qiladi; standart qiymat 1K.
• size: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 yoki 21:9 qiymatlarini qabul qiladi.
• n: 1 dan 4 gacha bo‘lgan butun sonni qabul qiladi.
• image_urls: Ixtiyoriy massiv bo‘lib, 16 tagacha namunaviy URL yoki ma’lumot URL manzilini o‘z ichiga oladi.

Token asosida haq olinadigan yo‘nalishga murojaat qilish

Rasmiy yo‘nalishdan foydalanishda ayni generatsiya yo‘li ishlatiladi, ammo model identifikatori o‘zgartiriladi, version olib tashlanadi va sifat sozlamasi qo‘shiladi. Ushbu misolda yuqori sifatli Sunburst tanlanadi:

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": "Mahsulot yorlig‘ini saqlang, fonni mayin oqish rangga almashtiring va tabiiy tushuvchi soya qo‘shing",
    "size": "1:1",
    "resolution": "1k",
    "quality": "high",
    "n": 1
  }'

Joriy maydon ta’riflari uchun rasmiy yo‘nalish ma’lumotnomasi va retranslyatsiya qilingan yo‘nalish ma’lumotnomasiga murojaat qiling.

Ishonchli integratsiyalar uchun ilg‘or maslahatlar

1. Qayta urinishlarni idempotent qiling. Agar yuborish vaqti tugasa va vazifa yaratilgan-yaratilmaganiga ishonchingiz komil bo‘lmasa, dastlabki idempotentlik kalitini saqlab qoling. Yangi kalit yana bir haq olinadigan generatsiyani yaratishi mumkin.
2. Pollingni odatiy ish jarayoni sifatida ko‘ring. completed va failed holatlarining ikkalasini ham qayta ishlang. Tez-tez polling qilishdan saqlaning; repozitoriydagi misol tekshiruvlar orasida besh soniya kutadi.
3. Qaytarilgan polling URL manzilidan foydalaning. Javobda data.poll_url mavjud bo‘lib, bu vazifa endpointini qo‘lda qayta tuzish zaruratini yo‘qotadi.
4. Natijalarni tezda yuklab oling. Generatsiya qilingan rasm URL manzillari vaqtinchalik. Har bir natijani expires_at vaqti kelishidan oldin o‘zingizning xotirangizga ko‘chiring.
5. Haqiqiy xarajatni qayd eting. Vazifa javobidan cost va credits_cost qiymatlarini saqlang. Bu kuzatilgan hisob-kitoblarni e’lon qilingan narxlar bilan taqqoslash imkonini beradi.
6. Xarajatni bitta pullik so‘rov bilan tekshiring. Narxlar va aksiyaviy yo‘naltirishlar o‘zgarishi mumkin, shuning uchun katta to‘plamni ishga tushirishdan oldin kichik test o‘tkazing.
7. Tegishli yo‘nalishdan foydalaning. Har bir rasm uchun prognoz qilinadigan to‘lov va to‘rttagacha bo‘lgan to‘plamlar uchun retranslyatsiya qilingan yo‘nalishni tanlang. Sifat bosqichi yoki aniq piksel boshqaruvlari muhim bo‘lsa, rasmiy model identifikatoridan foydalaning.
8. Mijozni qayta yozmasdan variantlarni almashtiring. Retranslyatsiya qilingan yo‘nalishda version qiymatini flare va sunburst o‘rtasida o‘zgartirish kifoya.
9. Hisob ma’lumotlarini himoya qiling. API kalitini muhit o‘zgaruvchilarida yoki maxfiy ma’lumotlar menejerida saqlang va uni hech qachon brauzer tomonidagi kodda oshkor qilmang.

Xulosa

APIMart’ning image2.5 shlyuzi GPT Image 2.5 orqali rasm generatsiyasi va tahririga kirishning izchil usulini taqdim etadi. Prognoz qilinadigan, katta hajmdagi generatsiya uchun gpt-image-2.5-ext va Flare bilan boshlang, tahrirlash yoki ma’lumotnoma asosidagi ishlar uchun Sunburst’ga o‘ting, token asosidagi to‘lov va kengaytirilgan sifat boshqaruvlari vazifaga yaxshiroq mos kelsa, rasmiy model identifikatorlaridan foydalaning.

Asosiy integratsiya sxemasi oddiy: rasm so‘rovini yuboring, qaytarilgan vazifa identifikatorini saqlang, tugaguncha polling qiling, ko‘rsatilgan xarajatni tekshiring va vaqtinchalik URL manzili muddati tugashidan oldin barcha natijalarni yuklab oling. Masshtabni oshirishdan oldin joriy APIMart narxlarini ko‘rib chiqing va tanlangan yo‘nalishni kichik pullik so‘rov bilan tekshiring.