POST /v1/3d/generations ينشئ مهمة TokenLab؛ ردود الحالة المكتملة تعيد أصول النماذج القابلة للتنزيل مثل model_url وعند توفرها، روابط محددة للصيغة.
اختر نوع الإدخال
استعلم عن كتالوج النماذج قبل اتخاذ قرار بشأن الخيارات التي يجب عرضها:
استخدم نوع الإدخال بدلًا من حقل
operation لهذا endpoint. تعرض metadata الخاصة بالنموذج قدرات 3D كـ text-to-3d و/أو image-to-3d؛ 3d-generation ليست operation عامة في الطلب.
tripo-h3.1 لتدفقات text/image-to-3D عالية الجودة وtripo-p1.0 لإنشاء أصول ثلاثية الأبعاد بأسلوب إنتاجي. استخدم Models API للتأكد من أن النموذج المحدد يدعم نوع الإدخال وصيغة الإخراج المطلوبة.
لا تفترض أن كل نموذج ثلاثي الأبعاد يدعم كلا نوعي الإدخال أو كل صيغة إخراج. تحقق من تفاصيل النموذج المحدد قبل إرسال image, image_url, format, quality, style, أو seed.
إنشاء مهمة ثلاثية الأبعاد
image_url العامة عند الإمكان. استخدم image بتنسيق inline/base64 فقط عندما يرسل عميلك وسائط خاصة عمدًا ويكون خادمك مستعدًا لأحجام طلبات أكبر.
خيارات صيغة الإخراج
glbهو عادة الخيار الافتراضي الأكثر أمانًا لمعاينات الويب.fbxوobjمفيدان لخطوط أنابيب DCC عندما يدعم النموذج المحدد ذلك.usdzمفيد لعمليات Apple AR عندما يتم عرضه بواسطة النموذج.- يمكن أن تزيد قيم
qualityالأعلى من زمن الاستجابة والتكلفة. اعرضها كخيارات واضحة للمستخدمين، وليس كخيارات مخفية. seedمفيد للتكرار فقط عندما يحترم النموذج ذلك.
استعلام وتخزين الأصول
استخدمpoll_url المعاد أولاً. إذا كان عميلك يحتاج إلى مسار ثابت، استخدم GET /v1/tasks/{id}.
model_url وقد تتضمن glb_url, fbx_url, obj_url, أو usdz_url. قم بتنزيل أو تخزين الأصل المحدد في منتجك الخاص إذا كان المستخدمون يحتاجون إلى الوصول المتكرر، تاريخ الإصدارات، أو التنزيلات طويلة الأمد.
قائمة التحقق للإنتاج
- احتفظ بـ
task_id,poll_url, النموذج، الصيغة المطلوبة، ومعرف سجل الأصل الخاص بك. - استأنف الاستعلام بعد تحديث الصفحة بدلاً من إنشاء مهمة مكررة.
- تحقق من حجم الصورة المصدر وقابلية الوصول قبل إنشاء المهمة.
- احتفظ بروابط الأصول المولدة بعيدًا عن الصفحات العامة ما لم يكن لدى المستخدم إذن للوصول إلى الأصل.
- سجل
billing_transaction_idعند وجوده للمصالحة لاحقًا.