توليد ثلاثي الأبعاد

توليد ثلاثي الأبعاد غير متزامن. POST /v1/3d/generations ينشئ مهمة TokenLab؛ ردود الحالة المكتملة تعيد أصول النماذج القابلة للتنزيل مثل model_url وعند توفرها، روابط محددة للصيغة.

اختر نوع الإدخالCopy Anchor Link

استعلم عن كتالوج النماذج قبل اتخاذ قرار بشأن الخيارات التي يجب عرضها:

استخدم نوع الإدخال بدلًا من حقل operation لهذا endpoint. تعرض metadata الخاصة بالنموذج قدرات 3D كـ text-to-3d و/أو image-to-3d؛ 3d-generation ليست operation عامة في الطلب.

curl "https://api.tokenlab.sh/v1/models?recommended_for=3d" \
  -H "Authorization: Bearer sk-your-api-key"

تشمل أمثلة Tripo الحالية tripo-h3.1 لتدفقات text/image-to-3D عالية الجودة وtripo-p1.0 لإنشاء أصول ثلاثية الأبعاد بأسلوب إنتاجي. استخدم Models API للتأكد من أن النموذج المحدد يدعم نوع الإدخال وصيغة الإخراج المطلوبة.

لا تفترض أن كل نموذج ثلاثي الأبعاد يدعم كلا نوعي الإدخال أو كل صيغة إخراج. تحقق من تفاصيل النموذج المحدد قبل إرسال image, image_url, format, quality, style, أو seed.

إنشاء مهمة ثلاثية الأبعادCopy Anchor Link

curl 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": "تميمة روبوت منخفضة البولي مع طوبولوجيا نظيفة"
  }'

بالنسبة للصورة إلى ثلاثي الأبعاد، استخدم image_url العامة عند الإمكان. استخدم image بتنسيق inline/base64 فقط عندما يرسل عميلك وسائط خاصة عمدًا ويكون خادمك مستعدًا لأحجام طلبات أكبر.

خيارات صيغة الإخراجCopy Anchor Link

• glb هو عادة الخيار الافتراضي الأكثر أمانًا لمعاينات الويب.
• fbx و obj مفيدان لخطوط أنابيب DCC عندما يدعم النموذج المحدد ذلك.
• usdz مفيد لعمليات Apple AR عندما يتم عرضه بواسطة النموذج.
• يمكن أن تزيد قيم quality الأعلى من زمن الاستجابة والتكلفة. اعرضها كخيارات واضحة للمستخدمين، وليس كخيارات مخفية.
• seed مفيد للتكرار فقط عندما يحترم النموذج ذلك.

استعلام وتخزين الأصولCopy Anchor Link

استخدم poll_url المعاد أولاً. إذا كان عميلك يحتاج إلى مسار ثابت، استخدم GET /v1/tasks/{id}.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

تعود المهام المكتملة بـ model_url وقد تتضمن glb_url, fbx_url, obj_url, أو usdz_url. قم بتنزيل أو تخزين الأصل المحدد في منتجك الخاص إذا كان المستخدمون يحتاجون إلى الوصول المتكرر، تاريخ الإصدارات، أو التنزيلات طويلة الأمد.

قائمة التحقق للإنتاجCopy Anchor Link

• احتفظ بـ task_id, poll_url, النموذج، الصيغة المطلوبة، ومعرف سجل الأصل الخاص بك.
• استأنف الاستعلام بعد تحديث الصفحة بدلاً من إنشاء مهمة مكررة.
• تحقق من حجم الصورة المصدر وقابلية الوصول قبل إنشاء المهمة.
• احتفظ بروابط الأصول المولدة بعيدًا عن الصفحات العامة ما لم يكن لدى المستخدم إذن للوصول إلى الأصل.
• سجل billing_transaction_id عند وجوده للمصالحة لاحقًا.

الأخطاء الشائعةCopy Anchor Link

مرجع APICopy Anchor Link