콘텐츠로 건너뛰기

VGGT-1B

통합

모델 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

실행당 최대 $1.755 실제 사용량에 따라 과금되며 나머지는 환불됩니다 이 페이지에서 실행

API 키 받기
Meta 비전

최대 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`번째 프레임마다 샘플링하며, 항상 첫 프레임과 마지막 프레임을 포함합니다.

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 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`번째 프레임마다 샘플링하며, 항상 첫 프레임과 마지막 프레임을 포함합니다.
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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 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/ko/developers/models/vggt-1b.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt