Preskoči na vsebino

VGGT-1B

Integracija

ID modela 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"

Do 1,755 $ na zagon zaračuna se dejanska uporaba, preostanek se vrne Zaženi na tej strani

Pridobi ključ API
Meta Vid

Rekonstruira 3D-prizor iz največ 48 slik ali videoposnetka ter vrne globinske zemljevide, položaje kamer in oblak točk

Meta · Podatki (JSON)

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

Napredno 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
Spustite datoteko ali · do 48

Izvorne slike za rekonstrukcijo, vsaka z dodanimi robovi v kvadrat in spremenjena na največjo mero 518 slikovnih pik. Sprejeti so JPEG, PNG, WEBP in kateri koli dodatni format slike, ki ga lahko dekodira Pillow.

video_url
Spustite datoteko ali

Izbirni izvorni video, katerega vzorčene sličice sledijo image_urls v kombiniranem vhodu. Vzorčenje uporablja vsako `frame_sampling_rate`-to sličico, pri čemer vedno vključi prvo in zadnjo sličico.

alpha_blend_onto privzeto white

Obravnava kanala alfa ponuja štiri možnosti: 'keep' odstrani alfo brez spreminjanja izvornih vrednosti slikovnih pik; 'mean' sestavi sliko glede na povprečni RGB ImageNet. Za enobarvno ozadje izberite 'white' ali 'black', da se slika sestavi glede na ustrezno barvo.

array_encoding privzeto base64

Oblika shranjevanja polj za datoteke napovedi JSON, pri čemer 'list' zavzame veliko več prostora kot 'base64'. Izberite 'list' za ugnezdene sezname JSON ali 'base64' za objekte, ki vsebujejo {data, shape, dtype}.

privzeto 24

Interval sličic, uporabljen samo, ko je video poslan prek `video_url`; sicer nima učinka. Obe mejni sličici se ohranita ne glede na interval, vmes pa se vzorči vsaka n-ta sličica.

privzeto 50

Odstotek filtriranja za izdelavo oblaka točk na podlagi zanesljivosti: 0 onemogoči filtriranje, druge vrednosti pa izključijo navedeni odstotek točk, začenši z najmanj zanesljivimi.

privzeto 250000

Omejitev števila točk v GLB, privzeto 250,000. Za zmanjšanje zakasnitve serializacije in nalaganja se ob preseganju tega proračuna zapiše enakomerno podvzorčen izbor.

Ključi, izključeni iz vsake datoteke napovedi JSON.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu VGGT-1B

Oceni geometrijo iz več pogledov. V `image_urls` podajte največ 48 slik, po želji pa dodajte `video_url`, vzorčen na vsakih `frame_sampling_rate` kadrov. Vrne globinske zemljevide za vsak kader, zunanje in notranje parametre kamere, neobdelane datoteke napovedi ter oblak točk GLB s stožci kamer. `confidence_percentile` in `max_points` določata gostoto oblaka točk.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlsneobvezno images
Vrstaurl[] · image
≤ 48 elementov
Izvorne slike za rekonstrukcijo, vsaka z dodanimi robovi v kvadrat in spremenjena na največjo mero 518 slikovnih pik. Sprejeti so JPEG, PNG, WEBP in kateri koli dodatni format slike, ki ga lahko dekodira Pillow.
video_urlneobvezno video
Vrstaurl · video
Izbirni izvorni video, katerega vzorčene sličice sledijo image_urls v kombiniranem vhodu. Vzorčenje uporablja vsako `frame_sampling_rate`-to sličico, pri čemer vedno vključi prvo in zadnjo sličico.
frame_sampling_rateneobvezno
Vrstainteger
Privzeto24
1 – 1000
Interval sličic, uporabljen samo, ko je video poslan prek `video_url`; sicer nima učinka. Obe mejni sličici se ohranita ne glede na interval, vmes pa se vzorči vsaka n-ta sličica.
alpha_blend_ontoneobvezno
Vrstaenum
Privzetowhite
keepwhiteblackmean
Obravnava kanala alfa ponuja štiri možnosti: 'keep' odstrani alfo brez spreminjanja izvornih vrednosti slikovnih pik; 'mean' sestavi sliko glede na povprečni RGB ImageNet. Za enobarvno ozadje izberite 'white' ali 'black', da se slika sestavi glede na ustrezno barvo.
export_prediction_dataneobvezno
Vrstaboolean
Privzetotrue
Izvozi surove napovedi kot ločene datoteke JSON za posamezne sličice. Vsaka datoteka vključuje globino in njeno zanesljivost, masko ter kodiran položaj kamere.
export_depth_mapsneobvezno
Vrstaboolean
Privzetotrue
Izvozi rastrske podatke globine z linearnim preslikavanjem `depth_range` v vrednosti slikovnih pik 0–65535. Vsaka sličica dobi ločen sivinski PNG s 16-bitno natančnostjo.
export_point_cloudneobvezno
Vrstaboolean
Privzetotrue
Izvozi združen obarvan oblak točk v formatu GLB, pri čemer so ocenjene kamere v prizoru predstavljene s posameznimi stožčastimi mrežami.
array_encodingneobvezno
Vrstaenum
Privzetobase64
base64list
Oblika shranjevanja polj za datoteke napovedi JSON, pri čemer 'list' zavzame veliko več prostora kot 'base64'. Izberite 'list' za ugnezdene sezname JSON ali 'base64' za objekte, ki vsebujejo {data, shape, dtype}.
exclude_keysneobvezno
Vrstaenum[]
Ključi, izključeni iz vsake datoteke napovedi JSON.
confidence_percentileneobvezno
Vrstanumber
Privzeto50
0 – 100
Odstotek filtriranja za izdelavo oblaka točk na podlagi zanesljivosti: 0 onemogoči filtriranje, druge vrednosti pa izključijo navedeni odstotek točk, začenši z najmanj zanesljivimi.
max_pointsneobvezno
Vrstainteger
Privzeto250000
1000 – 5.000.000
Omejitev števila točk v GLB, privzeto 250,000. Za zmanjšanje zakasnitve serializacije in nalaganja se ob preseganju tega proračuna zapiše enakomerno podvzorčen izbor.
enable_safety_checkerneobvezno
Vrstaboolean
Privzetotrue
Preklop za varnostno preverjanje vhodnih slik in videa.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
point_cloud
object {url, content_type, file_name, file_size} | nullIzvoz oblaka točk, vrnjen, ko je `export_point_cloud` true; njegov prizor GLB združuje zlit oblak s stožci kamer.
depth_maps
array of object {url, content_type, file_name, file_size, width, height}Izvoz globinskih zemljevidov, na voljo, ko je `export_depth_maps` true. Vnosi sledijo zaporedju izvornih sličic, pri čemer je vsaka sličica predstavljena kot sivinski rastrski PNG z 16-bitno globino.
prediction_data
array of object {url, content_type, file_name, file_size}Izvoz surovih napovedi: ko je `export_prediction_data` true, ima vsaka sličica svojo datoteko JSON, datoteke pa sledijo zaporedju sličic.
num_frames
integerSkupno število rekonstruiranih sličic, vključno s slikami in sličicami, vzorčenimi iz videa.
depth_range
array of numberMeje globine [min, max], uporabljene za kvantizacijo `depth_maps`. Globino obnovite kot min + pixel * (max - min) / 65535.
extrinsics
array of array of array of numberZunanje matrike kamera-iz-sveta velikosti 3x4 za vsako sličico; osi OpenCV kažejo desno vzdolž x, navzdol vzdolž y in naprej vzdolž z.
intrinsics
array of array of array of numberNotranje matrike modela luknjičaste kamere velikosti 3x3 za vsako sličico, izražene v koordinatah slikovnih pik modelove sličice 518x518.
timings
objectPretečeni čas po stenski uri za vsako fazo, v sekundah.

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/vggt-1b.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt