راهنمای کامل GPT Image 2
در تاریخ 2026-10-20، GPT Image 2 (gpt-image-2) مدل تولید و ویرایش تصویر OpenAI است که در 21 آوریل 2026 منتشر شد و اندازههای انعطاف‌پذیر و ورودی‌های تصویری با وفاداری بالا دارد. صورت‌حساب رسمی بر پایه هر توکن تصویر است: $8 ورودی تصویر / $2 ورودی کش‌شده / $30 خروجی تصویر بهازای 1M توکن، و در Batch برابر $4 / $1 / $15. QCode بهازای هر تصویر خروجی مبلغ $0.30 را صورت‌حساب میکند، برای تولید و ویرایش یکسان؛ این مبنایی جدا از قیمت‌های رسمی توکن تصویر است.
GPT Image 2 چیست
GPT Image 2 مدل تولید و ویرایش تصویر است که OpenAI در 21 آوریل 2026 با شناسه مدل gpt-image-2 و اسنپ‌شات پیشفرض gpt-image-2-2026-04-21 منتشر کرد. OpenAI میگوید از اندازههای انعطاف‌پذیر تصویر و ورودی‌های تصویری با وفاداری بالا پشتیبانی میکند و از طریق نقاط پایانی generations و edits در Images API فراخوانی میشود. DALL·E 2 و DALL·E 3 در 12 مه 2026 از API حذف شدند و OpenAI به‌جای آن‌ها مدل‌هایی مانند gpt-image-2 را توصیه میکند. در تاریخ 2026-10-20، OpenAI همچنین مدل‌های بعدی GPT Image 2.5 Sunburst and Flare را در 8 سپتامبر 2026 منتشر کرده است؛ راهنمای رسمی، مدل‌های 2.5 را برای یکپارچه‌سازی‌های جدید توصیه میکند.
قابلیت‌های کلیدی
متن به تصویر، تصویر به تصویر، اینپینتینگ، متن درون تصویر، رزولوشن‌های متعدد (1024×1024 / 1024×1536 / 1536×1024، و تا 4K در API رسمی) و سطوح کیفیت (low / medium / high / auto). OpenAI بر پایه هر توکن تصویر صورت‌حساب میکند؛ بنابراین اندازه، کیفیت و تعداد تصاویر ورودی تعداد توکن‌ها و در نتیجه هزینه کل را تغییر می‌دهند.
صورت‌حساب: $0.30 بهازای هر تصویر
صورت‌حساب GPT Image 2 بهازای هر تصویر خروجی است، با نرخ یکسان برای تولید و ویرایش: $0.30 برای هر تصویر، بنابراین n تصویر هزینه‌ای برابر n × $0.30 دارد. اندازه، کیفیت، تعداد تصاویر ورودی، ماسک و طول prompt بر قیمت تأثیر نمی‌گذارند. درخواست‌های ناموفق (4xx از جمله رد شدن‌های پالایش محتوا، 5xx، وقفه‌های زمانی، قطع اتصال کلاینت) هرگز صورت‌حساب نمی‌شوند. در تاریخ 2026-10-06، صورت‌حساب از حالت بر پایه توکن (با حداقل بهازای هر درخواست) به مبلغ ثابت $0.30 بهازای هر تصویر تغییر کرد.
- بهازای هر تصویر خروجی — $0.30
- اندازه / کیفیت / تصاویر ورودی / ماسک / طول prompt بر قیمت تأثیر نمی‌گذارند
- درخواست‌های ناموفق (4xx / 5xx / وقفه‌های زمانی / قطع اتصال کلاینت) هرگز صورت‌حساب نمی‌شوند
قیمت مستقل از اندازه / کیفیت و از تعداد تصاویری است که ارسال میکنید — فقط تعداد تصاویر خروجی ملاک است.
دسترسی از طریق QCode
GPT Image 2 در فهرست /models قرار دارد؛ برای تشخیص اینکه همین حالا قابل فراخوانی است یا نه، فهرست /models و صفحه وضعیت را بررسی کنید، نه متن هیچ صفحه ایستا را. صورت‌حساب بهازای هر تصویر خروجی $0.30 است و برای تولید و ویرایش یکسان است. همان سهمیه پلن QCode چند ابزار CLI مانند Claude Code و OpenAI Codex را پوشش میدهد.
تولید و ویرایش هزینه یکسانی دارند؛ n تصویر = n × $0.30.
4xx (شامل رد شدن‌های پالایش محتوا) / 5xx / وقفه‌های زمانی / قطع اتصال کلاینت هرگز صورت‌حساب نمی‌شوند.
مثال راه‌اندازی API
از API سازگار با OpenAI استفاده کنید. فقط BASE_URL را به نقطه پایانی QCode تنظیم کنید و از کلید QCode به‌عنوان کلید API استفاده کنید — سایر موارد با SDK رسمی یکسان است.
from openai import OpenAI
import base64
# توجه: تولید تصویر از نقطه پایانی اختصاصی /qcode-img/v1 استفاده میکند (جدا از متن /openai/v1)
client = OpenAI(
api_key="$QCODE_KEY",
base_url="https://api.qcode.cc/qcode-img/v1",
timeout=180.0, # OpenAI SDK default is short, recommend 180s
)
response = client.images.generate(
model="gpt-image-2",
prompt="A serene Japanese garden with a koi pond",
size="1024x1024",
quality="medium",
)
img = base64.b64decode(response.data[0].b64_json) # فقط b64_json برگردانده میشود؛ response_format=url با 400 رد میشود
open("out.png", "wb").write(img)
# مسیر کامل نقطه پایانی: POST https://api.qcode.cc/qcode-img/v1/images/generationsکاربردها
دارایی‌های بازاریابی، پوسترهای رسانه‌های اجتماعی، تصاویر محصولات تجارت الکترونیک، تصویرسازی‌های کتاب، پیش‌نویس‌های طراحی مفهومی، گرافیک‌های اسلاید، ماکاپ‌های UI، طراحی‌های نمونه اولیه. برای تغییرات محلی، از نقطه پایانی edits همراه با ماسک استفاده کنید، یا چند تصویر مرجع را در یک تصویر جدید ترکیب کنید.
مهاجرت از DALL·E 3 و مقایسه با Midjourney / Stable Diffusion
DALL·E 3: گزارش تغییرات رسمی OpenAI میگوید dall-e-2 و dall-e-3 در 12 مه 2026 از API حذف شدند و gpt-image-2 یکی از جایگزین‌های توصیه‌شده است؛ بنابراین یکپارچه‌سازی‌هایی که هنوز DALL·E 3 را فراخوانی می‌کنند باید مهاجرت کنند. در مقابل Midjourney: طراحی مبتنی بر API برای یکپارچه‌سازی برنامه‌ای مناسب است؛ Midjourney بیشتر به گردش‌کار سازندگان در Discord گرایش دارد. در مقابل Stable Diffusion: متن‌بسته است اما کیفیت و کنترل‌پذیری پایدارتری دارد و نیازی به GPU خودمیزبان ندارد. بر اساس اطلاعات تا 2026-10-15، راهنمای رسمی OpenAI برای یکپارچه‌سازی‌های جدید مدل‌های GPT Image 2.5 را توصیه میکند؛ بین gpt-image-2 و مدل‌های 2.5 بر اساس کیفیت، اندازه و نیازهای ویرایش انتخاب کنید.
QCode همچنین از OpenAI Codex / GPT-5.6 پشتیبانی میکند
سهمیه QCode شما در Claude Code و OpenAI Codex CLI کار میکند — یک موجودی مشترک، صفر هزینه تکراری.
پرسش‌های متداول
آیا هنوز میتوانید از DALL·E 3 استفاده کنید، یا باید به GPT Image 2 روی بیاورید؟
در API OpenAI خیر: گزارش تغییرات رسمی میگوید dall-e-2 و dall-e-3 در 12 مه 2026 از API حذف شدند و OpenAI به‌جای آن‌ها gpt-image-2، gpt-image-1 یا gpt-image-1-mini را توصیه کرد. gpt-image-2 از اندازههای انعطاف‌پذیر و ورودی‌های تصویری با وفاداری بالا پشتیبانی میکند و میتواند از طریق نقطه پایانی edits تغییرات محلی ایجاد کند؛ بر اساس صفحه منسوخ‌سازی‌های OpenAI، قرار است gpt-image-1 در 23 اکتبر 2026 خاموش شود و مدل‌های GPT Image 2.5 جایگزین آن هستند (بر اساس اطلاعات تا 2026-10-15).
هزینه GPT Image 2 چگونه محاسبه میشود؟
بهازای هر تصویر خروجی، هرکدام $0.30 — نرخ یکسان برای تولید و ویرایش، بنابراین n تصویر n × $0.30 هزینه دارد. اندازه، کیفیت، تعداد تصاویر ورودی، ماسک و طول prompt بر قیمت تأثیر نمی‌گذارند و درخواست‌های ناموفق هرگز صورت‌حساب نمی‌شوند. قیمت رسمی OpenAI مبنای جداگانه‌ای دارد: بهازای هر توکن تصویر، ورودی تصویر $8، ورودی کش‌شده $2 و خروجی تصویر $30 بهازای هر 1M توکن، و در Batch برابر $4 / $1 / $15 (صفحه قیمت‌گذاری رسمی، 2026-10-20).
کاربران در سرزمین اصلی چین چگونه به GPT Image 2 متصل میشوند؟
مستندات QCode، https://api.qcode.cc/qcode-img/v1 را به‌عنوان نقطه پایانی پیشفرض برای سرزمین اصلی چین، https://asia.qcode.cc/qcode-img/v1 را برای هنگ‌کنگ و جنوب شرق آسیا، و https://us.qcode.cc/qcode-img/v1 (لس‌آنجلس) را برای آمریکای شمالی و اروپا فهرست میکند. gpt-image-2 در فهرست /models قرار دارد؛ دسترس‌پذیری فعلی تابع فهرست /models و صفحه وضعیت است و این صفحه هیچ وعده لحظه‌ای نمی‌دهد.
آیا میتوانید از سهمیه پلن QCode خود برای GPT Image 2 استفاده کنید؟
سهمیه پلن QCode با یک کلید API واحد در چند ابزار CLI (Claude Code، OpenAI Codex و غیره) کار میکند. gpt-image-2 در فهرست /models قرار دارد — برای دسترس‌پذیری، /models و صفحه وضعیت را بررسی کنید؛ درخواست‌های تصویر با $0.30 بهازای هر تصویر در dailyCostLimit لحاظ میشوند.
gpt-image-2 در عمل: مشخصات، راه‌اندازی، ویرایش‌ها و خطاها
مشخصات رسمی gpt-image-2 در یک نگاه
بر اساس اطلاعات تا 2026-10-15، changelog رسمی OpenAI، GPT Image 2 را به‌عنوان منتشرشده در 21 آوریل 2026 فهرست میکند، با شناسه مدل gpt-image-2 و snapshot پیشفرض gpt-image-2-2026-04-21. در صفحه رسمی مدل، تولید تصویر (v1/images/generations)، ویرایش تصویر (v1/images/edits) و Batch (v1/batch) همگی پشتیبانی‌شده علامت‌گذاری شده‌اند؛ ورودی‌ها می‌توانند متن و تصویر باشند و خروجی یک تصویر است.
برای اندازهها، OpenAI مقادیر 1024x1024، 1536x1024، 1024x1536، 2048x2048، 2048x1152، 3840x2160، 2160x3840 و auto پیشفرض را به‌عنوان مقادیر محبوب فهرست میکند. اندازههای سفارشی باید همه این قواعد را رعایت کنند: بلندترین ضلع حداکثر 3840px باشد، هر دو ضلع مضربی از 16px باشند، نسبت ضلع بلند به کوتاه بیش از 3:1 نباشد و تعداد کل پیکسل‌ها بین 655,360 و 8,294,400 باشد. کیفیت میتواند low، medium، high یا auto پیشفرض باشد.
- قالب خروجی: Image API داده‌های تصویر کدگذاری‌شده با base64 را برمیگرداند؛ به‌طور پیشفرض png و در صورت درخواست jpeg یا webp. برای jpeg و webp، پارامتر output_compression (0–100) سطح فشرده‌سازی را تعیین میکند.
- وفاداری ورودی: OpenAI میگوید gpt-image-2 هر تصویر ورودی را به‌طور خودکار با وفاداری بالا پردازش میکند و اجازه تغییر input_fidelity را نمی‌دهد، بنابراین کافی است آن پارامتر را حذف کنید.
- پسزمینه شفاف: بر اساس changelog رسمی، gpt-image-2 از 20 اوت 2026 از background=transparent در پیشنمایش پشتیبانی میکند، با خروجی png یا webp؛ jpeg از شفافیت پشتیبانی نمی‌کند.
- تأخیر: بخش محدودیت‌های OpenAI اشاره میکند که promptهای پیچیده ممکن است تا 2 دقیقه طول بکشند.
- پالایش محتوا: همه promptها و تصاویر تولید‌شده بر اساس سیاست محتوای OpenAI فیلتر میشوند و پارامتر moderation مقدار auto (پیشفرض) یا low را می‌پذیرد.
فراخوانی gpt-image-2 از طریق QCode در سه مرحله
مستندات QCode یک مسیر تصویر اختصاصی را توصیف میکند که درخواست‌ها و پاسخ‌هایش از قالب OpenAI Images API پیروی می‌کنند: SDK رسمی OpenAI را نگه دارید، base_url را روی https://api.qcode.cc/qcode-img/v1 تنظیم کنید، کلید API QCode خود را به‌عنوان api_key و gpt-image-2 را به‌عنوان نام مدل به کار ببرید و بقیه کد خود را بدون تغییر بگذارید. اینکه همین حالا قابل فراخوانی باشد یا نه، با کاتالوگ /models و صفحه وضعیت مشخص میشود.
اگر ترجیح می‌دهید پیش از نوشتن کد آن را امتحان کنید، مستندات QCode به یک Playground آنلاین در https://api.qcode.cc/qcode-img/ اشاره می‌کنند که در آن کلید API و یک prompt را وارد میکنید تا تولید و ویرایش را در مرورگر آزمایش کنید.
- مرحله 1: در QCode ثبتنام کنید و یک کلید API در داشبورد بسازید (با cr_ شروع میشود)؛ همان کلید برای Claude Code، Codex و سایر ابزارها نیز کار میکند.
- مرحله 2: درخواست را همانند OpenAI بنویسید. model را روی gpt-image-2 تنظیم کنید؛ n در هر فراخوانی 1 تا 4 تصویر را می‌پذیرد و هر مقدار بالاتر از 4 به‌جای بریده‌شدن بی‌صدا، 400 برمیگرداند؛ اگر size و quality را حذف کنید، نقطه پایانی generations به‌طور پیشفرض 1024x1024 و medium را اعمال میکند. تصویر برگشتی گاهی ابعادی متفاوت از ابعاد درخواستی دارد، پس به خود تصویر اتکا کنید.
- مرحله 3: timeout کلاینت را صراحتاً روی 180 ثانیه یا بیشتر تنظیم کنید. مستندات QCode هشدار میدهد که مقدار پیشفرض OpenAI SDK بسیار کوتاه است و هر reverse proxy یا gateway که در این میان اجرا میکنید نیز به read timeout حداقل 180 ثانیه نیاز دارد.
- خواندن نتیجه: data[0].b64_json در پاسخ، تصویر base64 است؛ آن را رمزگشایی کنید و در فایل بنویسید؛ revised_prompt همان prompt بازنویسی‌شده توسط مدل است و در صورت تمایل میتوانید آن را نمایش دهید.
- محدودیت‌های پیشفرض: مستندات QCode روزانه 100 تصویر و حداکثر 2 درخواست در حال پردازش بهازای هر کلید API را اعلام میکند که بین generations و edits مشترک است؛ اگر بیشتر نیاز دارید با پشتیبانی تماس بگیرید.
ویرایش با edits: inpainting و ترکیب چند تصویر
درخواست‌های ویرایش به POST /qcode-img/v1/images/edits ارسال میشوند و باید فایل‌ها را بهصورت multipart/form-data و نه JSON بارگذاری کنید. مستندات QCode بهازای هر درخواست 1 تا 8 تصویر منبع (PNG، JPEG یا WebP) را مجاز می‌داند و باید فیلد image برای هر تصویر تکرار شود؛ mask اختیاری یک PNG با کانال آلفا است و ناحیه شفاف آن دوباره ترسیم میشود.
راهنمای رسمی OpenAI این الزامات mask را تعیین میکند: تصویر و mask باید قالب و اندازه یکسان داشته باشند و کمتر از 50MB باشند، و mask باید شامل کانال آلفا باشد. همچنین توضیح میدهد که ماسک‌کردن با GPT Image کاملاً مبتنی بر prompt است، بنابراین مدل از mask به‌عنوان راهنما استفاده میکند و ممکن است شکل دقیق آن را دنبال نکند؛ در صورت وجود چند تصویر ورودی، mask روی تصویر اول اعمال میشود.
- mask مشخص میکند کجا باید تغییر کند؛ prompt میگوید آن را به چه چیزی تغییر دهید. بدون mask، هر بخشی از تصویر ممکن است بر اساس prompt دوباره ترسیم شود.
- برای ترکیب چند تصویر، نقش هر تصویر را در prompt به‌صراحت بیان کنید؛ مثلاً اینکه تصویر اول صحنه است و تصویر دوم محصولی است که باید در آن قرار گیرد.
- اندازه بارگذاری: مستندات QCode سقف یک فایل را 25 MB و مجموع همه فایل‌ها را 50 MB تعیین میکند؛ بارگذاری‌های بزرگ‌تر 413 image_too_large برمیگردانند.
- نیازی به ارسال input_fidelity نیست: gpt-image-2 همیشه تصاویر ورودی را با وفاداری بالا پردازش میکند، QCode مقادیر low و high را نادیده می‌گیرد و هر مقدار دیگری 400 برمیگرداند.
خطاهای رایج و روش‌های رفع آن‌ها
خطاهای نقاط پایانی تصویر QCode از طرح‌واره خطای استاندارد OpenAI (error.type، error.code، error.message) پیروی می‌کنند؛ بنابراین وضعیت HTTP و کد را بررسی کنید.
- 400 unsupported_response_format: مقدار response_format=url را ارسال کرده‌اید. این نقطه پایانی فقط b64_json برمیگرداند.
- 400 unsupported_background: مقدار background=transparent را ارسال کرده‌اید. API رسمی OpenAI پسزمینه شفاف را در پیشنمایش پشتیبانی میکند، اما بر اساس مستندات QCode تا تاریخ 2026-10-15، مسیر /qcode-img/v1 فقط auto و opaque را می‌پذیرد.
- 400 stream_not_supported: مقدار stream=true یا partial_images را ارسال کرده‌اید؛ خروجی تدریجی هنوز پشتیبانی نمیشود.
- 422 unsupported_size: مقدار size یکی از auto، 1024x1024، 1024x1536، 1536x1024 یا 2048x2048 نیست؛ اندازههای سفارشی مانند 4K که API رسمی می‌پذیرد در این نقطه پایانی ارائه نمی‌شوند.
- 429 image_daily_limit یا concurrency_exhausted: به سقف روزانه تصویر برای هر کلید یا محدودیت هم‌زمانی رسیده‌اید؛ پیش از تلاش دوباره، به‌اندازه زمان اعلام‌شده در سرآیند Retry-After صبر کنید.
- 503 image_provider_unavailable، 504 یا timeout سمت کلاینت: با عقب‌نشینی نمایی بر اساس Retry-After دوباره تلاش کنید (مستندات پیشنهاد میکند از 30 ثانیه شروع کنید و حداکثر 3 بار)؛ اگر timeout ادامه یافت، prompt را کوتاه‌تر کنید یا تصاویر ورودی کمتری ارسال کنید.
پرسش‌های بیشتر درباره gpt-image-2
gpt-image-2 چه زمانی منتشر شد؟
فهرست تغییرات رسمی OpenAI نشان میدهد GPT Image 2 در 21 آوریل 2026 منتشر شده است، با snapshot پیشفرض gpt-image-2-2026-04-21. سپس OpenAI در 8 سپتامبر 2026، GPT Image 2.5 Sunburst و GPT Image 2.5 Flare را منتشر کرد (تا تاریخ 2026-10-15).
gpt-image-2 از چه اندازهها و سطوح کیفیتی پشتیبانی میکند؟
در API رسمی OpenAI، اندازههای پرکاربرد عبارتاند از 1024x1024، 1536x1024، 1024x1536، 2048x2048، 2048x1152، 3840x2160، 2160x3840 و auto، و کیفیت نیز low، medium، high یا auto است. از طریق /qcode-img/v1 در QCode، مقدار size میتواند auto، 1024x1024، 1024x1536، 1536x1024 یا 2048x2048 باشد و کیفیت low، medium یا high؛ سایر اندازهها خطای 422 برمیگردانند.
آیا gpt-image-2 میتواند URL تصویر برگرداند؟
خیر. API رسمی Image داده تصویر را بهصورت base64 برمیگرداند و نقطه پایانی QCode نیز بههمینترتیب فقط b64_json برمیگرداند؛ response_format=url خطای 400 میدهد. مقدار b64_json را رمزگشایی کنید و بهصورت فایل ذخیره کنید، یا آن را در یک صفحه وب بهصورت data URL نمایش دهید.
آیا gpt-image-2 میتواند PNG با پسزمینه شفاف بسازد؟
در API رسمی OpenAI، بله: فهرست تغییرات میگوید gpt-image-2 از 20 اوت 2026 در حالت پیشنمایش از background=transparent با خروجی png یا webp پشتیبانی میکند. از طریق /qcode-img/v1 در QCode، این قابلیت تا تاریخ 2026-10-15 پشتیبانی نمیشود؛ مقدار transparent خطای 400 برمیگرداند و background باید auto یا opaque باشد.
اگر درخواست‌های gpt-image-2 مدام timeout میشوند چه کنم؟
نخست، timeout کلاینت را به 180 ثانیه یا بیشتر افزایش دهید. OpenAI اشاره میکند که promptهای پیچیده ممکن است تا 2 دقیقه طول بکشند و مستندات QCode یک timeout صریح برای SDK با حداقل 180 ثانیه را الزامی میکند، از جمله timeout خواندن هر reverse proxy در میانه مسیر. خطای 504 یا timeout کلاینت را می‌توان همان‌طور دوباره تلاش کرد؛ اگر ادامه یافت، prompt را کوتاه‌تر کنید یا تصاویر ورودی کمتری ارسال کنید.
gpt-image-2 چه تفاوتی با GPT Image 2.5 دارد؟
بر اساس راهنمای تولید تصویر OpenAI (تا تاریخ 2026-10-20)، GPT Image 2.5 Sunburst و Flare تنظیمات کیفیت xhigh و max را اضافه می‌کنند، در حالی که gpt-image-2 تا high می‌رسد. OpenAI برای یکپارچه‌سازی‌های جدید مدل‌های 2.5 را توصیه میکند؛ Sunburst برای دقت ویرایش و Flare برای تولید سریع و روزمره با کیفیت بالا. مدل‌های تصویری که QCode میتواند فراخوانی کند و نحوه محاسبه هزینه فعلی آن‌ها در /models فهرست شده است.
چگونه برای gpt-image-2 در QCode پرداخت کنم و شروع کنم؟
ثبتنام کنید، موجودی حساب خود را شارژ کنید، یک پلن انتخاب کنید و سپس در داشبورد یک کلید API بسازید. با CNY میتوانید با Alipay یا WeChat Pay پرداخت کنید؛ با USD با کارتهای اعتباری Visa / Mastercard، Apple Pay یا Google Pay؛ پرداخت رمزارزی با انواع رمزارزها و شبکهها پذیرفته میشود و کل فرآیند بهصورت خودسرویس است. برای پلن ماهانه آماده نیستید؟ بستههای پرداخت بهازای مصرف از $4 شروع میشوند و شامل سهمیهای یکباره هستند که در 7 روز مصرف میکنید؛ اگر از قبل پلن شخصی دارید، هر زمان به سهمیه بیشتری نیاز داشتید یک بسته تقویتی اضافه کنید. gpt-image-2 بهازای هر تصویر خروجی $0.30 محاسبه میشود؛ /models را ببینید.
آشنایی با GPT Image 2
پلن‌های QCode در چند CLI سهمیه مشترک دارند — اشتراک انعطاف‌پذیر