APIMart API کے ذریعے GPT Image 2.5 سے تصاویر بنائیں

یہ پروجیکٹ کیا فراہم کرتا ہے

image2.5 Prompt Gallery عملی طور پر استعمال کیے گئے 12 پرامپٹس کا مجموعہ ہے، جنہیں GPT Image 2.5 کے ذریعے چلایا گیا اور حاصل ہونے والی تصاویر کے ساتھ شائع کیا گیا۔ ہر ترکیب میں پرامپٹ، ماڈل ورژن، پہلو تناسب اور آؤٹ پٹ درج ہیں، جس سے اپنے ایپلیکیشن کے لیے پرامپٹ کو ڈھالنے سے پہلے اس کا جائزہ لینا آسان ہو جاتا ہے۔

ان مثالوں میں APIMart کا OpenAI-compatible endpoint https://api.apimart.ai/v1 استعمال کیا گیا ہے۔ ریلے کیا گیا راستہ غیر ہم وقت ہے: آپ کی ایپلیکیشن تصویر کی درخواست بھیجتی ہے، ٹاسک ID حاصل کرتی ہے، ٹاسک endpoint کو بار بار چیک کرتی ہے، اور پراسیسنگ مکمل ہونے کے بعد تصویر ڈاؤن لوڈ کرتی ہے۔

اہم خصوصیات

• OpenAI-compatible جنریشن کا راستہ: درخواستیں POST /v1/images/generations پر بھیجی جاتی ہیں۔
• دو ریلے کیے گئے ویرینٹس: روزمرہ کی جنریشن کے لیے version: "flare" یا ایڈیٹنگ اور حوالہ جاتی کام کے لیے version: "sunburst" استعمال کریں۔
• آؤٹ پٹ کی متعدد سطحیں: 1K، 2K یا 4K منتخب کریں۔
• لچک دار فریمنگ: auto یا تعاون یافتہ دس پہلو تناسب میں سے کوئی ایک استعمال کریں، جن میں 1:1، 16:9، 9:16 اور 4:3 شامل ہیں۔
• بیچ آؤٹ پٹ: n کے ذریعے ایک سے چار تصاویر کی درخواست کریں۔
• حوالہ جاتی تصویر کی معاونت: image_urls میں زیادہ سے زیادہ 16 URLs یا data URLs فراہم کریں۔
• ہر کال کی لاگت کی رپورٹنگ: مکمل شدہ ٹاسک کے ڈیٹا میں cost اور credits_cost شامل ہوتے ہیں۔
• آئیڈیمپوٹنٹ ری ٹرائز: اسی درخواست کو دوبارہ بھیجتے وقت نقل شدہ کام سے بچنے میں مدد کے لیے API Idempotency-Key ہیڈر قبول کرتی ہے۔

درست ماڈل روٹ منتخب کریں

APIMart ریلے کیے گئے اور آفیشل GPT Image 2.5 دونوں روٹس فراہم کرتا ہے۔ ان کے درخواست فیلڈز اور بلنگ کے طریقے مختلف ہیں، اس لیے انٹیگریشن لکھنے سے پہلے روٹ منتخب کریں۔

ریلayed فی امیج روٹ

model کو gpt-image-2.5-ext پر سیٹ کریں اور version: "flare" یا version: "sunburst" شامل کریں۔ گیلری کی مثالوں میں یہی روٹ استعمال ہوا ہے اور اس کی بلنگ فراہم کی گئی ہر تصویر کے حساب سے ہوتی ہے۔

• flare: روزمرہ کی جنریشن اور بیچ ڈرافٹس کے لیے موزوں ہے۔
• sunburst: درست ایڈیٹنگ اور ایسے کام کے لیے موزوں ہے جن میں حوالہ جات، اشیا، لوگوز یا پروڈکٹ لیبلز برقرار رکھنا ضروری ہو۔

آفیشل ٹوکن بلڈ روٹ

براہِ راست gpt-image-2.5-flare یا gpt-image-2.5-sunburst استعمال کریں۔ ان ماڈل IDs کے ساتھ version فیلڈ نہ بھیجیں۔ آفیشل روٹ کی بلنگ ٹوکنز کے حساب سے ہوتی ہے اور یہ low سے max تک معیار کی سطحوں کے ساتھ ساتھ عین پکسل ڈائمینشنز کو بھی سپورٹ کرتا ہے۔

روٹ فارمیٹس کو ملائیں نہیں۔ gpt-image-2.5-ext alias کو ورژن سلیکٹر درکار ہوتا ہے، جبکہ آفیشل ماڈل IDs میں یہ شامل نہیں ہونا چاہیے۔

انسٹالیشن اور سیٹ اپ

1. اکاؤنٹ بنائیں اور فنڈز شامل کریں

APIMart keys page سے API key حاصل کریں۔ ریپوزٹری کے مطابق، سروس میں مفت کوٹا نہیں ہے اور $1 سے شروع ہونے والے ٹاپ اپس کی سہولت موجود ہے۔

2. کلید کو ماحول کے متغیر میں محفوظ کریں

export APIMART_API_KEY="your-api-key"

کلید کو براہِ راست ایپلیکیشن کے سورس کوڈ میں رکھنے یا اسے ورژن کنٹرول میں commit کرنے سے گریز کریں۔

3. Python dependency انسٹال کریں

Python کی مثال تھرڈ پارٹی requests پیکیج استعمال کرتی ہے۔

python -m pip install requests

اگر آپ curl کو ترجیح دیتے ہیں تو یقینی بنائیں کہ آپ کے shell میں curl اور uuidgen جیسا UUID جنریٹر دستیاب ہو۔

curl کے ذریعے اپنی پہلی تصویر کی درخواست بھیجیں

درج ذیل درخواست ریلے کیے گئے flare ویرینٹ کے ساتھ مربع 1K تصویر بناتی ہے:

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

کامیاب submission پر HTTP 202 موصول ہوتا ہے۔ ٹاسک کا شناخت کنندہ data.id سے پڑھیں یا واپس کیے گئے data.poll_url کو استعمال کریں۔

ٹاسک کو چیک کریں

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"

ٹاسک عام طور پر pending سے processing میں جاتا ہے، پھر completed یا failed کی حالت میں مکمل ہوتا ہے۔ مکمل ہونے پر تیار کردہ URLs کو result.images[].url سے حاصل کریں۔

تیار کردہ تصویر کے URLs میں expires_at ٹائم اسٹیمپ شامل ہوتا ہے۔ URL کی میعاد ختم ہونے سے پہلے ہر فائل ڈاؤن لوڈ کر کے محفوظ کریں۔

مکمل Python کلائنٹ بنائیں

یہ مثال ایک درخواست بھیجتی ہے، HTTP errors چیک کرتی ہے، ہر پانچ سیکنڈ بعد ٹاسک کو چیک کرتی ہے، اور مکمل شدہ ٹاسک ریکارڈ واپس کرتی ہے۔ ہر نئی جنریشن کے لیے یہ نئی idempotency key بناتی ہے۔

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"))

محفوظ طریقے سے دوبارہ کوشش کریں

اگر جمع کرانے کی کارروائی کا وقت ختم ہو جائے یا دوبارہ کوشش کے قابل جواب موصول ہو، تو اسی منطقی درخواست کو اسی Idempotency-Key کے ساتھ دوبارہ بھیجیں۔ نئی تصویر جان بوجھ کر بنانے کے لیے نئی کلید استعمال کریں۔ اگر کسی مکمل شدہ ٹاسک کو اس کے ماخذ یا حوالے میں تبدیلی کی وجہ سے دوبارہ بنانا ہو، تو بھی نئی کلید استعمال کریں۔

درخواست کے اہم فیلڈز کو سمجھیں

• model: لازمی؛ ریلے کیے گئے روٹ کے لیے gpt-image-2.5-ext استعمال کریں۔
• version: flare یا sunburst؛ ڈیفالٹ flare ہے۔
• prompt: لازمی ہے اور اس میں غیر سفید حروف پر مشتمل متن ہونا چاہیے۔
• resolution: 1K، 2K، یا 4K؛ ڈیفالٹ 1K ہے۔
• size: ڈیفالٹ auto ہے۔ معاون تناسب 1:1، 16:9، 9:16، 4:3، 3:4، 3:2، 2:3، 5:4، 4:5، اور 21:9 ہیں۔
• n: تصاویر کی تعداد، ریلے کیے گئے روٹ پر ایک سے چار تک۔
• image_urls: اختیاری صف، جس میں زیادہ سے زیادہ 16 تصویری URLs یا ڈیٹا URLs شامل ہو سکتے ہیں۔

زیادہ قابلِ اعتماد پرامپٹس لکھیں

گیلری پرامپٹ کو مبہم صفات کی فہرست کے بجائے ایک مختصر پروڈکشن بریف سمجھتی ہے۔ مفید ساخت میں موضوع، مواد، روشنی، فریمنگ یا لینز، اور فنش شامل ہیں۔

1. موضوع کا نام بتائیں: مرکزی شے، شخص، منظر، یا ماحول کی شناخت کریں۔
2. طبعی مواد واضح کریں: matte ceramic، frosted glass، یا clay render جیسی عبارتیں استعمال کریں۔
3. روشنی متعین کریں: نرم کھڑکی کی روشنی، قدرتی اطرافی روشنی، ہائی کی اسٹوڈیو لائٹنگ، یا ڈرامائی بیک لائٹ بیان کریں۔
4. فریمنگ طے کریں: مرکز میں ترکیب، اوورہیڈ فلیٹ لے، وسیع سنیماٹک ترکیب، یا مطلوبہ کوئی اور لے آؤٹ بیان کریں۔
5. لینز کی اصطلاحات شامل کریں: 85mm، 24mm، macro، اور focus stacked جیسی اصطلاحات زاویۂ نظر اور تفصیل کی رہنمائی کر سکتی ہیں۔
6. فنش منتخب کریں: پینٹرلی تفصیل، کمرشل پروڈکٹ فوٹوگرافی، یا واضح ویکٹر کناروں جیسی عبارتیں بصری انداز کو کنٹرول کرتی ہیں۔

مثال کے طور پر:

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

حوالہ جاتی تصاویر استعمال کریں

امیج ٹو امیج یا حوالہ پر مبنی کام کے لیے ریلے کی گئی درخواست میں image_urls صف شامل کریں۔ یہ روٹ زیادہ سے زیادہ 16 حوالوں کو قبول کرتا ہے۔

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

مستحکم اور قابلِ رسائی حوالہ جاتی URLs استعمال کریں۔ اگر کسی حوالہ URL کی میعاد ختم ہونے کی وجہ سے ٹاسک ناکام ہو جائے، تو تصویر کو دوبارہ ہوسٹ کریں اور نئی idempotency key کے ساتھ نیا ٹاسک جمع کرائیں۔

آفیشل روٹ کو کال کریں

آفیشل روٹ براہِ راست ماڈل ID اور ریلے کیے گئے روٹ کے version سلیکٹر کے بجائے quality سیٹنگ استعمال کرتا ہے۔

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

موجودہ فیلڈ کی تفصیلات کے لیے آفیشل روٹ کی دستاویزات اور ریلے کیے گئے روٹ کی دستاویزات دیکھیں۔

اعلیٰ درجے کی پروڈکشن تجاویز

جمع کرانے اور پروسیسنگ کو الگ رکھیں

واپس موصول ہونے والی ٹاسک ID کو ویب درخواست کھلی رکھنے کے بجائے کسی قطار یا ڈیٹا بیس میں محفوظ کریں۔ بیک گراؤنڈ ورکر نامکمل ٹاسکس کو پول کر سکتا ہے اور مکمل نتائج محفوظ کر سکتا ہے۔

معتدل وقفوں سے پولنگ کریں

ریپوزٹری کی مثالیں ہر پانچ سیکنڈ بعد پول کرتی ہیں۔ غیر ضروری ٹریفک پیدا کرنے والے تیز لوپس سے گریز کریں۔ بڑے ورک لوڈز کے لیے، جب تک ٹاسک زیر التوا یا زیرِ پروسیسنگ رہے، بیک آف شامل کریں۔

حقیقی اخراجات ریکارڈ کریں

ہر مکمل شدہ ٹاسک سے cost یا credits_cost محفوظ کریں۔ اس سے آپ کے پاس ہر کال کے خرچ کا ریکارڈ ہوگا، جو صرف اندازوں پر انحصار کرنے سے بہتر ہے۔

README کے مطابق ریلے کیے گئے روٹ کی مشاہدہ شدہ قیمت فی فراہم کردہ 1K تصویر $0.0085، 2K کے لیے $0.014، اور 4K flare کے لیے $0.021 ہے۔ 4K sunburst کی قیمت جدول میں مقرر نہیں کی گئی تھی۔ یہ اعداد و شمار ستمبر 2026 میں مشاہدہ کیے گئے تھے، اس لیے بجٹ بنانے یا اسکیل کرنے سے پہلے موجودہ قیمتیں دیکھیں۔

نتائج فوراً ڈاؤن لوڈ کریں

result.images[].url کو مستقل اسٹوریج نہ سمجھیں۔ expires_at سے پہلے فائل ڈاؤن لوڈ کریں، پھر اسے اپنی ایپلیکیشن کے زیرِ کنٹرول اسٹوریج میں منتقل کریں۔

اسکیل کرنے سے پہلے چھوٹے پیمانے سے آغاز کریں

1K پر n: 1 کے ساتھ پرامپٹ کی توثیق کریں۔ ریزولوشن بڑھائیں یا متعدد آؤٹ پٹس کی درخواست صرف اس وقت کریں جب موضوع، کمپوزیشن اور انداز مستحکم ہو جائیں۔

منزل کے مطابق پہلو کا تناسب منتخب کریں

• آئیکنز، پروڈکٹ کارڈز اور مربع سوشل اثاثوں کے لیے 1:1۔
• سینماٹک مناظر، ڈیش بورڈز اور پریزنٹیشن ہیڈرز کے لیے 16:9۔
• عمودی موبائل اور سوشل لے آؤٹس کے لیے 9:16۔
• ادارتی عکاسی اور فوڈ فوٹوگرافی کے لیے 4:3۔
• پورٹریٹس اور فیشن کمپوزیشنز کے لیے 3:4۔

مسائل کا ازالہ

• 401 یا API key غلط ہے: کلید دوبارہ کاپی کریں اور اسپیسز یا نئی سطر کے حروف کی جانچ کریں۔ ہیڈر میں Authorization: Bearer $APIMART_API_KEY استعمال ہونا چاہیے۔
• بیلنس یا کریڈٹ کی خرابی: اکاؤنٹ میں رقم شامل کریں؛ ریپوزٹری کے مطابق مفت متبادل کوٹا موجود نہیں ہے۔
• 429 جواب: بیک وقت کاموں کی تعداد کم کریں، بیک آف کریں، اور اسی idempotency key کے ساتھ وہی جمع کرانے کی کارروائی دوبارہ آزمائیں۔
• 400 یا ماڈل نہیں ملا: تصدیق کریں کہ gpt-image-2.5-ext میں ورژن شامل ہے اور براہِ راست آفیشل ماڈل IDs میں ورژن شامل نہیں ہوتا۔
• ٹاسک کی حالت failed ہے: جانچ کریں کہ آیا پرامپٹ مسترد ہوا یا حوالہ URL کی میعاد ختم ہو گئی۔ ان پٹ درست کریں اور نئی کلید کے ساتھ نیا ٹاسک جمع کرائیں۔
• آؤٹ پٹ URL مزید کام نہیں کرتا: عارضی URL کی میعاد غالباً ختم ہو چکی ہے۔ آئندہ مکمل ہونے والے آؤٹ پٹس کو فوراً ڈاؤن لوڈ کریں۔

نتیجہ

image2.5 Prompt Gallery، GPT Image 2.5 کے ساتھ اثاثے تیار کرنے کا ایک قابلِ تکرار ورک فلو پیش کرتی ہے: درست روٹ منتخب کریں، پروڈکشن طرز کا پرامپٹ لکھیں، غیر ہم وقت درخواست جمع کرائیں، اس کی ٹاسک ID کو پول کریں، رپورٹ شدہ لاگت ریکارڈ کریں، اور میعاد ختم ہونے سے پہلے نتیجہ ڈاؤن لوڈ کریں۔ ایک 1K تصویر سے آغاز کریں، معیار اور بلنگ کی تصدیق کریں، پھر زیادہ ریزولوشنز، بیچز یا حوالہ پر مبنی sunburst ورک فلو تک وسعت دیں۔