ShareAI Platform Docs

تولید تصاویر

پاسخ JSON هم‌زمان شامل نتایج تصویر در داده است.

مشاهده به‌صورت Markdown
در این صفحه
POST https://api.shareai.now/api/v1/images

تولید تصاویر

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده
دامنه مورد نیاز
inference or monetization_gateway

پاسخ JSON هم‌زمان شامل نتایج تصویر در data. نام مستعار /api/v1/images/generations نیز پشتیبانی می‌شود. گزینه‌هایی مانند اندازه، وضوح، نسبت ابعاد، کیفیت و فرمت خروجی به مدل انتخاب‌شده بستگی دارند. پاسخ‌ها به 2 MiB محدود شده‌اند؛ در صورت نیاز تعداد یا اندازه تصاویر را کاهش دهید. تصاویر بازگشتی به 8192 پیکسل در هر طرف محدود هستند.

قبل از شروع#

SHAREAI_API_KEY را روی سرور خود تنظیم کنید و جایگزین مدل را با یک مدل فعال فعلی انجام دهید. هرگز کلید API را در کد مرورگر افشا نکنید. مدل، حساب، اعتبار و ارائه‌دهنده باید این عملیات را مجاز کنند. تنظیمات اختیاری زیر به پشتیبانی مدل نیاز دارند؛ محدودیت‌های ایمنی API تضمین نمی‌کنند که هر مدل از هر مقدار پشتیبانی کند.

ارسال یک درخواست#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

فیلدهای درخواست#

فیلدنوعمعنا و محدودیت‌ها
model مورد نیازرشتهشناسه دقیق مدل عمومی فعال. باید این عملیات را اعلام کند و توسط اعتبار شما مجاز باشد.
prompt مورد نیازرشتهدرخواست تولید غیرخالی، حداکثر 256 کیلوبایت متن UTF-8.
nعدد صحیحتعداد تصویر اختیاری، 1–10؛ پیش‌فرض 1. مدل شما ممکن است تعداد کمتری را مجاز کند.
sizeرشتهاندازه خروجی پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر، برای مثال 1024×1024. هر مدل از این گزینه پشتیبانی نمی‌کند.
resolutionرشتهانتخابگر وضوح پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر؛ باید با نوع تعرفه منتشرشده مطابقت داشته باشد.
aspect_ratioرشتهانتخابگر نسبت ابعاد پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر.
qualityرشتهانتخاب‌کننده کیفیت پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر؛ ممکن است نرخ متفاوتی انتخاب شود.
response_formatرشتهفرمت پاسخ پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر. عملیات تعیین می‌کند که نتیجه JSON یا باینری باشد.
output_formatرشتهانتخاب‌کننده کدگذاری خروجی پشتیبانی‌شده توسط مدل، حداکثر 100 کاراکتر.
backgroundرشتهتنظیم اختیاری پس‌زمینه تصویر در صورت پشتیبانی توسط مدل.
seedعدد صحیحبذر اختیاری پشتیبانی‌شده توسط مدل. ویدئو به یک عدد صحیح غیرمنفی نیاز دارد؛ قابلیت بازتولید به اجراکننده بستگی دارد.
input_referencesآرایهحداکثر 16 بخش تایپ‌شده image_url با image_url.url تنظیم‌شده به یک URL HTTPS یا URL داده تصویر پشتیبانی‌شده. پشتیبانی مدل لازم است.
providerشیءتنظیمات اختیاری ترجیحات مسیریابی ارائه‌دهنده. از provider.only برای برچسب‌های ارائه‌دهنده پذیرفته‌شده استفاده کنید، نه یک پیشوند در شناسه مدل. محدودیت‌های حساب و اعتبار همچنان اعمال می‌شوند.

خواندن نتیجه#

موفقیت با HTTP 200 و JSON بازمی‌گردد. پاسخ JSON هم‌زمان شامل نتایج تصویر در data. نام مستعار /api/v1/images/generations نیز پشتیبانی می‌شود. گزینه‌هایی مانند اندازه، وضوح، نسبت ابعاد، کیفیت و فرمت خروجی به مدل انتخاب‌شده بستگی دارند. پاسخ‌ها به 2 MiB محدود شده‌اند؛ در صورت نیاز تعداد یا اندازه تصاویر را کاهش دهید. تصاویر بازگشتی به 8192 پیکسل در هر طرف محدود هستند.

واحدهای صورتحساب#

تعرفه‌های تصویر می‌توانند از تصاویر تولیدشده، اندازه‌گیری مگاپیکسل‌ها، مراجع ورودی، درخواست‌ها یا توکن‌های گزارش‌شده توسط ارائه‌دهنده استفاده کنند. یک URL تصویر اندازه تصویر را اندازه‌گیری نمی‌کند. تعرفه‌های مگاپیکسل به ابعاد تصویر بازگشتی نیاز دارند؛ برای این مسیرها از خروجی base64 استفاده کنید.

مدل فعال مورد نظر را از Console انتخاب کنید. عملیات اعلام‌شده و قابلیت‌های ورودی/خروجی آن باید با این نقطه پایانی مطابقت داشته باشد؛ یک مدل چت متنی نمی‌تواند جایگزین عملیات دیگری شود. محدودیت‌های اعتبارنامه، ارائه‌دهنده و حساب شما همچنان اعمال می‌شوند.

قیمت‌گذاری و استفاده#

نرخ‌ها به صورت اعتبارهای AI به یورو برای مدل انتخاب‌شده، ارائه‌دهنده، واحدها و انواع منتشر می‌شوند. فقط ابعاد موجود در تعرفه فعال آن شارژ می‌شوند. یک تخمین اعتبارها را قبل از اجرا رزرو می‌کند؛ هزینه‌های نهایی بر اساس استفاده اندازه‌گیری‌شده محاسبه می‌شوند. قیمت‌ها ممکن است به وضوح، فرمت خروجی یا یک باند استفاده بستگی داشته باشند. برای بدهی نهایی ShareAI، Console Usage را بررسی کنید. فیلدهای هزینه بالادستی و بایت‌های رسانه به شمارش توکن‌های اختراعی تبدیل نمی‌شوند.

دسترسی و خطاها#

استفاده کنید inference برای استنتاج هزینه شبکه تأیید‌شده یا monetization_gateway برای افزایش قیمت تأیید‌شده Builder و شرایط صورتحساب پذیرفته‌شده. دسترسی فقط به هویت، مجوز هزینه کردن را نمی‌دهد. اعتبارسنجی، مجوز مدل، اعتبار ناکافی، محدودیت نرخ و شکست‌های اجرا یک ساختار بازگشتی را برمی‌گردانند. error. پس از یک زمان انتظار یا ارسال نامشخص، Usage یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینه‌بر باشد.

لینک به واحدهای صورتحساب

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

یک دستیار برای کاوش این صفحه انتخاب کنید. همچنین می‌توانید صفحه را کپی کرده و در مکالمه خود جای‌گذاری کنید.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI