تولید تصاویر
پاسخ JSON همزمان شامل نتایج تصویر در داده است.
در این صفحه
https://api.shareai.now/api/v1/imagesتولید تصاویر
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);فیلدهای درخواست#
| فیلد | نوع | معنا و محدودیتها |
|---|---|---|
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 یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینهبر باشد.
لینک به واحدهای صورتحساب