3D
إنشاء نموذج ثلاثي الأبعاد
إنشاء مهمة لتوليد نموذج ثلاثي الأبعاد
توليد نماذج ثلاثية الأبعاد من النصوص أو الصور باستخدام Tripo3D ومزودين آخرين. هذه API غير متزامنة. تعيد استجابة الإنشاء هوية المهمة، وقد تتضمن أيضًا poll_url مفضلًا عند توفره.
يتم استنتاج عمليات 3D العامة من شكل الطلب: الطلبات التي تحتوي على prompt فقط تُعامل كـ text-to-3d، والطلبات التي تحتوي على image أو image_url تُعامل كـ image-to-3d. لا يعرّض هذا endpoint حقل طلب باسم operation؛ لا ترسل القيمة القديمة 3d-generation.
جسم الطلب
قبل إرسال الحقول الاختيارية، راجع المعلمات التي يقبلها النموذج عبر GET /v1/models/{model}. يرسل المثال model وprompt فقط.
tripo-h3.1النموذج المراد استخدامه، مثل tripo-h3.1 أو tripo-p1.0. استخدم GET /v1/models?recommended_for=3d قبل الاعتماد على نوع إدخال أو صيغة إخراج محددة.
وصف نصي للنموذج ثلاثي الأبعاد المراد توليده.
صورة بترميز Base64 لتوليد نموذج ثلاثي الأبعاد من صورة.
رابط (URL) الصورة لتوليد نموذج ثلاثي الأبعاد من صورة.
صيغة الإخراج؛ يعتمد الدعم والقيم المقبولة على النموذج المحدد.
إعداد الجودة؛ يعتمد الدعم والقيم المقبولة على النموذج المحدد.
نمط مسبق الإعداد للنموذج.
بذرة عددية صحيحة، إذا كان النموذج المحدد يدعمها.
معرف فريد للمستخدم النهائي.
الاستجابة
معرف المهمة (Task ID) للاستعلام عن الحالة.
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يعيده المهايئ.
رابط polling المفضّل عندما يكون متاحًا.
حالة المهمة: pending أو processing أو completed أو failed.
طابع زمني بتنسيق Unix لوقت إنشاء المهمة.
الطلب
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'الاستجابة
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.
القيم المتاحة
- "auto"
- "verified"
- "official"
جسم الطلب
application/json
الاستجابة
application/json
application/json