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

image2.5 APIMart گیٹ وے کیا کرتا ہے

image2.5 گیٹ وے APIMart API کے ذریعے GPT Image 2.5 کی تخلیق اور ایڈیٹنگ فیملی تک رسائی فراہم کرتا ہے۔ ہر امیج ماڈل کے لیے الگ کریڈنشل اور ریکویسٹ فارمیٹ مربوط کرنے کے بجائے، آپ ایک بیس URL، ایک بیئرر ٹوکن، اور OpenAI طرز کا /v1/images/generations اینڈ پوائنٹ استعمال کرتے ہیں۔

API غیر ہم زمانی ہے۔ تخلیق کی ریکویسٹ براہِ راست امیج کے بجائے ٹاسک ID واپس کرتی ہے۔ اس کے بعد آپ کی ایپلیکیشن ٹاسک اینڈ پوائنٹ کو پول کرتی ہے، یہاں تک کہ پروسیسنگ مکمل ہو جائے یا ناکام ہو جائے۔ کامیاب ٹاسکس میں عارضی آؤٹ پٹ URLs شامل ہوتے ہیں، جنہیں ختم ہونے سے پہلے ڈاؤن لوڈ کر لینا چاہیے۔

APIMart وہ سروس ہے جس کی دستاویزات ریپوزٹری میں موجود ہیں۔ gpt-image-2.5-ext اینڈ پوائنٹ تھرڈ پارٹی ریلے روٹ ہے، جبکہ gpt-image-2.5-flare اور gpt-image-2.5-sunburst ٹوکن کے حساب سے بل کیے جانے والے روٹس ہیں۔ پروڈکشن رن سے پہلے موجودہ حدود اور قیمتوں کی تصدیق کریں۔

اہم خصوصیات

• ایک API بیس URL: ریکویسٹس میں https://api.apimart.ai/v1 استعمال ہوتا ہے۔
• ماڈل کی دو اقسام: روزمرہ تخلیق اور بیچ ڈرافٹس کے لیے Flare، یا زیادہ درست ایڈیٹنگ اور پروڈکشن پر مرکوز اثاثوں کے لیے Sunburst منتخب کریں۔
• بلنگ کے دو طریقے: ریلے کیے گئے روٹ پر ہر فراہم کردہ امیج کے حساب سے بل بنتا ہے، جبکہ آفیشل روٹس ٹوکن پر مبنی بلنگ استعمال کرتے ہیں۔
• غیر ہم زمانی پروسیسنگ: ریکویسٹ جمع کریں اور پیش رفت کے لیے GET /v1/tasks/{task_id} کو پول کریں۔
• آؤٹ پٹ کی متعدد سطحیں: ریلے کیا گیا روٹ 1K، 2K، اور 4K کو سپورٹ کرتا ہے۔
• لچک دار کمپوزیشنز: دس پہلو تناسب میں سے منتخب کریں یا auto استعمال کریں۔
• حوالہ پر مبنی تخلیق: امیج ٹو امیج یا ایڈیٹنگ کے لیے image_urls میں زیادہ سے زیادہ 16 اندراجات فراہم کریں۔
• چھوٹے بیچز: ریلے کیے گئے روٹ پر n کے ذریعے ایک سے چار فراہم کردہ امیجز کی ریکویسٹ کریں۔

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

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

جب آپ ہر فراہم کردہ امیج کے لیے مقررہ بلنگ چاہتے ہوں تو model: "gpt-image-2.5-ext" استعمال کریں۔ بنیادی قسم کو version: "flare" یا version: "sunburst" کے ذریعے منتخب کریں۔

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

ریپوزٹری نے 16 ستمبر 2026 کو دونوں اقسام کے لیے فراہم کردہ 1K امیج کی قیمت $0.0085 ریکارڈ کی۔ اس میں 2K کے لیے $0.014، 4K Flare کے لیے $0.021 بھی درج تھے، جبکہ 4K Sunburst کی موجودہ قیمت چیک کرنے کا مشورہ دیا گیا تھا۔ یہ مشاہدے کی تاریخ سے متعلق اعداد ہیں، مستقل ضمانتیں نہیں۔

آفیشل ٹوکن پر مبنی روٹس

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

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

آؤٹ پٹ کی مثالیں

ریپوزٹری میں پروڈکٹ فوٹوگرافی، پورٹریٹس، معماری، UI اثاثوں، عکاسیوں، گیم آرٹ، کھانے کی فوٹوگرافی، اور میکرو امیجری کے لیے پرامپٹس دکھائے گئے ہیں۔ درج ذیل فراہم کردہ امیجز پروجیکٹ میں شامل بصری آؤٹ پٹ کی قسم کی مثال ہیں۔

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

1. API کی بنائیں

APIMart کے API کی صفحے سے کی حاصل کریں۔ اسے براہِ راست سورس کوڈ میں رکھنے کے بجائے ماحول کے متغیر میں محفوظ کریں۔

export APIMART_API_KEY="your-api-key"

2. کلائنٹ منتخب کریں

cURL کے لیے معیاری کمانڈ لائن انسٹالیشن کے علاوہ کسی پروجیکٹ انحصار کی ضرورت نہیں۔ Python مثال کے لیے requests پیکیج انسٹال کریں:

python -m pip install requests

ریپوزٹری میں Node.js 18 یا اس کے بعد کے ورژن کے لیے JavaScript مثال بھی شامل ہے، جہاں fetch عالمی سطح پر دستیاب ہے۔

3. ریکویسٹ ہیڈرز سمجھیں

API کی کو Authorization ہیڈر میں بھیجیں۔ ریلے روٹ کی مثالوں میں رسپانس ورژن ہیڈر اور ایک منفرد idempotency key بھی استعمال ہوتی ہے۔

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

اسی جمع کرانے کی دوبارہ کوشش کرتے وقت وہی idempotency key استعمال کریں۔ جب آپ جان بوجھ کر نیا امیج ٹاسک بنانا چاہیں تو نئی key تیار کریں۔

بنیادی استعمال: 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 کو استعمال کریں۔

ٹاسک کی حالت معلوم کریں

واپس کیے گئے ٹاسک ID سے task_01EXAMPLE کو تبدیل کریں:

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"

ٹاسک کی حالت pending اور processing سے گزرتے ہوئے completed یا failed تک پہنچتی ہے۔ جواب میں progress، cost اور credits_cost بھی شامل ہو سکتے ہیں۔ تکمیل کے بعد، تصویر کا URL result.images[].url سے حاصل کریں اور expires_at کا جائزہ لیں۔

مکمل Python مثال

یہ مثال ایک تصویر جمع کراتی ہے اور ٹاسک کے آخری مرحلے تک پہنچنے تک ہر پانچ سیکنڈ بعد اس کی حالت معلوم کرتی ہے:

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"Generation failed: {task}")

        time.sleep(5)

result = generate_image(
    "A sky garden at dawn, architectural photography",
    version="flare",
    resolution="1K",
    size="16:9",
)

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

پروڈکشن کلائنٹ کے لیے مکمل ٹاسک آبجیکٹ واپس کریں یا محفوظ کریں تاکہ لاگت، پیش رفت، میعاد ختم ہونے اور خرابی سے متعلق معلومات برقرار رہیں، بجائے اس کے کہ صرف URL واپس کیا جائے۔

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

ریلے کیے گئے روٹ پر image-to-image جنریشن یا ترمیم کرنے کے لیے image_urls ارے شامل کریں۔ اس میں زیادہ سے زیادہ 16 URLs یا ڈیٹا URLs شامل کیے جا سکتے ہیں۔ ریپوزٹری کے مطابق اس روٹ پر حوالہ جاتی تصاویر کے لیے الگ چارج نہیں لیا جاتا۔

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

ریپوزٹری ترمیم کی درستگی اور حوالہ جاتی کام کے لیے Sunburst کو تجویز کردہ variant قرار دیتی ہے۔ قابل رسائی URLs یا درست ڈیٹا URLs استعمال کریں اور فہرست کو دستاویزی حد کے اندر رکھیں۔

ریلے کیے گئے روٹ کے لیے درخواست کے فیلڈز کا حوالہ

• model: لازمی۔ اسے gpt-image-2.5-ext پر سیٹ کریں۔
• version: flare یا sunburst قبول کرتا ہے؛ پہلے سے طے شدہ Flare ہے۔
• prompt: لازمی ہے اور trim کرنے کے بعد خالی نہیں ہونا چاہیے۔
• 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: 1 سے 4 تک کا عددی integer قبول کرتا ہے۔
• image_urls: اختیاری ارے، جس میں زیادہ سے زیادہ 16 حوالہ جاتی URLs یا ڈیٹا URLs شامل ہو سکتے ہیں۔

ٹوکن سے بل کیے جانے والے روٹ کو کال کرنا

سرکاری روٹ وہی جنریشن پاتھ استعمال کرتا ہے، لیکن model ID تبدیل کرتا ہے، version ہٹا دیتا ہے اور quality setting شامل کرتا ہے۔ یہ مثال اعلیٰ معیار کے ساتھ Sunburst منتخب کرتی ہے:

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

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

قابلِ اعتماد انضمام کے لیے جدید تجاویز

1. ری ٹرائز کو idempotent بنائیں۔ اگر سبمیشن کا وقت ختم ہو جائے اور آپ کو یقین نہ ہو کہ ٹاسک بنایا گیا ہے یا نہیں، تو اصل idempotency key برقرار رکھیں۔ نئی key ایک اور قابلِ بل جنریشن بنا سکتی ہے۔
2. پولنگ کو معمول کے ورک فلو کا حصہ سمجھیں۔ completed اور failed دونوں صورتوں کو ہینڈل کریں۔ تیز رفتار پولنگ سے بچیں؛ ریپوزٹری کی مثال چیکس کے درمیان پانچ سیکنڈ انتظار کرتی ہے۔
3. واپس کیا گیا poll URL استعمال کریں۔ جواب میں data.poll_url شامل ہوتا ہے، جس سے ٹاسک اینڈ پوائنٹ کو دستی طور پر دوبارہ بنانے کی ضرورت نہیں رہتی۔
4. آؤٹ پٹس فوراً ڈاؤن لوڈ کریں۔ تیار کردہ تصویر کے URLs عارضی ہوتے ہیں۔ ہر آؤٹ پٹ کو اس کے expires_at وقت سے پہلے اپنی اسٹوریج میں کاپی کریں۔
5. اصل لاگت ریکارڈ کریں۔ ٹاسک کے جواب سے cost اور credits_cost محفوظ کریں۔ اس سے آپ مشاہدہ شدہ بلنگ کا شائع شدہ قیمتوں سے موازنہ کر سکیں گے۔
6. ایک بامعاوضہ درخواست سے لاگت کی توثیق کریں۔ قیمتیں اور پروموشنل روٹنگ تبدیل ہو سکتی ہے، اس لیے بڑا بیچ شروع کرنے سے پہلے ایک چھوٹا ٹیسٹ چلائیں۔
7. مناسب روٹ استعمال کریں۔ قابلِ پیش گوئی فی امیج بلنگ اور زیادہ سے زیادہ چار کے بیچز کے لیے ریلے کیا گیا روٹ منتخب کریں۔ جب کوالٹی لیڈر یا عین پکسل کنٹرولز اہم ہوں تو آفیشل ماڈل ID منتخب کریں۔
8. کلائنٹ کو دوبارہ لکھے بغیر ویریئنٹس تبدیل کریں۔ ریلے کیے گئے روٹ پر flare اور sunburst کے درمیان صرف version تبدیل کریں۔
9. اسناد کا تحفظ کریں۔ API key کو ماحول کے متغیرات یا سیکریٹس مینیجر میں رکھیں اور اسے براؤزر سائیڈ کوڈ میں کبھی ظاہر نہ کریں۔

نتیجہ

APIMart کا image2.5 گیٹ وے GPT Image 2.5 کی جنریشن اور ایڈیٹنگ تک رسائی کا ایک مستقل طریقہ فراہم کرتا ہے۔ قابلِ پیش گوئی، زیادہ حجم والی جنریشن کے لیے gpt-image-2.5-ext اور Flare سے شروع کریں، ایڈیٹنگ یا حوالہ پر مبنی کام کے لیے Sunburst پر سوئچ کریں، اور جب ٹوکن بلنگ اور وسیع تر کوالٹی کنٹرولز کام کے لیے زیادہ موزوں ہوں تو آفیشل ماڈل IDs استعمال کریں۔

ضروری انضمامی طریقہ سادہ ہے: امیج درخواست سبمٹ کریں، واپس کیا گیا ٹاسک ID محفوظ کریں، تکمیل تک پول کریں، رپورٹ شدہ لاگت کا جائزہ لیں، اور ہر نتیجہ اس کے عارضی URL کی میعاد ختم ہونے سے پہلے ڈاؤن لوڈ کریں۔ اسکیل کرنے سے پہلے موجودہ APIMart قیمتوں کا جائزہ لیں اور ایک چھوٹی بامعاوضہ درخواست سے اپنے منتخب کردہ روٹ کی توثیق کریں۔