نماذج التوليد

القوالب هي وصفات “تأثيرات إبداعية” جاهزة مسبقا ل /v1/images/generations /v1/videos/generations. كل قالب يرسل نموذجا موصى به، وقائمة بالنماذج المدعومة، والمعلمات الافتراضية، وقواعد الإدخال المطلوبة. مرر template: "<slug>" في جسم الطلب ويقوم EmpirioLabs بتطبيق التأثير مع أي نموذج آخر تقدمه، ويختار أفضل نموذج مدعوم لك، ويحول المكالمة إلى الموظف.

كما أن نفس النموذج يقوى على الزر الذي يرمز** في ساحة اللعب.

نماذج القائمة

1
curl https://api.empiriolabs.ai/v1/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

إستخدم نقطة النهاية العامة للصورة الكاملة والفيديو كتالوج، أو نقاط النهاية الخاصة بالطرائق عندما تعرف بالفعل نوع الجيل.

$
curl https://api.empiriolabs.ai/v1/templates?modality=image \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

نماذج الفيديو المدرجة في القائمة

1
curl https://api.empiriolabs.ai/v1/videos/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

الأفلام

• category: viral, cinematic, motion, transform, social, extend, product, edit, portrait
• modality: video or image
• model: أعد فقط القوالب التي تدعم نموذج معين
• featured: true to filter to featured templates only

$
curl https://api.empiriolabs.ai/v1/videos/templates?category=viral \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

شكل الاستجابة

1
{
2
  "object": "list",
3
  "template_count": 11,
4
  "data": [
5
    {
6
      "slug": "baseball-stadium",
7
      "display_name": "Stadium",
8
      "category": "viral",
9
      "description": "Customer-facing description shown in the playground card.",
10
      "recommended_model": "kling-o3",
11
      "supported_models": ["kling-o3"],
12
      "default_params": { "aspect_ratio": "16:9", "duration": 10 },
13
      "required_inputs": { "image": true, "min_images": 1, "max_images": 1 },
14
      "cover_image_url": "https://media.empiriolabs.ai/assets/template-posters/baseball-stadium.jpg",
15
      "preview_video_url": "https://media.empiriolabs.ai/assets/template-previews/baseball-stadium.mp4",
16
      "modality": "video",
17
      "is_featured": true,
18
      "display_order": 10
19
    }
20
  ]
21
}

نماذج الصور المدرجة في القائمة

1
curl https://api.empiriolabs.ai/v1/images/templates \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/images/templates?model=seedream-5-0-lite \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

أحضر نموذجاً واحداً

1
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json"

$
curl https://api.empiriolabs.ai/v1/templates/studio-product-shot \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

يَعُودُ 404 مَع code: "template_not_found" إذا الصَمغَ لَيسَ موجودَ.

يولد فيديو مع نموذج

أضف template: "<slug>" إلى مكالمة /v1/videos/generations عادية. يجب عليك تقديم ما يتطلبه القالب (required_inputs)، عادة صورة مرجعية.

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "baseball-stadium",
>
    "image_url": "https://example.com/me.jpg"
>
  }'

السلوك:

• اختيار النماذج: إذا لم تنجح model، يتم استخدام recommended_model القالب. إذا فعلت، معظم القوالب تتحقق من أنها في supported_models وتعيد 400 template_model_unsupported خلاف ذلك. القوالب التي تحتوي على metadata.force_recommended_model: true تثبت على recommended_model لضمان دقة التأثير.
• ** التحقق من الطريقة**: لا تنطبق نماذج الصور إلا على /v1/images/generations ؛ ولا تنطبق نماذج الفيديو إلا على /v1/videos/generations.
• مزج الطلبات: يتم دمج prompt (إن وجدت) مع التنسيق المدمج في القالب بحيث يتطابق الناتج مع طلبك وجمالية التأثير. أرسل رسالة توجيهية قصيرة؛ EmpirioLabs يتولى الباقي.
• الشروط الافتراضية: default_params من القالب تدمج فقط للمفاتيح التي لم تحدد صراحة.
• المدخلات المطلوبة: \{ "image": true \} يعني أن المكالمة تعيد 400 template_missing_image إذا لم يتم توفير image_url / image / images.

تولد صورة مع نموذج

$
curl https://api.empiriolabs.ai/v1/images/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "template": "background-swap",
>
    "prompt": "Place this product on a brushed steel studio plinth",
>
    "image": ["https://example.com/product.jpg"]
>
  }'

The response is the same async job envelope as a normal video generation:

1
{
2
  "job_id": "abc123...",
3
  "status": "processing",
4
  "poll_url": "/v1/jobs/abc123..."
5
}

استطلاع GET /v1/jobs/\{job_id\} حتى المحطة النهائية.

توسيع شريط فيديو سابق

كما يقبل /v1/videos/generations extend_from الاستمرار في الجيل السابق. EmpirioLabs يتولى أسلاك المشبك المسبق نيابة عنك ويستخدم استمرارية منطقية ما لم توفر لك توصية خاصة بك.

$
curl https://api.empiriolabs.ai/v1/videos/generations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "extend_from": { "job_id": "<prior_job_id>" }
>
  }'

يمكنكِ أيضاً أن تمرري مباشرة

1
{ "extend_from": { "video_url": "https://media.empiriolabs.ai/..." } }

يمكن للتوسع أن يلخص مع النماذج:

1
{
2
  "template": "action-hero",
3
  "extend_from": { "job_id": "<prior>" }
4
}

المخرج يعمل على كل نموذج فيديو

مرر extend_from مع أي نموذج فيديو مدعوم. إذا استبعدت model، EmpirioLabs يختار افتراضيا معقولا للتمديد.

رموز الرعب