TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

الصور

إنشاء تنويع صورة

إنشاء تنويع من صورة معينة

POST
/v1/images/variations

نظرة عامة

يبقى هذا endpoint لعملاء variation القدامى المتوافقين مع OpenAI. ليس المسار الموصى به لتدفقات image-to-image الحالية؛ استخدم /v1/images/edits مع gpt-image-2 أو /v1/images/generations مع نموذج image-to-image مثل nano-banana-pro عندما يكون ذلك ممكنًا. يتطلب multipart/form-data.

جسم الطلب

مهلة الطلبات المتزامنة: قد يعيد بعض مزودي الصور الذين يتم التوجيه إليهم الصورة النهائية inline وينتظرون اكتمال التوليد. قد تستغرق طلبات الدقة العالية أو الجودة العالية ما يقارب دقيقة أو أكثر، لذا اضبط مهلة عميل HTTP على 120s على الأقل. إذا احتوت استجابة الإنشاء على status: "pending" أو task_id أو poll_url، فاتبع poll_url المُعاد بدلًا من الانتظار.

imagefileمطلوب

صورة مصدر بصيغة multipart. يجب ألا يتجاوز الملف وجسم الطلب الكامل 50 MiB لكل منهما. تعتمد الصيغ والأبعاد على النموذج المختار، ويجب أن تذكر تفاصيله الحالية /v1/images/variations صراحةً.

modelstringمطلوب

معرّف نموذج مطلوب للمسارات القديمة المتوافقة مع variation. لا توجد قيمة افتراضية ضمنية؛ لتدفقات image-to-image الحالية، فضّل /v1/images/edits أو /v1/images/generations مع نموذج حالي.

nintegerالافتراضي: 1

عدد الصور المطلوب إنشاؤها (1-10، بحسب النموذج).

sizestring

حجم الصور المُنشأة للمسارات القديمة المتوافقة مع variation. تعتمد القيم المدعومة على النموذج المحدد.

response_formatstring

تنسيق إرجاع الصور المُنشأة. يجب أن يكون url أو b64_json.

userstring

معرف فريد يمثل المستخدم النهائي لمراقبة سوء الاستخدام.

الاستجابة

createdinteger

الطابع الزمني Unix لوقت إنشاء الصور.

dataarray

مصفوفة تنويعات الصور المُنشأة.

كل عنصر يحتوي على:

  • 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 "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

الاستجابة

الاستجابة
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

ملاحظات

هذا endpoint توافق قديم. لا يظهر في كتالوج نماذج الصور الموصى بها حاليًا. للتكاملات الجديدة استخدم /v1/images/edits مع gpt-image-2، أو /v1/images/generations مع operation: "image-to-image" ونموذج image-to-image حالي.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

multipart/form-data

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

تعديل صورة

السابق

الحصول على حالة الصورة

التالي