דילוג לתוכן

Tripo H3.1 Text to 3D

שילוב

מזהה מודל tripo3d/h3.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

קבצים כמו בדוגמה: ⁨‏0.20 ‏$⁩ 200 קרדיטי API · ≈ ⁨‏21.52 ‏₽⁩ הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Tripo טקסט ל-3D #3d#text-to-3d#3d-generation#tripo

מחולל רשת טקסט-ל-3D עם פרומפט שלילי, רמות איכות נפרדות לגאומטריה ולטקסטורה, ותקרת פאות גבוהה מאוד

Tripo · 3D

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה 88 / 1024

תיאור טקסטואלי של אובייקט התלת-ממד הרצוי, באורך מרבי של 1024 תווים.

texture_quality ברירת מחדל standard

הגדרת איכות הטקסטורה; בחירה ב-'detailed' מגדילה את רזולוציית הטקסטורה.

geometry_quality ברירת מחדל standard

הגדרת האיכות של הגאומטריה.

מתקדם negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

תיאור התכונות שיש להחריג מהמודל שנוצר.

יעד מפורש למספר הפאות ביצירת הרשת, העוקף את בחירת המספר האדפטיבית של המודל כאשר הוא מסופק.

Seed המשמש להפיכת יצירת הגאומטריה לניתנת לשחזור.

Seed המשמש בשלב text-to-image.

Seed המשמש להפיכת יצירת הטקסטורות לניתנת לשחזור.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 הצעת מחיר → ⁨‏0.20 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/tripo3d/h3.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

הרצת הבקשה הזו

המפתח שלך נשאר בדפדפן הזה: הוא נשלח רק אל Doitong API ונשמר ב-localStorage רק אם מסמנים זכור. קבל מפתח API

מידע על Tripo H3.1 Text to 3D

בונה מודל 3D מתיאור טקסטואלי באורך של עד 1024 תווים, עם `negative_prompt` אופציונלי למאפיינים שיש להימנע מהם. `face_limit` מקבל 1,000 עד 2,000,000 פאות. `geometry_quality` ו-`texture_quality` יכולים להיות באיכות רגילה או מפורטת. האפשרויות כוללות חומרי PBR, טופולוגיית quad, שינוי קנה מידה אוטומטי לגודל בעולם האמיתי, וגרעינים נפרדים לגאומטריה, לשלב הטקסט-לתמונה ולטקסטורה.

פרמטרים

שםסוג ברירת מחדלמותר תיאור
promptחובה
סוגstring
≤ 1,024 תווים
תיאור טקסטואלי של אובייקט התלת-ממד הרצוי, באורך מרבי של 1024 תווים.
negative_promptאופציונלי
סוגstring | null
≤ 1,024 תווים
תיאור התכונות שיש להחריג מהמודל שנוצר.
face_limitאופציונלי
סוגinteger | null
1,000 – 2,000,000
יעד מפורש למספר הפאות ביצירת הרשת, העוקף את בחירת המספר האדפטיבית של המודל כאשר הוא מסופק.
textureאופציונלי
סוגboolean
ברירת מחדלtrue
קובע אם המודל מקבל מרקמים שנוצרו.
pbrאופציונלי
סוגboolean
ברירת מחדלtrue
הפעלת חומרי PBR (Physically Based Rendering), שמפעילה גם יצירת טקסטורות כאשר הערך הוא true.
model_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הגאומטריה לניתנת לשחזור.
image_seedאופציונלי
סוגinteger | null
Seed המשמש בשלב text-to-image.
texture_seedאופציונלי
סוגinteger | null
Seed המשמש להפיכת יצירת הטקסטורות לניתנת לשחזור.
texture_qualityאופציונלי
סוגenum
ברירת מחדלstandard
standarddetailed
הגדרת איכות הטקסטורה; בחירה ב-'detailed' מגדילה את רזולוציית הטקסטורה.
geometry_qualityאופציונלי
סוגenum
ברירת מחדלstandard
standarddetailed
הגדרת האיכות של הגאומטריה.
auto_sizeאופציונלי
סוגboolean
ברירת מחדלfalse
קנה מידה אוטומטי להענקת ממדים מציאותיים למודל, הנמדדים במטרים.
quadאופציונלי
סוגboolean
ברירת מחדלfalse
בחירה בין פאות משולשות לבין מרובעים בעלי 4 צלעות באמצעות הפעלת טופולוגיית quad. עבור תוצאות quad, מוחזר קובץ FBX בכל פעם ש-Tripo מספק את הנתונים כבתים של FBX.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
ניתן להקל את הסינון באמצעות הגדרה ל-false, אם הצד הקורא מורשה לכך.
חובה

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 200,
    "usd": "0.20",
    "charged": 200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "base_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "pbr_model": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rendered_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
model_mesh
object {url, content_type, file_name, file_size}קובץ GLB או FBX המכיל את מודל התלת-ממד שנוצר, כשהפורמט נקבע לפי מה ש-Tripo מייצר.
model_urls
object {glb, fbx, base_model, pbr_model}כתובות URL המצביעות על גרסאות חלופיות של מודל התלת-ממד.
rendered_image
object {url, content_type, file_name, file_size} | nullתצוגה מקדימה מרונדרת המציגה את מודל התלת-ממד שנוצר.
task_id
string | nullמזהה משימה לשימוש חוזר של Tripo, המזהה את המודל שנוצר עבור rig או rig-check ומאפשר פעולות אלה ללא העלאה נוספת של מודל.

מודלים נוספים: טקסט ל-3D

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/tripo3d/h3.1/text-to-3d.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt