تصاویر تخلیق کریں
ہم وقت JSON جواب میں ڈیٹا میں تصویری نتائج شامل ہیں۔.
اس صفحے پر
https://api.shareai.now/api/v1/imagesتصاویر تخلیق کریں
- بیس URL
https://api.shareai.now- تصدیق
- Bearer API کلید یا منظور شدہ 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 KiB 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 HTTPS URL یا سپورٹ شدہ امیج ڈیٹا URL پر سیٹ ہو۔ ماڈل کی حمایت ضروری ہے۔. |
provider | آبجیکٹ | اختیاری پرووائیڈر روٹنگ ترجیحات۔ قبول شدہ پرووائیڈر ٹیگز کے لیے provider.only استعمال کریں، ماڈل ID میں کسی پیشوند کے طور پر نہیں۔ اکاؤنٹ اور اسناد کی پابندیاں اب بھی لاگو ہوتی ہیں۔. |
نتیجہ پڑھیں#
کامیابی HTTP 200 کے ساتھ JSON واپس کرتی ہے۔ ہم وقت JSON ردعمل میں تصویر کے نتائج شامل ہیں data. ۔ عرف /api/v1/images/generations بھی معاون ہے۔ سائز، ریزولوشن، پہلو تناسب، معیار اور آؤٹ پٹ فارمیٹ جیسے اختیارات منتخب ماڈل پر منحصر ہیں۔ ردعمل 2 MiB تک محدود ہیں؛ ضرورت پڑنے پر تصویر کی تعداد یا سائز کم کریں۔ واپس کی گئی تصاویر ہر طرف 8192 پکسلز تک محدود ہیں۔.
بلنگ یونٹس#
تصویر کے نرخ پیدا شدہ تصاویر، ماپے گئے میگا پکسلز، ان پٹ حوالہ جات، درخواستیں یا فراہم کنندہ کی رپورٹ کردہ ٹوکنز استعمال کر سکتے ہیں۔ تصویر کا URL تصویر کے سائز کی پیمائش نہیں ہے۔ میگا پکسل نرخ واپس کی گئی تصویر کے طول و عرض کی ضرورت رکھتے ہیں؛ ان راستوں کے لیے base64 آؤٹ پٹ استعمال کریں۔.
کنسول سے درست فعال ماڈل شناخت کنندہ منتخب کریں۔ اس کا اعلان کردہ آپریشن اور ان پٹ/آؤٹ پٹ صلاحیتیں اس اینڈپوائنٹ سے مطابقت رکھنی چاہئیں؛ ایک ٹیکسٹ چیٹ ماڈل کو کسی دوسرے آپریشن کے لیے تبدیل نہیں کیا جا سکتا۔ آپ کی اسناد، پرووائیڈر اور اکاؤنٹ کی پابندیاں اب بھی لاگو ہوتی ہیں۔.
قیمتیں اور استعمال#
شرحیں منتخب ماڈل، پرووائیڈر، یونٹس اور ویریئنٹس کے لیے EUR AI کریڈٹس میں شائع کی جاتی ہیں۔ صرف اس کے فعال ٹیرف میں موجود ڈائمینشنز چارج کی جاتی ہیں۔ ایک تخمینہ عمل درآمد سے پہلے کریڈٹس محفوظ کرتا ہے؛ حتمی چارجز ماپی گئی استعمال پر مبنی ہوتے ہیں۔ قیمتیں ریزولوشن، آؤٹ پٹ فارمیٹ یا استعمال کے بینڈ پر منحصر ہو سکتی ہیں۔ حتمی ShareAI ڈیبٹ کے لیے کنسول استعمال چیک کریں۔ اپ اسٹریم لاگت کے فیلڈز اور میڈیا بائٹس کو ایجاد کردہ ٹوکین گنتی میں تبدیل نہیں کیا جاتا۔.
رسائی اور غلطیاں#
استعمال کریں inference منظور شدہ نیٹ ورک-لاگت انفرنس کے لیے یا monetization_gateway منظور شدہ بلڈر مارک اپ اور قبول شدہ بلنگ شرائط کے لیے۔ صرف شناختی رسائی خرچ کی اجازت نہیں دیتی۔ توثیق، ماڈل کی اجازت، ناکافی کریڈٹس، شرح کی حدود اور عمل درآمد کی ناکامیوں کے نتیجے میں ایک ساختہ error. ٹائم آؤٹ یا غیر یقینی جمع کرانے کے بعد، ایک اور ممکنہ طور پر ادا شدہ درخواست بنانے سے پہلے استعمال یا ویڈیو جاب کا معائنہ کریں۔.
آخری بار اپ ڈیٹ کیا گیا نومبر 3, 2026