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

​
Request Body

​
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
معرف فريد للمستخدم النهائي.

​
Response

​
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.lemondata.cc/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"
}