דילוג לתוכן

VGGT-1B

שילוב

מזהה מודל vggt-1b
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vggt-1b?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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

עד ⁨‏1.755 ‏$⁩ להרצה החיוב מתבצע לפי השימוש בפועל, והיתרה מוחזרת הרצה בדף הזה

קבלת מפתח API
Meta ראייה

משחזר סצנה תלת-ממדית מתוך עד 48 תמונות או סרטון, ומחזיר מפות עומק, תנוחות מצלמה וענן נקודות

Meta · נתונים (JSON)

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

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

בנה בקשה

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

מתקדם images · video · alpha_blend_onto · array_encoding · frame_sampling_rate · confidence_percentile · max_points · export_prediction_data · export_depth_maps · export_point_cloud · enable_safety_checker · exclude_keys
image_urls
גרור קובץ, או · עד 48

תמונות מקור לשחזור, שכל אחת מהן מרופדת לריבוע ומשנה גודל לממד ארוך ביותר של 518 פיקסלים. מתקבלים JPEG, PNG, WEBP וכל פורמט תמונה נוסף שניתן לפענח באמצעות Pillow.

video_url
גרור קובץ, או

וידאו מקור אופציונלי שמסגרות שנדגמו ממנו מגיעות אחרי image_urls בקלט המשולב. הדגימה משתמשת בכל פריים `frame_sampling_rate`-י, ותמיד כוללת את הפריים הראשון והאחרון.

alpha_blend_onto ברירת מחדל white

טיפול בערוץ האלפא מציע ארבע אפשרויות: 'keep' מסיר את האלפא בלי לשנות את ערכי הפיקסלים המקוריים; 'mean' מרכיב מול ממוצע ה-RGB של ImageNet. לרקע אחיד, בחרו 'white' או 'black' כדי להרכיב מול הצבע המתאים.

array_encoding ברירת מחדל base64

פורמט אחסון מערך לקובצי JSON של תחזיות, כאשר 'list' תופס הרבה יותר מקום מ-'base64'. בחרו 'list' לרשימות JSON מקוננות או 'base64' לאובייקטים המכילים {data, shape, dtype}.

ברירת מחדל 24

מרווח פריימים שמוחל רק כאשר וידאו מסופק דרך `video_url`; אחרת אין לו השפעה. שני פריימי הגבול נשמרים בכל מקרה, וביניהם נדגם כל פריים n-י.

ברירת מחדל 50

אחוז הסינון לבניית ענן נקודות על בסיס רמת ביטחון: 0 משבית את הסינון, וערכים אחרים מחריגים את אחוז הנקודות שצוין, החל מהנקודות בעלות הביטחון הנמוך ביותר.

ברירת מחדל 250000

מגבלת מספר הנקודות ב-GLB, שברירת המחדל שלה היא 250,000. כדי לצמצם את זמן ההמרה וההעלאה, נכתב מבחר שנדגם באופן אחיד כאשר הענן חורג מתקציב זה.

מפתחות שלא ייכללו באף קובץ JSON של תחזית.

POST /run/vggt-1b?wait=20 הצעת מחיר → ⁨‏1.755 ‏$⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vggt-1b?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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

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

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

מידע על VGGT-1B

מעריך גאומטריה ממספר תצוגות. ספקו עד 48 תמונות ב-`image_urls`, ובאופן אופציונלי הוסיפו `video_url` שנדגם בכל `frame_sampling_rate` פריימים. הוא מחזיר מפות עומק לכל פריים, פרמטרים חיצוניים ופנימיים של המצלמה, קובצי חיזוי גולמיים וענן נקודות GLB עם חרוטי מצלמה. ‏`confidence_percentile` ו-`max_points` שולטים בצפיפות ענן הנקודות.

פרמטרים

שלח את השם הקנוני או את השם המקומי, לא את שניהם. שמות קנוניים

שםסוג ברירת מחדלמותר תיאור
image_urlsאופציונלי images
סוגurl[] · image
≤ 48 פריטים
תמונות מקור לשחזור, שכל אחת מהן מרופדת לריבוע ומשנה גודל לממד ארוך ביותר של 518 פיקסלים. מתקבלים JPEG, PNG, WEBP וכל פורמט תמונה נוסף שניתן לפענח באמצעות Pillow.
video_urlאופציונלי video
סוגurl · video
וידאו מקור אופציונלי שמסגרות שנדגמו ממנו מגיעות אחרי image_urls בקלט המשולב. הדגימה משתמשת בכל פריים `frame_sampling_rate`-י, ותמיד כוללת את הפריים הראשון והאחרון.
frame_sampling_rateאופציונלי
סוגinteger
ברירת מחדל24
1 – 1,000
מרווח פריימים שמוחל רק כאשר וידאו מסופק דרך `video_url`; אחרת אין לו השפעה. שני פריימי הגבול נשמרים בכל מקרה, וביניהם נדגם כל פריים n-י.
alpha_blend_ontoאופציונלי
סוגenum
ברירת מחדלwhite
keepwhiteblackmean
טיפול בערוץ האלפא מציע ארבע אפשרויות: 'keep' מסיר את האלפא בלי לשנות את ערכי הפיקסלים המקוריים; 'mean' מרכיב מול ממוצע ה-RGB של ImageNet. לרקע אחיד, בחרו 'white' או 'black' כדי להרכיב מול הצבע המתאים.
export_prediction_dataאופציונלי
סוגboolean
ברירת מחדלtrue
ייצוא התחזיות הגולמיות כקובצי JSON נפרדים לכל פריים. כל קובץ כולל עומק ורמת הביטחון שלו, מסכה ותנוחת מצלמה מקודדת.
export_depth_mapsאופציונלי
סוגboolean
ברירת מחדלtrue
ייצוא מפות עומק עם מיפוי ליניארי של `depth_range` לערכי פיקסלים 0–65535. לכל פריים נוצר PNG בגווני אפור נפרד בדיוק של 16 סיביות.
export_point_cloudאופציונלי
סוגboolean
ברירת מחדלtrue
ייצוא ענן הנקודות הצבעוני המאוחד בפורמט GLB, כאשר המצלמות המשוערות מיוצגות כרשתות חרוט נפרדות בסצנה.
array_encodingאופציונלי
סוגenum
ברירת מחדלbase64
base64list
פורמט אחסון מערך לקובצי JSON של תחזיות, כאשר 'list' תופס הרבה יותר מקום מ-'base64'. בחרו 'list' לרשימות JSON מקוננות או 'base64' לאובייקטים המכילים {data, shape, dtype}.
exclude_keysאופציונלי
סוגenum[]
מפתחות שלא ייכללו באף קובץ JSON של תחזית.
confidence_percentileאופציונלי
סוגnumber
ברירת מחדל50
0 – 100
אחוז הסינון לבניית ענן נקודות על בסיס רמת ביטחון: 0 משבית את הסינון, וערכים אחרים מחריגים את אחוז הנקודות שצוין, החל מהנקודות בעלות הביטחון הנמוך ביותר.
max_pointsאופציונלי
סוגinteger
ברירת מחדל250000
1,000 – 5,000,000
מגבלת מספר הנקודות ב-GLB, שברירת המחדל שלה היא 250,000. כדי לצמצם את זמן ההמרה וההעלאה, נכתב מבחר שנדגם באופן אחיד כאשר הענן חורג מתקציב זה.
enable_safety_checkerאופציונלי
סוגboolean
ברירת מחדלtrue
מתג לבדיקת בטיחות של תמונות ווידאו בקלט.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 10 MB, או את file_url של העלאה. קבצים

פלט

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "vggt-1b",
  "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": 1755,
    "usd": "1.755",
    "charged": 1755,
    "refunded": 0
  },
  "input": {},
  "output": {
    "point_cloud": {
      "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
    },
    "depth_maps": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "prediction_data": [
      {
        "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
      }
    ],
    "num_frames": 1,
    "depth_range": [
      1.0
    ],
    "extrinsics": [
      [
        [
          1.0
        ]
      ]
    ],
    "intrinsics": [
      [
        [
          1.0
        ]
      ]
    ],
    "timings": {}
  },
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
point_cloud
object {url, content_type, file_name, file_size} | nullייצוא ענן נקודות המוחזר כאשר `export_point_cloud` הוא true; סצנת ה-GLB שלו משלבת את הענן המאוחד עם חרוטי מצלמה.
depth_maps
array of object {url, content_type, file_name, file_size, width, height}ייצוא מפת עומק הזמין כאשר `export_depth_maps` הוא true. הרשומות עוקבות אחר רצף מסגרות המקור, כאשר כל פריים מיוצג כמפת PNG בגווני אפור בעומק של 16 סיביות.
prediction_data
array of object {url, content_type, file_name, file_size}ייצוא תחזיות גולמיות: כאשר `export_prediction_data` הוא true, לכל פריים יש קובץ JSON משלו, והקבצים עוקבים אחר רצף הפריימים.
num_frames
integerמספר הפריימים המשוחזרים הכולל, כולל תמונות ופריימים שנדגמו מווידאו.
depth_range
array of numberגבולות עומק [min, max] המשמשים לכימות `depth_maps`. שחזרו את העומק באמצעות min + pixel * (max - min) / 65535.
extrinsics
array of array of array of numberמטריצות חיצוניות של מצלמה-מהעולם, בגודל 3x4, לכל פריים; צירי OpenCV מצביעים ימינה לאורך x, מטה לאורך y וקדימה לאורך z.
intrinsics
array of array of array of numberמטריצות פנימיות של מצלמת נקב-סיכה, בגודל 3x3, לכל פריים, המבוטאות בקואורדינטות הפיקסלים של פריים המודל בגודל 518x518.
timings
objectזמן השעון שחלף בכל שלב, בשניות.

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