İçeriğe geç

VGGT-1B

Entegre et

Model kimliği 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"

Çalıştırma başına $1,755 değerine kadar gerçek kullanıma göre ücretlendirilir, kalanı iade edilir Bu sayfada çalıştır

API anahtarı al
Meta Görsel

En fazla 48 görüntüden veya bir videodan 3D sahneyi yeniden oluşturur; derinlik haritaları, kamera pozları ve nokta bulutu döndürür

Meta · Veri (JSON)

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

Gelişmiş 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
Dosyayı bırakın veya · 48 adede kadar

Her biri kare içine doldurulan ve uzun boyutu 518 piksele yeniden boyutlandırılan yeniden yapılandırma kaynak görselleri. JPEG, PNG, WEBP ve Pillow'un kodunu çözebildiği diğer görsel biçimleri kabul edilir.

video_url
Dosyayı bırakın veya

Birleşik girdide image_urls değerlerini takip eden örneklenmiş kareler için isteğe bağlı kaynak video. Örnekleme, her `frame_sampling_rate`-inci kareyi kullanır; ilk ve son kare her zaman dahil edilir.

alpha_blend_onto varsayılan white

Alfa kanalı işlemi dört seçenek sunar: 'keep', özgün piksel değerlerini değiştirmeden alfayı kaldırır; 'mean', ImageNet ortalama RGB değerine birleştirir. Düz bir arka plan için ilgili renkle birleştirmek üzere 'white' veya 'black' seçin.

array_encoding varsayılan base64

Tahmin JSON dosyaları için dizi depolama biçimi; 'list', 'base64' değerinden çok daha fazla alan kullanır. İç içe JSON listeleri için 'list', {data, shape, dtype} içeren nesneler için 'base64' seçin.

varsayılan 24

Yalnızca `video_url` üzerinden video sağlandığında uygulanan kare aralığı; aksi halde etkisi yoktur. Aralıktan bağımsız olarak her iki sınır karesi korunur ve aradaki her n-inci kare örneklenir.

varsayılan 50

Nokta bulutu oluşturma için güven tabanlı filtreleme yüzdesi: 0 filtrelemeyi devre dışı bırakır; diğer değerler, en düşük güvenliden başlayarak bu yüzde kadar noktayı hariç tutar.

varsayılan 250000

Varsayılanı 250,000 olan GLB nokta sayısı sınırı. Serileştirme ve yükleme gecikmesini azaltmak için bulut bu bütçeyi aşarsa eşit aralıklı örneklenmiş seçim yazılır.

Her tahmin JSON dosyasından hariç tutulan anahtarlar.

POST /run/vggt-1b?wait=20 fiyat → $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"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

VGGT-1B hakkında

Birden çok görünümden geometrinin tahminini yapar. `image_urls` içinde en fazla 48 görüntü sağlayın; isteğe bağlı olarak her `frame_sampling_rate` karede bir örneklenen bir `video_url` ekleyin. Kare başına derinlik haritaları, kamera dış ve iç parametrelerini, ham tahmin dosyalarını ve kamera konileri içeren bir GLB nokta bulutu döndürür. `confidence_percentile` ve `max_points`, nokta bulutunun yoğunluğunu belirler.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlsisteğe bağlı images
Türurl[] · image
≤ 48 öğe
Her biri kare içine doldurulan ve uzun boyutu 518 piksele yeniden boyutlandırılan yeniden yapılandırma kaynak görselleri. JPEG, PNG, WEBP ve Pillow'un kodunu çözebildiği diğer görsel biçimleri kabul edilir.
video_urlisteğe bağlı video
Türurl · video
Birleşik girdide image_urls değerlerini takip eden örneklenmiş kareler için isteğe bağlı kaynak video. Örnekleme, her `frame_sampling_rate`-inci kareyi kullanır; ilk ve son kare her zaman dahil edilir.
frame_sampling_rateisteğe bağlı
Türinteger
Varsayılan24
1 – 1.000
Yalnızca `video_url` üzerinden video sağlandığında uygulanan kare aralığı; aksi halde etkisi yoktur. Aralıktan bağımsız olarak her iki sınır karesi korunur ve aradaki her n-inci kare örneklenir.
alpha_blend_ontoisteğe bağlı
Türenum
Varsayılanwhite
keepwhiteblackmean
Alfa kanalı işlemi dört seçenek sunar: 'keep', özgün piksel değerlerini değiştirmeden alfayı kaldırır; 'mean', ImageNet ortalama RGB değerine birleştirir. Düz bir arka plan için ilgili renkle birleştirmek üzere 'white' veya 'black' seçin.
export_prediction_dataisteğe bağlı
Türboolean
Varsayılantrue
Ham tahminleri tek tek kareler için ayrı JSON dosyaları olarak dışa aktarır. Her dosya derinliği ve güvenini, bir maskeyi ve kodlanmış kamera pozunu içerir.
export_depth_mapsisteğe bağlı
Türboolean
Varsayılantrue
`depth_range` değerini 0–65535 piksel değerlerine doğrusal olarak eşleyen derinlik rasterlerini dışa aktarır. Her kare, 16 bit hassasiyetli ayrı bir gri tonlu PNG alır.
export_point_cloudisteğe bağlı
Türboolean
Varsayılantrue
Birleştirilmiş renkli nokta bulutunu GLB biçiminde dışa aktarır; tahmini kameralar sahnede ayrı koni ağları olarak gösterilir.
array_encodingisteğe bağlı
Türenum
Varsayılanbase64
base64list
Tahmin JSON dosyaları için dizi depolama biçimi; 'list', 'base64' değerinden çok daha fazla alan kullanır. İç içe JSON listeleri için 'list', {data, shape, dtype} içeren nesneler için 'base64' seçin.
exclude_keysisteğe bağlı
Türenum[]
Her tahmin JSON dosyasından hariç tutulan anahtarlar.
confidence_percentileisteğe bağlı
Türnumber
Varsayılan50
0 – 100
Nokta bulutu oluşturma için güven tabanlı filtreleme yüzdesi: 0 filtrelemeyi devre dışı bırakır; diğer değerler, en düşük güvenliden başlayarak bu yüzde kadar noktayı hariç tutar.
max_pointsisteğe bağlı
Türinteger
Varsayılan250000
1.000 – 5.000.000
Varsayılanı 250,000 olan GLB nokta sayısı sınırı. Serileştirme ve yükleme gecikmesini azaltmak için bulut bu bütçeyi aşarsa eşit aralıklı örneklenmiş seçim yazılır.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Görsel ve video girdileri için güvenlik denetimi anahtarı.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
point_cloud
object {url, content_type, file_name, file_size} | null`export_point_cloud` true olduğunda döndürülen nokta bulutu dışa aktarımı; GLB sahnesi birleştirilmiş bulutu kamera konileriyle birleştirir.
depth_maps
array of object {url, content_type, file_name, file_size, width, height}`export_depth_maps` true olduğunda kullanılabilen derinlik haritası dışa aktarımı. Girdiler kaynak kare sırasını izler; her kare 16 bit derinlikli gri tonlu PNG raster olarak gösterilir.
prediction_data
array of object {url, content_type, file_name, file_size}Ham tahmin dışa aktarımı: `export_prediction_data` true olduğunda her karenin kendi JSON dosyası olur ve dosyalar kare sırasını izler.
num_frames
integerGörseller ve videodan örneklenen kareler dahil toplam yeniden oluşturulan kare sayısı.
depth_range
array of number`depth_maps` nicelemesi için kullanılan derinlik sınırları [min, max]. Derinliği min + pixel * (max - min) / 65535 olarak geri elde edin.
extrinsics
array of array of array of numberHer kare için 3x4 boyutlu dünyadan kameraya dışsal matrisler; OpenCV eksenleri x boyunca sağa, y boyunca aşağıya ve z boyunca ileriye yönelir.
intrinsics
array of array of array of numberHer kare için 3x3 boyutlu iğne deliği içsel matrisleri; modelin 518x518 karesinin piksel koordinatlarıyla ifade edilir.
timings
objectHer aşama için geçen gerçek zamanlı süre, saniye cinsinden.

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/vggt-1b.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt