تولید تصویر

با Images API سازگار با OpenAI تصویر بسازید و ویرایش کنید: مدلی از کاتالوگ انتخاب کنید، یک درخواست بفرستید، نتیجه را بخوانید و قیمت دقیق را ببینید.

یک روند واحد برای همهٔ مدل‌های تصویر در دسترس: مدل را انتخاب کنید، درخواست بفرستید، پاسخ را بخوانید و قیمت را بفهمید.

همهٔ مدل‌ها، قابلیت‌ها و قیمت‌ها فهرست مستندات برای عامل‌های هوش مصنوعی: https://oneprovider.dev/docs/llms.txt مدل‌ها را از کاتالوگ مشترک انتخاب کنید این راهنما مدل خاصی را ثابت نمی‌کند. مدل‌های تصویر در دسترس و قیمت‌های فعلی آن‌ها همیشه در جدول مشترک مدل‌ها هستند.

مدل‌های تصویر در دسترس

gemini-3.1-flash-image Runnable

0.5K: ‎$ 0.045 / تصویر
1K: ‎$ 0.067 / تصویر
2K: ‎$ 0.101 / تصویر
4K: ‎$ 0.151 / تصویر

gpt-image-2 Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

1024x1024 · 1024x1536 · 1536x1024 · low · medium · high · auto gpt-image-2.5 Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

low · medium · high · xhigh · max · auto gpt-image-2.5-flare Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

low · medium · high · xhigh · max · auto gpt-image-2.5-sunburst Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

low · medium · high · xhigh · max · auto gpt-image-2.6-flare Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

low · medium · high · xhigh · max · auto gpt-image-2.6-sunburst Runnable

image input: ‎$ 8.00 / 1M توکن
cached image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 30.00 / 1M توکن

low · medium · high · xhigh · max · auto grok-imagine کاتالوگ

per generation request: ‎$ 0.02 / تصویر

grok-imagine-image Runnable

per generated image: ‎$ 0.02 / تصویر

grok-imagine-image-2.0 Runnable

1K: ‎$ 0.06 / تصویر
2K: ‎$ 0.08 / تصویر

1K · 2K · low · medium grok-imagine-image-lite Runnable

per generated image: ‎$ 0.025 / تصویر

gemini-3-pro-image کاتالوگ

image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 120.00 / 1M توکن

gemini-3-pro-image-preview کاتالوگ

image input: ‎$ 2.00 / 1M توکن
generated image output: ‎$ 120.00 / 1M توکن

gemini-3.1-flash-image-preview کاتالوگ

image input: ‎$ 0.50 / 1M توکن
generated image output: ‎$ 60.00 / 1M توکن

درخواست

POST /v1/images/generations. مسیر و پارامترهای اختیاری از مشخصات رابط تأییدشدهٔ مدل انتخاب‌شده می‌آیند.

bash

curl -sS https://api.oneprovider.dev/v1/images/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A quiet observatory above the clouds",
"size": "1024x1024",
"quality": "low"
}'

قابلیت‌ها بسته به مدل فرق می‌کنند

اندازه‌ها، سطح‌های کیفیت، شفافیت، ویرایش و قالب‌های پاسخ مخصوص هر مدل‌اند. پارامترهای اختیاری یک مدل را بدون بررسی پشتیبانی به مدل دیگر نبرید.

پاسخ

انتقال همگام داده یا URL تصویر را فوراً برمی‌گرداند. انتقال ناهمگام شناسهٔ کار را برمی‌گرداند؛ مسیر وضعیت آن را پیگیری کنید، سپس از مسیر محتوایش دانلود کنید.

قیمت‌ها

جدول مشترک مدل‌ها هر نرخ توکن را در ستون جداگانه می‌گذارد و هزینهٔ هر تصویر یا رسانهٔ دیگر را در ستون رسانه نشان می‌دهد. باز کردن قیمت‌ها .

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .

آخرین به‌روزرسانی: 2026-11-08 باگی پیدا کردید؟ @Oneproviderhelpbot