poll_url مفضلًا عند توفره.
يتم استنتاج عمليات 3D العامة من شكل الطلب: الطلبات التي تحتوي على prompt فقط تُعامل كـ text-to-3d، والطلبات التي تحتوي على image أو image_url تُعامل كـ image-to-3d. لا يعرّض هذا endpoint حقل طلب باسم operation؛ لا ترسل القيمة القديمة 3d-generation.
جسم الطلب
string
افتراضي:"tripo-h3.1"
النموذج المراد استخدامه، مثل
tripo-h3.1 أو tripo-p1.0. استخدم GET /v1/models?recommended_for=3d قبل الاعتماد على نوع إدخال أو صيغة إخراج محددة.string
مطلوب
وصف نصي للنموذج ثلاثي الأبعاد المراد توليده.
string
صورة بترميز Base64 لتوليد نموذج ثلاثي الأبعاد من صورة.
string
رابط (URL) الصورة لتوليد نموذج ثلاثي الأبعاد من صورة.
string
افتراضي:"glb"
تنسيق المخرجات:
glb أو fbx أو obj أو usdz.string
افتراضي:"standard"
مستوى الجودة:
draft أو standard أو high.string
نمط مسبق الإعداد للنموذج.
integer
بذرة (seed) لضمان توليد نتائج متطابقة.
string
معرف فريد للمستخدم النهائي.
الاستجابة
string
معرف المهمة (Task ID) للاستعلام عن الحالة.
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يعيده المهايئ.
string
رابط polling المفضّل عندما يكون متاحًا.
string
حالة المهمة:
pending أو processing أو completed أو failed.integer
طابع زمني بتنسيق Unix لوقت إنشاء المهمة.