Naar inhoud springen

VGGT-1B

Integreren

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

Tot $ 1,755 per uitvoering gefactureerd op basis van het werkelijke gebruik, de rest wordt terugbetaald Op deze pagina uitvoeren

API-sleutel ophalen
Meta Vision

Reconstrueert een 3D-scène uit maximaal 48 afbeeldingen of een video en retourneert dieptekaarten, cameraposes en een puntenwolk

Meta · Gegevens (JSON)

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

Geavanceerd 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
Sleep een bestand hierheen of · maximaal 48

Bronafbeeldingen voor reconstructie, elk aangevuld tot een vierkant en geschaald naar een langste dimensie van 518 pixels. JPEG, PNG, WEBP en elk ander door Pillow decodeerbaar afbeeldingsformaat worden geaccepteerd.

video_url
Sleep een bestand hierheen of

Optionele bronvideo waarvan gesamplede frames volgen op image_urls in de gecombineerde invoer. Er wordt elk `frame_sampling_rate`-de frame gesampled, waarbij altijd het eerste en laatste frame worden opgenomen.

alpha_blend_onto standaard white

De behandeling van het alfakanaal biedt vier keuzes: 'keep' verwijdert alpha zonder de oorspronkelijke pixelwaarden te wijzigen; 'mean' combineert met het ImageNet-gemiddelde voor RGB. Kies voor een effen achtergrond 'white' of 'black' om te combineren met de overeenkomstige kleur.

array_encoding standaard base64

Opslagindeling van arrays voor JSON-bestanden met voorspellingen, waarbij 'list' veel meer ruimte inneemt dan 'base64'. Kies 'list' voor geneste JSON-lijsten of 'base64' voor objecten met {data, shape, dtype}.

standaard 24

Frame-interval dat alleen wordt toegepast wanneer een video via `video_url` wordt aangeleverd; anders heeft het geen effect. Beide grensframes blijven behouden, ongeacht het interval, en daartussen wordt elk n-de frame gesampled.

standaard 50

Op betrouwbaarheid gebaseerd filterpercentage voor het samenstellen van de pointcloud: 0 schakelt filteren uit, terwijl andere waarden dat percentage aan punten uitsluiten, te beginnen met de minst betrouwbare.

standaard 250000

Limiet voor het aantal punten in GLB, standaard 250,000. Om serialisatie- en uploadlatentie laag te houden, wordt een gelijkmatig gesubsamplede selectie geschreven wanneer de cloud dit budget overschrijdt.

Sleutels die uit elk JSON-bestand met voorspellingen worden uitgesloten.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over VGGT-1B

Schat geometrie uit meerdere weergaven. Geef maximaal 48 afbeeldingen op in `image_urls` en voeg optioneel een `video_url` toe die om de `frame_sampling_rate` frames wordt gesampled. Retourneert dieptekaarten per frame, camera-extrinsieke en -intrinsieke parameters, onbewerkte voorspellingsbestanden en een GLB-puntenwolk met camerapiramides. `confidence_percentile` en `max_points` bepalen hoe dicht de puntenwolk is.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlsoptioneel images
Typeurl[] · image
≤ 48 items
Bronafbeeldingen voor reconstructie, elk aangevuld tot een vierkant en geschaald naar een langste dimensie van 518 pixels. JPEG, PNG, WEBP en elk ander door Pillow decodeerbaar afbeeldingsformaat worden geaccepteerd.
video_urloptioneel video
Typeurl · video
Optionele bronvideo waarvan gesamplede frames volgen op image_urls in de gecombineerde invoer. Er wordt elk `frame_sampling_rate`-de frame gesampled, waarbij altijd het eerste en laatste frame worden opgenomen.
frame_sampling_rateoptioneel
Typeinteger
Standaard24
1 – 1.000
Frame-interval dat alleen wordt toegepast wanneer een video via `video_url` wordt aangeleverd; anders heeft het geen effect. Beide grensframes blijven behouden, ongeacht het interval, en daartussen wordt elk n-de frame gesampled.
alpha_blend_ontooptioneel
Typeenum
Standaardwhite
keepwhiteblackmean
De behandeling van het alfakanaal biedt vier keuzes: 'keep' verwijdert alpha zonder de oorspronkelijke pixelwaarden te wijzigen; 'mean' combineert met het ImageNet-gemiddelde voor RGB. Kies voor een effen achtergrond 'white' of 'black' om te combineren met de overeenkomstige kleur.
export_prediction_dataoptioneel
Typeboolean
Standaardtrue
Exporteer onbewerkte voorspellingen als afzonderlijke JSON-bestanden voor individuele frames. Elk bestand bevat diepte en de bijbehorende betrouwbaarheid, een masker en de gecodeerde camerapose.
export_depth_mapsoptioneel
Typeboolean
Standaardtrue
Exporteer diepterasters met een lineaire toewijzing van `depth_range` aan pixelwaarden 0–65535. Elk frame krijgt een afzonderlijke grijswaarden-PNG met 16-bits precisie.
export_point_cloudoptioneel
Typeboolean
Standaardtrue
Exporteer de samengevoegde gekleurde pointcloud in GLB-indeling, waarbij geschatte camera's in de scène worden weergegeven door afzonderlijke kegelmeshes.
array_encodingoptioneel
Typeenum
Standaardbase64
base64list
Opslagindeling van arrays voor JSON-bestanden met voorspellingen, waarbij 'list' veel meer ruimte inneemt dan 'base64'. Kies 'list' voor geneste JSON-lijsten of 'base64' voor objecten met {data, shape, dtype}.
exclude_keysoptioneel
Typeenum[]
Sleutels die uit elk JSON-bestand met voorspellingen worden uitgesloten.
confidence_percentileoptioneel
Typenumber
Standaard50
0 – 100
Op betrouwbaarheid gebaseerd filterpercentage voor het samenstellen van de pointcloud: 0 schakelt filteren uit, terwijl andere waarden dat percentage aan punten uitsluiten, te beginnen met de minst betrouwbare.
max_pointsoptioneel
Typeinteger
Standaard250000
1.000 – 5.000.000
Limiet voor het aantal punten in GLB, standaard 250,000. Om serialisatie- en uploadlatentie laag te houden, wordt een gelijkmatig gesubsamplede selectie geschreven wanneer de cloud dit budget overschrijdt.
enable_safety_checkeroptioneel
Typeboolean
Standaardtrue
Schakelaar voor veiligheidscontroles van invoerafbeeldingen en video.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
point_cloud
object {url, content_type, file_name, file_size} | nullPointcloud-export die wordt geretourneerd wanneer `export_point_cloud` true is; de GLB-scène combineert de samengevoegde cloud met camerak kegels.
depth_maps
array of object {url, content_type, file_name, file_size, width, height}Dieptekaart-export die beschikbaar is wanneer `export_depth_maps` true is. Items volgen de volgorde van de bronframes, waarbij elk frame wordt weergegeven als een grijswaarden-PNG-raster met 16-bits diepte.
prediction_data
array of object {url, content_type, file_name, file_size}Export van onbewerkte voorspellingen: wanneer `export_prediction_data` true is, heeft elk frame een eigen JSON-bestand en volgen de bestanden de framevolgorde.
num_frames
integerTotaal aantal gereconstrueerde frames, inclusief afbeeldingen en uit video gesamplede frames.
depth_range
array of numberDieptegrenzen [min, max] die voor de kwantisering van `depth_maps` worden gebruikt. Herstel de diepte als min + pixel * (max - min) / 65535.
extrinsics
array of array of array of numberExtrinsieke camera-van-wereld-matrices, met grootte 3x4, voor elk frame; de OpenCV-assen wijzen rechts langs x, omlaag langs y en vooruit langs z.
intrinsics
array of array of array of numberPinhole-intrinsieke matrices, met grootte 3x3, voor elk frame, uitgedrukt in pixelcoördinaten van het modelkader van 518x518.
timings
objectVerstreken kloktijd voor elke fase, in seconden.

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/vggt-1b.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt