الصور
إنشاء تنويع للصورة
ينشئ تنويعاً لصورة محددة
نظرة عامة
تدعم نقطة النهاية هذه عملاء OpenAI Variations الحاليين. بالنسبة لميزات image-to-image الجديدة، استخدم /v1/images/edits أو /v1/images/generations مع نموذج image-to-image حالي. تستخدم الطلبات multipart/form-data.
نص الطلب
نقطة النهاية هذه متزامنة: تتضمن الاستجابة الصورة النهائية ولا تُرجع مهمة أبداً. اضبط مهلة عميل HTTP الخاص بك على 120s على الأقل.
صورة المصدر بصيغة multipart. يجب ألا يتجاوز حجم الملف ونص الطلب الكامل 50 MiB لكل منهما (عمليات الرفع الأكبر تُرجع 413). تعتمد التنسيقات والأبعاد المدعومة على النموذج المحدد. يُقبل فقط النموذج الذي تعيّن تفاصيله image-to-image إلى /v1/images/variations؛ وأي نموذج آخر يُرجع 400.
معرّف النموذج. لا تحتوي نقطة النهاية هذه على نموذج افتراضي. تستخدم الأمثلة العنصر النائب your-legacy-variation-model: استبدله بنموذج تُدرج تفاصيله نقطة النهاية هذه.
1عدد الصور المراد توليدها (1-10، يعتمد على النموذج).
حجم الصورة المُولّدة. تعتمد القيم المدعومة على النموذج المحدد.
التنسيق الذي تُرجع به الصور المُولّدة. يجب أن يكون url أو b64_json.
معرّف فريد يمثل المستخدم النهائي الخاص بك لمراقبة إساءة الاستخدام.
الاستجابة
طابع زمني بتنسيق Unix لوقت إنشاء الصور.
مصفوفة من تنويعات الصور المُولّدة.
يحتوي كل كائن على:
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"الاستجابة
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}ملاحظات
هذه نقطة نهاية للتوافق مع الإصدارات السابقة. وهي غير مدرجة في كتالوج نماذج الصور الموصى بها حالياً. بالنسبة لعمليات التكامل الجديدة، استخدم /v1/images/edits مع gpt-image-2، أو /v1/images/generations مع operation: "image-to-image" ونموذج image-to-image حالي.
التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات 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