الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

توليد نماذج ثلاثية الأبعاد من النصوص أو الصور باستخدام Tripo3D ومزودين آخرين. هذه API غير متزامنة. تعيد استجابة الإنشاء هوية المهمة، وقد تتضمن أيضًا poll_url مفضلًا عند توفره.

​
جسم الطلب

​
model
string
افتراضي:"tripo3d-v2.5"
النموذج المراد استخدامه (على سبيل المثال، tripo3d-v2.5 أو tripo3d-v2).
​
prompt
string
مطلوب
وصف نصي للنموذج ثلاثي الأبعاد المراد توليده.
​
image
string
صورة بترميز Base64 لتوليد نموذج ثلاثي الأبعاد من صورة.
​
image_url
string
رابط (URL) الصورة لتوليد نموذج ثلاثي الأبعاد من صورة.
​
format
string
افتراضي:"glb"
تنسيق المخرجات: glb أو fbx أو obj أو usdz.
​
quality
string
افتراضي:"standard"
مستوى الجودة: draft أو standard أو high.
​
style
string
نمط مسبق الإعداد للنموذج.
​
seed
integer
بذرة (seed) لضمان توليد نتائج متطابقة.
​
user
string
معرف فريد للمستخدم النهائي.

​
الاستجابة

​
id
string
معرف المهمة (Task ID) للاستعلام عن الحالة.
​
task_id
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يعيده المهايئ.
​
poll_url
string
رابط polling المفضّل عندما يكون متاحًا.
​
status
string
حالة المهمة: pending أو processing أو completed أو failed.
​
created
integer
طابع زمني بتنسيق 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": "tripo3d-v2.5",
    "prompt": "A detailed medieval castle with towers",
    "format": "glb",
    "quality": "high"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo3d-v2.5"
}