الصور

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

ينشئ تنويعاً لصورة محددة

POST
/v1/images/variations

نظرة عامة

تدعم نقطة النهاية هذه عملاء OpenAI Variations الحاليين. بالنسبة لميزات image-to-image الجديدة، استخدم /v1/images/edits أو /v1/images/generations مع نموذج image-to-image حالي. تستخدم الطلبات multipart/form-data.

نص الطلب

نقطة النهاية هذه متزامنة: تتضمن الاستجابة الصورة النهائية ولا تُرجع مهمة أبداً. اضبط مهلة عميل HTTP الخاص بك على 120s على الأقل.

imagefileمطلوب

صورة المصدر بصيغة multipart. يجب ألا يتجاوز حجم الملف ونص الطلب الكامل 50 MiB لكل منهما (عمليات الرفع الأكبر تُرجع 413). تعتمد التنسيقات والأبعاد المدعومة على النموذج المحدد. يُقبل فقط النموذج الذي تعيّن تفاصيله image-to-image إلى /v1/images/variations؛ وأي نموذج آخر يُرجع 400.

modelstringمطلوب

معرّف النموذج. لا تحتوي نقطة النهاية هذه على نموذج افتراضي. تستخدم الأمثلة العنصر النائب your-legacy-variation-model: استبدله بنموذج تُدرج تفاصيله نقطة النهاية هذه.

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

عدد الصور المراد توليدها (1-10، يعتمد على النموذج).

sizestring

حجم الصورة المُولّدة. تعتمد القيم المدعومة على النموذج المحدد.

response_formatstring

التنسيق الذي تُرجع به الصور المُولّدة. يجب أن يكون url أو b64_json.

userstring

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

الاستجابة

createdinteger

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

dataarray

مصفوفة من تنويعات الصور المُولّدة.

يحتوي كل كائن على:

  • url (string): رابط URL لصورة التنويع (إذا كان 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"

الاستجابة

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

ملاحظات

هذه نقطة نهاية للتوافق مع الإصدارات السابقة. وهي غير مدرجة في كتالوج نماذج الصور الموصى بها حالياً. بالنسبة لعمليات التكامل الجديدة، استخدم /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

application/json

application/json