Passer au contenu

VGGT-1B

Intégrer

Identifiant du modèle 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"

Jusqu’à 1,755 $ par exécution facturé selon l’utilisation réelle, le reste est remboursé L’exécuter sur cette page

Obtenir une clé API
Meta Vision

Reconstruit une scène 3D à partir de 48 images ou moins, ou d’une vidéo, et renvoie des cartes de profondeur, des poses de caméra et un nuage de points

Meta · Données (JSON)

Votre premier résultat apparaîtra ici

Créez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou pendant 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour au fur et à mesure de vos modifications.

Avancé 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
Déposez un fichier ou · jusqu’à 48

Images source de reconstruction, chacune avec ajout de marges pour devenir carrée puis redimensionnée à une dimension maximale de 518 pixels. JPEG, PNG, WEBP et tout autre format d’image décodable par Pillow sont acceptés.

video_url
Déposez un fichier ou

Vidéo source facultative dont les images échantillonnées suivent image_urls dans l’entrée combinée. L’échantillonnage utilise chaque image sur `frame_sampling_rate`, en incluant toujours la première et la dernière image.

alpha_blend_onto par défaut white

Le traitement du canal alpha offre quatre choix : 'keep' supprime l’alpha sans modifier les valeurs de pixels originales; 'mean' compose sur la moyenne RGB d’ImageNet. Pour un arrière-plan uni, choisissez 'white' ou 'black' pour composer sur la couleur correspondante.

array_encoding par défaut base64

Format de stockage des tableaux pour les fichiers JSON de prédictions; 'list' prend beaucoup plus d’espace que 'base64'. Choisissez 'list' pour les listes JSON imbriquées ou 'base64' pour les objets contenant {data, shape, dtype}.

par défaut 24

Intervalle d’images appliqué uniquement lorsqu’une vidéo est fournie par `video_url`; sinon, il n’a aucun effet. Les deux images limites sont conservées quel que soit l’intervalle, et chaque n-ième image intermédiaire est échantillonnée.

par défaut 50

Pourcentage de filtrage fondé sur la confiance pour la construction du nuage de points : 0 désactive le filtrage, tandis que les autres valeurs excluent ce pourcentage de points, en commençant par ceux dont la confiance est la plus faible.

par défaut 250000

Plafond du nombre de points GLB, établi par défaut à 250,000. Pour réduire la latence de sérialisation et de téléversement, une sélection sous-échantillonnée uniformément est écrite lorsque le nuage dépasse ce budget.

Clés exclues de chaque fichier JSON de prédictions.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement au Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de VGGT-1B

Estime la géométrie à partir de plusieurs vues. Fournissez jusqu’à 48 images dans `image_urls` et ajoutez éventuellement un `video_url` échantillonné toutes les `frame_sampling_rate` images. Renvoie des cartes de profondeur par image, les paramètres extrinsèques et intrinsèques de la caméra, les fichiers de prédiction bruts et un nuage de points GLB avec cônes de caméra. `confidence_percentile` et `max_points` contrôlent la densité du nuage de points.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlsfacultatif images
Typeurl[] · image
≤ 48 éléments
Images source de reconstruction, chacune avec ajout de marges pour devenir carrée puis redimensionnée à une dimension maximale de 518 pixels. JPEG, PNG, WEBP et tout autre format d’image décodable par Pillow sont acceptés.
video_urlfacultatif video
Typeurl · video
Vidéo source facultative dont les images échantillonnées suivent image_urls dans l’entrée combinée. L’échantillonnage utilise chaque image sur `frame_sampling_rate`, en incluant toujours la première et la dernière image.
frame_sampling_ratefacultatif
Typeinteger
Par défaut24
1 – 1 000
Intervalle d’images appliqué uniquement lorsqu’une vidéo est fournie par `video_url`; sinon, il n’a aucun effet. Les deux images limites sont conservées quel que soit l’intervalle, et chaque n-ième image intermédiaire est échantillonnée.
alpha_blend_ontofacultatif
Typeenum
Par défautwhite
keepwhiteblackmean
Le traitement du canal alpha offre quatre choix : 'keep' supprime l’alpha sans modifier les valeurs de pixels originales; 'mean' compose sur la moyenne RGB d’ImageNet. Pour un arrière-plan uni, choisissez 'white' ou 'black' pour composer sur la couleur correspondante.
export_prediction_datafacultatif
Typeboolean
Par défauttrue
Exporte les prédictions brutes sous forme de fichiers JSON distincts pour chaque image. Chaque fichier comprend la profondeur et son niveau de confiance, un masque et la pose de caméra encodée.
export_depth_mapsfacultatif
Typeboolean
Par défauttrue
Exporte les rasters de profondeur avec une correspondance linéaire de `depth_range` vers les valeurs de pixels 0–65535. Chaque image reçoit un fichier PNG en niveaux de gris distinct, avec une précision de 16 bits.
export_point_cloudfacultatif
Typeboolean
Par défauttrue
Exporte le nuage de points coloré fusionné au format GLB, avec les caméras estimées représentées par des maillages coniques individuels dans la scène.
array_encodingfacultatif
Typeenum
Par défautbase64
base64list
Format de stockage des tableaux pour les fichiers JSON de prédictions; 'list' prend beaucoup plus d’espace que 'base64'. Choisissez 'list' pour les listes JSON imbriquées ou 'base64' pour les objets contenant {data, shape, dtype}.
exclude_keysfacultatif
Typeenum[]
Clés exclues de chaque fichier JSON de prédictions.
confidence_percentilefacultatif
Typenumber
Par défaut50
0 – 100
Pourcentage de filtrage fondé sur la confiance pour la construction du nuage de points : 0 désactive le filtrage, tandis que les autres valeurs excluent ce pourcentage de points, en commençant par ceux dont la confiance est la plus faible.
max_pointsfacultatif
Typeinteger
Par défaut250000
1 000 – 5 000 000
Plafond du nombre de points GLB, établi par défaut à 250,000. Pour réduire la latence de sérialisation et de téléversement, une sélection sous-échantillonnée uniformément est écrite lorsque le nuage dépasse ce budget.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Activation des contrôles de sécurité pour les images et la vidéo d’entrée.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
point_cloud
object {url, content_type, file_name, file_size} | nullExportation du nuage de points renvoyée lorsque `export_point_cloud` est true; sa scène GLB combine le nuage fusionné et les cônes des caméras.
depth_maps
array of object {url, content_type, file_name, file_size, width, height}Exportation de la carte de profondeur disponible lorsque `export_depth_maps` est true. Les éléments suivent la séquence d’images source, chaque image étant représentée par un raster PNG en niveaux de gris d’une profondeur de 16 bits.
prediction_data
array of object {url, content_type, file_name, file_size}Exportation des prédictions brutes : lorsque `export_prediction_data` est true, chaque image possède son propre fichier JSON, et les fichiers suivent la séquence d’images.
num_frames
integerNombre total d’images reconstruites, y compris les images et les images échantillonnées à partir de la vidéo.
depth_range
array of numberLimites de profondeur [min, max] utilisées pour la quantification de `depth_maps`. Récupérez la profondeur avec min + pixel * (max - min) / 65535.
extrinsics
array of array of array of numberMatrices extrinsèques caméra-monde de 3x4 pour chaque image; les axes OpenCV pointent vers la droite selon x, vers le bas selon y et vers l’avant selon z.
intrinsics
array of array of array of numberMatrices intrinsèques sténopées de 3x3 pour chaque image, exprimées dans les coordonnées de pixels de l’image du modèle de 518x518.
timings
objectTemps réel écoulé pour chaque étape, en secondes.

Pour les agents IA : cette page en Markdown se trouve à https://doitong.com/fr-CA/developers/models/vggt-1b.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt