الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
نظرة عامة

إنشاء تنويع من صورة معينة. يتطلب نوع المحتوى multipart/form-data.

​
جسم الطلب

مهلة الطلبات المتزامنة: قد يعيد بعض مزودي الصور الذين يتم التوجيه إليهم الصورة النهائية inline وينتظرون اكتمال التوليد. قد تستغرق طلبات الدقة العالية أو الجودة العالية ما يقارب دقيقة أو أكثر، لذا اضبط مهلة عميل HTTP على 120s على الأقل. إذا احتوت استجابة الإنشاء على status: "pending" أو task_id أو poll_url، فاتبع poll_url المُعاد بدلًا من الانتظار.
​
image
file
مطلوب
الصورة المستخدمة كأساس للتنويع. يجب أن تكون ملف PNG صالح، أقل من 50MB، ومربعة.
​
model
string
افتراضي:"dall-e-2"
النموذج المستخدم لتنويعات الصور. حالياً يُدعم dall-e-2 فقط.
​
n
integer
افتراضي:"1"
عدد الصور المراد إنشاؤها. يجب أن يكون بين 1 و 10.
​
size
string
حجم الصور المُنشأة. يجب أن يكون أحد: 256x256، 512x512، أو 1024x1024.
​
response_format
string
افتراضي:"url"
تنسيق إرجاع الصور المُنشأة. يجب أن يكون url أو b64_json.
​
user
string
معرف فريد يمثل المستخدم النهائي لمراقبة سوء الاستخدام.

​
الاستجابة

​
created
integer
الطابع الزمني Unix لوقت إنشاء الصور.
​
data
array
مصفوفة تنويعات الصور المُنشأة.كل عنصر يحتوي على:
  • url (string): رابط صورة التنويع (إذا كان response_format هو url)
  • b64_json (string): الصورة بترميز Base64 (إذا كان response_format هو b64_json)
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

​
ملاحظات

تنويعات الصور متاحة فقط مع DALL-E 2. سيُنشئ النموذج صوراً جديدة مشابهة في الأسلوب والمحتوى للصورة الأصلية.