تولید یک تصویر

از یک مدل تصویر که در حال حاضر در 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 ورودی‌های بازگشتی. بسته به مدل و فرمت درخواست‌شده، یک ورودی شامل یک URL تصویر HTTPS یا داده تصویر base64 است. از فرمت بازگشتی واقعی استفاده کنید؛ فرض نکنید که هر ارائه‌دهنده یک URL بازمی‌گرداند. API تصویرهای URL بازگشتی را برای شما دانلود نمی‌کند.

محدودیت‌های اندازه و زمان‌بندی#

درخواست‌ها همزمان هستند. متن ترکیبی به 256 کیلوبایت محدود است، تماس ارائه‌دهنده به 120 ثانیه و پاسخ به 2 مگابایت. تصاویر base64 بزرگ می‌توانند از این محدودیت پاسخ فراتر روند. یک اندازه خروجی مناسب یا مدلی که خروجی URL را پشتیبانی می‌کند انتخاب کنید.

با دقت دوباره تلاش کنید#

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

عملیات‌های پشتیبانی‌شده#

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

استفاده از مجوز مشتری#

برای جریان OAuth تایید شده، توکن دسترسی را به‌عنوان Bearer ارسال کنید. تولید تصویر تأمین‌شده توسط حساب نیازمند surcharge و یک طرح استفاده پذیرفته شده است. تمام محدودیت‌های مدل، ارائه‌دهنده و حساب همچنان اعمال می‌شوند.