Мазмұнға өту

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 кілтін алу

48-ге дейінгі суреттен немесе бейнеден 3D көріністі қалпына келтіріп, тереңдік карталарын, камера позаларын және нүктелер бұлтын қайтарады

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`-th кадр арқылы орындалады, бұл ретте бірінші және соңғы кадр әрқашан қосылады.

alpha_blend_onto әдепкі white

Альфа арнасын өңдеудің төрт нұсқасы бар: 'keep' бастапқы пиксель мәндерін өзгертпей альфаны жояды; 'mean' кескінді ImageNet орташа RGB мәнімен біріктіреді. Бір түсті фон үшін сәйкес түспен біріктіру мақсатында 'white' немесе 'black' таңдаңыз.

array_encoding әдепкі base64

Болжам JSON файлдарына арналған массивті сақтау форматы; 'list' нұсқасы 'base64' нұсқасына қарағанда әлдеқайда көп орын алады. Кірістірілген JSON тізімдері үшін 'list', ал {data, shape, dtype} нысандары үшін 'base64' таңдаңыз.

әдепкі 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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

VGGT-1B туралы

Бірнеше көрініс арқылы геометрияны бағалайды. `image_urls` ішіне 48-ге дейін сурет беріңіз, қажет болса әр `frame_sampling_rate` кадр сайын іріктелетін `video_url` қосыңыз. Әр кадрдың тереңдік карталарын, камераның сыртқы және ішкі параметрлерін, бастапқы болжам файлдарын және камера конустары бар 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`-th кадр арқылы орындалады, бұл ретте бірінші және соңғы кадр әрқашан қосылады.
frame_sampling_rateміндетті емес
Түріinteger
Әдепкі24
1 – 1 000
Тек бейне `video_url` арқылы берілгенде қолданылатын кадр аралығы; әйтпесе әсер етпейді. Аралыққа қарамастан, екі шеткі кадр да сақталады, ал олардың арасынан әрбір n-ші кадр алынады.
alpha_blend_ontoміндетті емес
Түріenum
Әдепкіwhite
keepwhiteblackmean
Альфа арнасын өңдеудің төрт нұсқасы бар: 'keep' бастапқы пиксель мәндерін өзгертпей альфаны жояды; 'mean' кескінді ImageNet орташа RGB мәнімен біріктіреді. Бір түсті фон үшін сәйкес түспен біріктіру мақсатында 'white' немесе 'black' таңдаңыз.
export_prediction_dataміндетті емес
Түріboolean
Әдепкіtrue
Жеке кадрларға арналған бастапқы болжамдарды бөлек JSON файлдары ретінде экспорттау. Әр файлда тереңдік және оның сенімділігі, маска және кодталған камера позасы қамтылады.
export_depth_mapsміндетті емес
Түріboolean
Әдепкіtrue
`depth_range` мәнін 0–65535 пиксель мәндеріне сызықтық бейнелеу арқылы тереңдік растрларын экспорттау. Әр кадр үшін 16 биттік дәлдіктегі бөлек сұр реңкті PNG жасалады.
export_point_cloudміндетті емес
Түріboolean
Әдепкіtrue
Біріктірілген түсті нүктелер бұлтын GLB форматында экспорттау; бағаланған камералар сахнада жеке конус торлары ретінде көрсетіледі.
array_encodingміндетті емес
Түріenum
Әдепкіbase64
base64list
Болжам JSON файлдарына арналған массивті сақтау форматы; 'list' нұсқасы 'base64' нұсқасына қарағанда әлдеқайда көп орын алады. Кірістірілген JSON тізімдері үшін 'list', ал {data, shape, dtype} нысандары үшін 'base64' таңдаңыз.
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
Кіріс кескіндері мен бейнесін қауіпсіздік тұрғысынан тексеруді қосу/өшіру.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдей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 болғанда қолжетімді тереңдік картасының экспорты. Элементтер бастапқы кадрлар ретімен беріледі, әр кадр 16 биттік сұр реңкті PNG растрі ретінде көрсетіледі.
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`depth_maps` кванттауында қолданылатын тереңдік шектері [min, max]. Тереңдікті 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/kk/developers/models/vggt-1b.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt