ایک تصویر تیار کریں

ShareAI پر فی الحال فعال اور آپ کے اسناد کے ذریعے اجازت یافتہ ایک تصویر ماڈل استعمال کریں۔ ماڈل یہ طے کرتا ہے کہ کون سے سائز، معیار کی سطحیں اور آؤٹ پٹ اختیارات معاون ہیں۔

ایک درخواست بھیجیں#

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

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

درخواست کے فیلڈز#

تصویر پڑھیں#

واپس کیے گئے data اندراجات کا معائنہ کریں۔ ماڈل اور درخواست کردہ فارمیٹ پر منحصر ہے، ایک اندراج میں ایک HTTPS تصویر URL یا base64 تصویر ڈیٹا شامل ہو سکتا ہے۔ اصل واپس کیے گئے فارمیٹ کا استعمال کریں؛ یہ فرض نہ کریں کہ ہر فراہم کنندہ ایک URL واپس کرتا ہے۔ API آپ کے لیے واپس کیے گئے تصویر URLs کو ڈاؤن لوڈ نہیں کرتا۔

سائز اور وقت کی حدود#

درخواستیں ہم وقت ساز ہیں۔ مشترکہ ٹیکسٹ 256 KiB تک محدود ہے، فراہم کنندہ کال 120 سیکنڈ تک اور جواب 2 MiB تک۔ بڑے base64 تصاویر اس جواب کی حد سے تجاوز کر سکتی ہیں۔ ایک موزوں آؤٹ پٹ سائز یا ایک ماڈل منتخب کریں جو URL آؤٹ پٹ کی حمایت کرتا ہو۔

احتیاط سے دوبارہ کوشش کریں#

ایک تصویر تخلیق کرنا استعمال کا سبب بن سکتا ہے۔ ٹائم آؤٹ یا غیر واضح نیٹ ورک کی ناکامی کے بعد، دوبارہ کوشش کرنے سے پہلے سرگرمی کو چیک کریں؛ درخواست کو دہرانا ایک اور تصویر تخلیق کر سکتا ہے اور اس کے لیے چارج کر سکتا ہے۔ API فراہم کنندہ کو جمع کرانے کے بعد خود بخود تصویر کی درخواست کو دوبارہ کوشش نہیں کرتا۔

معاون آپریشنز#

یہ راستہ ٹیکسٹ سے تصاویر تخلیق کرتا ہے۔ تصویر میں ترمیم، مختلف حالتیں، ملٹی پارٹ اپ لوڈز اور اسٹریم شدہ تصویر تخلیق معاون نہیں ہیں۔ موجودہ بلنگ کے لیے ایک ہم آہنگ ماڈل/فراہم کنندہ ٹوکن استعمال کا معاہدہ ضروری ہے؛ صرف فی تصویر فراہم کنندگان دستیاب نہیں ہو سکتے۔

کسٹمر اجازت نامہ استعمال کریں#

ایک منظور شدہ OAuth فلو کے لیے، ایکسیس ٹوکن کو Bearer کے طور پر بھیجیں۔ اکاؤنٹ سے مالی اعانت شدہ تصویر تخلیق کے لیے surcharge اور ایک قبول شدہ استعمال کا منصوبہ ضروری ہے۔ تمام ماڈل، فراہم کنندہ اور اکاؤنٹ کی پابندیاں نافذ رہتی ہیں۔