ChatGPT2API استعمال کا طریقہ: OpenAI سے ہم آہنگ تصاویر بنانے اور ترمیم کرنے والی API تیار کریں

پروجیکٹ کا تعارف اور استعمال سے متعلق احتیاطیں

ChatGPT2API ایک ایسا پروجیکٹ ہے جو ChatGPT کی آفیشل ویب سائٹ سے متعلق صلاحیتوں کی ریورس انجینئرنگ اور پیکیجنگ پر مبنی ہے۔ یہ تصویر بنانے، تصویر میں ترمیم اور متعدد تصاویر کو یکجا کر کے ترمیم کرنے کے لیے OpenAI سے مطابقت رکھنے والا API اور پراکسی فراہم کرتا ہے۔ پروجیکٹ میں آن لائن تصویری ورک بینچ، اکاؤنٹ پول مینجمنٹ، اکاؤنٹس درآمد کرنے کے متعدد طریقے، اور Docker کے ذریعے خود میزبانی کی تعیناتی کی سہولت بھی شامل ہے۔

اہم یاددہانی: پروجیکٹ کی README میں واضح کیا گیا ہے کہ یہ صرف ذاتی سیکھنے، تکنیکی تحقیق اور غیر تجارتی تکنیکی تبادلے کے لیے ہے۔ اسے تجارتی استعمال، بڑے پیمانے کی کارروائی، خودکار غلط استعمال، بڑے پیمانے پر کالز، یا OpenAI کی سروس کی شرائط اور مقامی قوانین و ضوابط کی خلاف ورزی کرنے والی کسی بھی سرگرمی کے لیے استعمال نہ کریں۔ جانچ کے دوران اہم، باقاعدگی سے استعمال ہونے والے یا زیادہ قدر والے اکاؤنٹس بھی استعمال نہیں کرنے چاہییں۔

پروجیکٹ میں آفیشل ویب سائٹ کے انٹرفیس کی ریورس انجینئرنگ شامل ہے، اس لیے استعمال کے دوران اکاؤنٹ محدود ہونے، عارضی معطلی یا مستقل پابندی کا خطرہ موجود ہو سکتا ہے۔ استعمال سے پہلے یقینی بنائیں کہ آپ متعلقہ خطرات کو سمجھتے اور قبول کرتے ہیں۔

اہم خصوصیات

OpenAI سے مطابقت رکھنے والا انٹرفیس

• POST /v1/images/generations تصویر سازی کے انٹرفیس سے مطابقت رکھتا ہے۔
• POST /v1/images/edits تصویری ترمیم کے انٹرفیس سے مطابقت رکھتا ہے۔
• تصویری منظرناموں کے لیے POST /v1/chat/completions اور POST /v1/responses سے مطابقت رکھنے والے انٹرفیس فراہم کرتا ہے۔
• GET /v1/models کے ذریعے تصاویر اور متعلقہ ماڈلز کی فہرست ظاہر کرتا ہے۔
• n پیرامیٹر کے ذریعے متعدد نتائج بنانے کی سہولت ہے، جبکہ موجودہ بیک اینڈ کی حد 1 سے 4 تصاویر تک ہے۔
• قابل ترمیم PPT اور PSD فائلیں بنانے کی سہولت ہے۔

آن لائن تصویر سازی اور ترمیم

بلٹ اِن ورک بینچ متن سے تصویر سازی، حوالہ جاتی تصویر میں ترمیم اور متعدد تصاویر کو یکجا کر کے ترمیم کرنے کی سہولت دیتا ہے۔ اس میں gpt-image-2، codex-gpt-image-2، auto اور README میں درج GPT ماڈل کے عرفی نام منتخب کیے جا سکتے ہیں۔ فرنٹ اینڈ تصویری سیشن کی تاریخ، مقامی محفوظ کاری، حذف اور مکمل صفائی، سرور پر تصویری URL کیش، تخلیق کی پیش رفت کی نگرانی، سست لوڈنگ اور اسکرول پوزیشن یاد رکھنے کی سہولت بھی فراہم کرتا ہے۔

اکاؤنٹ پول مینجمنٹ

اکاؤنٹ پول اکاؤنٹ کے ای میل، قسم، کوٹے اور بحالی کے وقت کو غیر ہم وقت طریقے سے تازہ کر سکتا ہے، اور دستیاب اکاؤنٹس کو باری باری استعمال کر کے تصویر سازی اور ترمیم انجام دیتا ہے۔ Token کے غیر مؤثر ہونے سے متعلق خرابی کی صورت میں نظام غیر مؤثر Token کو خودکار طور پر نکال سکتا ہے؛ شرح محدود کیے گئے اکاؤنٹس کے لیے باقاعدہ جانچ، پاس ورڈ کے ذریعے دوبارہ لاگ اِن اور خودکار بحالی بھی دستیاب ہے۔

پروجیکٹ HTTP، HTTPS، SOCKS5، SOCKS5H پراکسیز، نیز WARP، Privoxy اور FlareSolverr پر مشتمل مستحکم پراکسی رن ٹائم کو سپورٹ کرتا ہے۔ اکاؤنٹس درآمد کرنے کے طریقوں میں مقامی CPA JSON، ریموٹ CPA سرور، sub2api سرور اور access_token شامل ہیں۔

Docker کے ذریعے فوری تعیناتی

1. پروجیکٹ حاصل کریں اور سروس شروع کریں

پہلے مکمل سروس شروع کرنے کے لیے Docker Compose استعمال کرنے کی سفارش کی جاتی ہے۔ پروجیکٹ کلون کرنے اور اسے پس منظر میں چلانے کے لیے درج ذیل کمانڈز چلائیں:

git clone https://github.com/iamdurant/chatgpt2api-personal.git chatgpt2api
cd chatgpt2api
docker compose pull
docker compose up -d

شروع کرنے سے پہلے config.json میں auth-key سیٹ کرنا ضروری ہے۔ آپ docker-compose.yml میں ماحولیاتی متغیر CHATGPT2API_AUTH_KEY کے ذریعے بھی اس ترتیب کو اوور رائٹ کر سکتے ہیں۔

پہلے سے طے شدہ طور پر Web پینل کا پتہ http://localhost:3000، API کا بنیادی پتہ http://localhost:3000/v1 ہے، اور ڈیٹا پروجیکٹ ڈائریکٹری کے اندر ./data میں محفوظ ہو گا۔ README میں موجود کچھ curl مثالیں localhost:8000 استعمال کرتی ہیں؛ عملی کال کے وقت اپنے Compose پورٹ میپنگ کے مطابق پورٹ تبدیل کریں۔

2. Web پینل تک رسائی

سروس شروع ہونے کے بعد براؤزر میں http://localhost:3000 کھولیں۔ پہلی بار استعمال کرتے وقت پہلے اجازت کی کلید، اکاؤنٹ اور پراکسی سمیت ضروری ترتیبات مکمل کریں، پھر ورک بینچ کے ذریعے تصویر سازی یا ترمیم کی خصوصیات آزمائیں۔

3. سروس اپ ڈیٹ کریں

بعد کی صورت میں امیج اپ ڈیٹ کرنے کے لیے یہ کمانڈز چلائیں:

docker compose pull
docker compose up -d

WARP اور FlareSolverr کی مستحکم پراکسی فعال کریں

اگر تصویری درخواستوں کو اکثر Cloudflare کی جانب سے روکا جاتا ہے تو پروجیکٹ کے ساتھ فراہم کردہ WARP، Privoxy اور FlareSolverr تعیناتی حل استعمال کیا جا سکتا ہے:

cp .env.example .env
docker compose -f docker-compose.warp.yml pull
docker compose -f docker-compose.warp.yml up -d

یہ Compose ترتیب درج ذیل سروسز شروع کرے گی:

• warp-proxy：WARP SOCKS5 آؤٹ لیٹ فراہم کرتا ہے۔
• privoxy：WARP SOCKS5 کو HTTP پراکسی میں تبدیل کرتا ہے۔
• flaresolverr：Cloudflare clearance کو تازہ کرتا ہے۔
• init-config：proxy_runtime کی پہلے سے طے شدہ ترتیب کو idempotent انداز میں لکھتا ہے۔
• app：ChatGPT2API کی مرکزی سروس چلاتا ہے۔

پہلے سے طے شدہ طور پر صرف upstream OpenAI یا ChatGPT کی درخواستیں مستحکم پراکسی استعمال کریں گی؛ اکاؤنٹ ای میل، CPA اور دیگر معاون راستوں کو لازمی طور پر اس کے ذریعے نہیں چلایا جائے گا۔ پراکسی کی ترجیح یہ ہے: اکاؤنٹ کی اپنی ترتیب کردہ پراکسی، مستحکم پراکسی رن ٹائم، واضح پراکسی، پرانی عالمی پراکسی۔ آپ .env میں پورٹس اور رن ٹائم پیرامیٹرز تبدیل کر سکتے ہیں، اور بیک اینڈ کی ترتیبات کے صفحے میں پراکسی اور clearance بھی آزما سکتے ہیں۔

مقامی ترقیاتی ماحول

بیک اینڈ شروع کریں

پروجیکٹ کی README Python انحصارات کے انتظام کے لیے uv استعمال کرتی ہے۔ بیک اینڈ شروع کرنے کے لیے یہ کمانڈز چلائیں:

git clone https://github.com/iamdurant/chatgpt2api-personal.git chatgpt2api
cd chatgpt2api
uv sync
uv run main.py

فرنٹ اینڈ شروع کریں

Web ڈائریکٹری میں داخل ہونے کے بعد انحصارات انسٹال کرنے اور ترقیاتی سرور شروع کرنے کے لیے Bun استعمال کریں:

cd chatgpt2api/web
bun install
bun run dev

ترتیب کے ذخیرہ کرنے والے بیک اینڈ کو تشکیل دیں

پروجیکٹ ذخیرہ کرنے کا طریقہ منتخب کرنے کے لیے ماحولیاتی متغیر STORAGE_BACKEND استعمال کرتا ہے:

• json：مقامی JSON فائل، پہلے سے طے شدہ طریقہ۔
• sqlite：مقامی SQLite ڈیٹابیس۔
• postgres：بیرونی PostgreSQL، جس کے لیے DATABASE_URL سیٹ کرنا ضروری ہے۔
• git：نجی Git ریپوزٹری، جس کے لیے GIT_REPO_URL اور GIT_TOKEN سیٹ کرنا ضروری ہے۔

مثلاً PostgreSQL استعمال کرتے وقت Compose ماحولیاتی متغیرات میں یہ شامل کیا جا سکتا ہے:

environment:
  - STORAGE_BACKEND=postgres
  - DATABASE_URL=postgresql://user:password@host:5432/dbname

تصویر سازی API کو کال کریں

تمام AI انٹرفیسز کے ساتھ درج ذیل اجازت کا درخواست ہیڈر بھیجنا ضروری ہے:

Authorization: Bearer <auth-key>

پہلے ماڈل فہرست کے انٹرفیس کو کال کر کے موجودہ ظاہر کیے گئے ماڈلز دیکھیں:

curl http://localhost:8000/v1/models \
  -H "Authorization: Bearer <auth-key>"

متن سے تصویر بنانے کے لیے POST /v1/images/generations استعمال کریں۔ ذیل کی مثال خلا میں تیرتی ہوئی بلی بنائے گی:

curl http://localhost:8000/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "خلا میں تیرتی ہوئی ایک بلی",
    "n": 1,
    "response_format": "b64_json"
  }'

model میں /v1/models سے واپس آنے والی دستیاب قدر استعمال کی جانی چاہیے، اور README تصویر سازی کے لیے gpt-image-2 تجویز کرتی ہے۔ n کے ذریعے بنائی جانے والی تصاویر کی تعداد مقرر کی جا سکتی ہے، تاہم موجودہ بیک اینڈ کی حد 1 سے 4 تک ہے؛ response_format کی مثال میں b64_json استعمال کیا گیا ہے۔

تصویری ترمیم API کو کال کریں

multipart کے ذریعے مقامی تصویر اپ لوڈ کریں

تصویری ترمیم کا انٹرفیس مقامی فائل اپ لوڈ کرنے اور ترمیمی مواد کو پرامپٹ کے ذریعے بیان کرنے کی سہولت دیتا ہے:

curl http://localhost:8000/v1/images/edits \
  -H "Authorization: Bearer <auth-key>" \
  -F "model=gpt-image-2" \
  -F "prompt=اس تصویر کو سائبرپنک رات کے منظر کے انداز میں تبدیل کریں" \
  -F "n=1" \
  -F "image=@./input.png"

تصویری URL کے ذریعے ترمیم کریں

تصویری URL کو JSON فارمیٹ میں بھی بھیجا جا سکتا ہے:

curl http://localhost:8000/v1/images/edits \
  -H "Authorization: Bearer <auth-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "اس تصویر کو سائبرپنک رات کے منظر کے انداز میں تبدیل کریں",
    "images": [
      {"image_url": "https://example.com/input.png"}
    ]
  }'

تبصرے کے اینکر کے ذریعے مخصوص حصے میں ترمیم کریں

comments ارے کے ذریعے ویب ورژن کی تصویری تبصرہ نما ترمیم کی نقل کی جا سکتی ہے۔ x اور y کے لیے 0 سے 1 تک نارملائزڈ اعداد، فیصدی سٹرنگز یا 0 سے 100 تک کے اعداد استعمال کیے جا سکتے ہیں:

curl http://localhost:8000/v1/images/edits \
  -H "Authorization: Bearer <auth-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "باقی تمام حصے جوں کے توں رکھیں",
    "images": [
      {"image_url": "https://example.com/input.png"}
    ],
    "comments": [
      {"x": "27.5%", "y": "70%", "text": "سیلادون کی چائے کی کیتلی کو سنہری کناروں والی سفید چینی کی چائے کی کیتلی سے بدل دیں"},
      {"x": 0.36, "y": 0.315, "text": "بالوں کے جوڑے میں ایک اور سنہری بویا پن لگا دیں"}
    ]
  }'

جب درخواست میں comments شامل ہو تو prompt کو چھوڑا جا سکتا ہے۔ ہر تبصرے میں image_index کے ذریعے متعلقہ ان پٹ تصویر بھی متعین کی جا سکتی ہے، جس کی طے شدہ قدر 0 ہے۔

نشان زدہ لکیروں کے ذریعے ترمیم

پروجیکٹ ویب ورژن کے نشان زدہ برش کو بھی سپورٹ کرتا ہے۔ markup_strokes استعمال کرتے وقت points معمول پر لائے گئے نقاط کی ایک ٹوٹی ہوئی لکیر ہے، color کی طے شدہ قدر #FF3B30 ہے، جبکہ width تصویر کے چھوٹے کنارے کے مقابلے میں لکیر کی چوڑائی کا تناسب ہے:

curl http://localhost:8000/v1/images/edits \
  -H "Authorization: Bearer <auth-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "دائرے کے اندر موجود نیون سائن کو سبز رنگ سے بدل دیں",
    "images": [
      {"image_url": "https://example.com/input.png"}
    ],
    "markup_strokes": [
      {
        "points": [[0.62, 0.18], [0.78, 0.22], [0.75, 0.42], [0.6, 0.38], [0.62, 0.18]],
        "color": "#FF3B30",
        "width": 0.01
      }
    ]
  }'

اگر اصل تصویر کے برابر تناسب والی شفاف لکیروں کی PNG پہلے سے موجود ہو تو markup فائل کو multipart طریقے سے بھی اپ لوڈ کیا جا سکتا ہے۔ پروجیکٹ ترمیم انجام دینے سے پہلے لکیروں کو ان پٹ تصویر کے ساتھ ہم آہنگ کرکے یکجا کرے گا۔

Chat Completions اور Responses مطابقت رکھنے والے انٹرفیس کا استعمال

Chat Completions

POST /v1/chat/completions متن، ویب تلاش اور تصاویر کے منظرناموں کے لیے مطابقت فراہم کرتا ہے، لیکن README میں خاص طور پر وضاحت کی گئی ہے کہ یہ مکمل عمومی چیٹ ایجنٹ نہیں ہے۔ تصویر بنانے کی مثال:

curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-image-2",
    "messages": [
      {
        "role": "user",
        "content": "بارش بھری رات میں ٹوکیو کی سڑک پر سائبر پنک بلی بنائیں"
      }
    ],
    "n": 1
  }'

اس انٹرفیس کے messages میں متن، تلاش اور تصویر سے متعلق درخواستیں شامل کی جا سکتی ہیں؛ tools README میں درج ویب سرچ ٹولز کو سپورٹ کرتا ہے، جبکہ متن، تلاش اور تصاویر کے منظرناموں میں stream اب بھی آزمائشی مرحلے میں ہے۔

Responses API

POST /v1/responses تصویر بنانے والے ٹول کے استعمال اور ویب سرچ کی مطابقت رکھنے والی منطق کو سپورٹ کرتا ہے، لیکن یہ بھی مکمل عمومی Responses API پراکسی نہیں ہے:

curl http://localhost:8000/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <auth-key>" \
  -d '{
    "model": "gpt-5",
    "input": "مستقبل نما شہری آسمان کا منظر بنائیں",
    "tools": [
      {
        "type": "image_generation"
      }
    ]
  }'

اس میں tools، image_generation، web_search، web_search_preview اور web_search_preview_2025_03_11 کو سپورٹ کرتا ہے۔ اسٹریمنگ رسپانس نافذ ہے، لیکن اب بھی آزمائشی مرحلے میں ہے۔

اعلیٰ سطح کے استعمال کی تجاویز

1. پہلے اجازت اور ماڈل فہرست کی تصدیق کریں: تعیناتی کے بعد پہلے /v1/models کو کال کریں، تصدیق کریں کہ auth-key اور پورٹ کی ترتیب درست ہے، پھر تصویر کی درخواست کریں۔
2. اسٹوریج بیک اینڈ مناسب طور پر منتخب کریں: ذاتی ٹیسٹنگ کے لیے طے شدہ JSON یا SQLite استعمال کیا جا سکتا ہے؛ بیرونی ڈیٹابیس کی ضرورت ہو تو PostgreSQL ترتیب دیں اور کنکشن اسٹرنگ کی مناسب حفاظت کریں۔
3. Cloudflare کی روک تھام سے نمٹیں: جب اپ اسٹریم درخواست کا استحکام کم ہو تو پہلے پروجیکٹ کے فراہم کردہ WARP Compose طریقے کے مطابق مستحکم پراکسی ترتیب دیں، پھر بیک اینڈ میں پراکسی اور clearance کی جانچ کریں۔
4. اکاؤنٹ پول کے خطرات کو قابو میں رکھیں: ناکارہ Token کو باقاعدگی سے صاف کریں، اکاؤنٹ کی حالت برقرار رکھنے کے لیے تلاش، فلٹرنگ اور بیچ ریفریش کی خصوصیات استعمال کریں، اور اکاؤنٹس پر README میں ممنوعہ بیچ یا غلط استعمال والی کارروائیوں سے گریز کریں۔
5. ماڈل عرف الگ رکھیں: codex-gpt-image-2، Codex کے ڈرائنگ منظرناموں کے لیے ہے اور صرف Plus، Team، Pro سبسکرپشنز کے لیے دستیاب ہے؛ دستیاب ماڈلز کا حتمی تعین /v1/models کے واپس کردہ نتیجے سے کیا جائے۔
6. انٹرفیس کی حدود کا خیال رکھیں: Chat Completions اور Responses بنیادی طور پر README میں بیان کردہ متن، تلاش اور تصویر کے منظرناموں کے لیے ہیں؛ انہیں مکمل عمومی پراکسی کے طور پر استعمال نہیں کرنا چاہیے۔

خلاصہ

ChatGPT2API، ChatGPT کے ویب ورژن سے متعلق تصویری صلاحیتوں کو OpenAI طرز کے انٹرفیس میں سمیٹتا ہے اور آن لائن ورک بینچ، بہتر تصویری ترمیم، اکاؤنٹ پول، پراکسی رن ٹائم اور تعیناتی کے متعدد طریقے فراہم کرتا ہے۔ آپ پہلے Docker کے ذریعے بنیادی تعیناتی مکمل کر سکتے ہیں، پھر ضرورت کے مطابق اسٹوریج بیک اینڈ، مستحکم پراکسی اور اکاؤنٹ درآمد ترتیب دے سکتے ہیں، اور آخر میں /v1/images/generations اور /v1/images/edits کے ذریعے تصویر بنانے اور ترمیم کے عمل سے جڑ سکتے ہیں۔ استعمال کے دوران پروجیکٹ کے اعلانِ دستبرداری، اپ اسٹریم سروس کی شرائط اور مقامی قوانین و ضوابط کی پابندی لازمی ہے۔