콘텐츠로 건너뛰기

Sam 3 · 3D Objects

통합

모델 id sam-3/3d-objects
# 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/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

이 요청: ≈$0.02 20 API 크레딧 이 페이지에서 실행

API 키 받기
Meta 이미지를 3D로 #3d#object

텍스트, 점, 상자 프롬프트 또는 마스크로 선택한 이미지 속 객체를 스플랫 출력과 함께 3D로 재구성합니다.

Meta · 3D

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

기본값 car

마스크가 없을 때 자동 분할에 사용할 텍스트입니다(예: 'chair' 또는 'lamp').

•필수 image_url
파일을 끌어다 놓거나

3D 재구성에 사용할 이미지 URL입니다.

고급 mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
파일을 끌어다 놓거나

객체별 선택적 마스크 URL 목록입니다. 마스크가 없으면 프롬프트, point_prompts 또는 box_prompts가 제공된 경우 자동 분할에 사용됩니다. 마스크와 분할 프롬프트가 모두 없으면 전체 이미지를 사용합니다.

NPY 또는 NPZ 형식의 외부 pointmap 또는 깊이 데이터를 제공하여 3D 재구성의 깊이 추정을 개선하는 선택적 URL입니다.

생략하면 모델의 기본값을 사용하는 탐지 신뢰도 기준값입니다. 값의 범위는 0.1~1.0이며, 값을 낮추면 정밀도가 낮아지는 대신 탐지 수가 증가합니다.

재현 가능한 무작위 생성에 사용되는 시드입니다.

기본값 []

마스크가 없을 때 자동 분할에 사용할 포인트 기반 프롬프트입니다.

기본값 []

자동 분할을 통해 3D 재구성용 개별 객체 마스크를 생성하는 상자 프롬프트입니다. 마스크가 제공되지 않은 경우에만 사용됩니다. 여러 상자를 제출할 수 있습니다.

POST /run/sam-3/3d-objects?wait=20 견적 → $0.02
# 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/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Sam 3 · 3D Objects 정보

사진 속 객체를 3D 에셋으로 변환합니다. `mask_urls`, 텍스트 `prompt`, `point_prompts` 또는 `box_prompts`로 객체를 선택하며, 여러 상자를 사용하면 별도의 객체가 생성됩니다. `detection_threshold`는 0.1부터 1까지 지원하고, `export_textured_glb`는 텍스처와 UV를 적용합니다. GLB, Gaussian 스플랫 파일, 다중 객체 장면의 객체별 파일, 메타데이터와 zip 번들을 출력합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
image_url필수 image
유형url · image
3D 재구성에 사용할 이미지 URL입니다.
mask_urls선택 사항
유형url[] · image
객체별 선택적 마스크 URL 목록입니다. 마스크가 없으면 프롬프트, point_prompts 또는 box_prompts가 제공된 경우 자동 분할에 사용됩니다. 마스크와 분할 프롬프트가 모두 없으면 전체 이미지를 사용합니다.
prompt선택 사항
유형string | null
기본값car
마스크가 없을 때 자동 분할에 사용할 텍스트입니다(예: 'chair' 또는 'lamp').
point_prompts선택 사항
유형object[]
기본값[]
마스크가 없을 때 자동 분할에 사용할 포인트 기반 프롬프트입니다.
point_prompts[].x선택 사항
유형integer | null
X축에서의 프롬프트 위치입니다.
point_prompts[].y선택 사항
유형integer | null
Y축에서의 프롬프트 위치입니다.
point_prompts[].label선택 사항
유형enum
01
전경/배경 레이블입니다. 1은 전경, 0은 배경을 나타냅니다.
point_prompts[].object_id선택 사항
유형integer | null
단일 객체를 세분화하는 프롬프트를 그룹화하는 선택적 식별자입니다. 텍스트도 프롬프트로 제공하면 이 식별자가 해당 포인트로 세분화할 감지된 객체를 결정합니다.
box_prompts선택 사항
유형object[]
기본값[]
자동 분할을 통해 3D 재구성용 개별 객체 마스크를 생성하는 상자 프롬프트입니다. 마스크가 제공되지 않은 경우에만 사용됩니다. 여러 상자를 제출할 수 있습니다.
box_prompts[].x_min선택 사항
유형integer | null
상자의 최소 x 좌표입니다.
box_prompts[].y_min선택 사항
유형integer | null
상자의 최소 y 좌표입니다.
box_prompts[].x_max선택 사항
유형integer | null
상자의 최대 X 좌표입니다.
box_prompts[].y_max선택 사항
유형integer | null
상자의 최대 Y 좌표입니다.
box_prompts[].object_id선택 사항
유형integer | null
단일 객체를 세분화하는 상자를 그룹화하는 선택적 식별자입니다.
seed선택 사항
유형integer | null
재현 가능한 무작위 생성에 사용되는 시드입니다.
pointmap_url선택 사항
유형string | null
NPY 또는 NPZ 형식의 외부 pointmap 또는 깊이 데이터를 제공하여 3D 재구성의 깊이 추정을 개선하는 선택적 URL입니다.
detection_threshold선택 사항
유형number | null
0.1 – 1
생략하면 모델의 기본값을 사용하는 탐지 신뢰도 기준값입니다. 값의 범위는 0.1~1.0이며, 값을 낮추면 정밀도가 낮아지는 대신 탐지 수가 증가합니다.
export_textured_glb선택 사항
유형boolean
기본값false
GLB 내보내기 옵션입니다. 활성화하면 정점 색상을 베이크된 텍스처와 UV로 대체합니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/3d-objects",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "gaussian_splat": {
      "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
    },
    "model_glb": {
      "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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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
    }
  },
  "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은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
gaussian_splat
object {url, content_type, file_name, file_size}여러 객체 결과의 결합된 장면 스플랫 또는 단일 객체 결과의 단일 스플랫입니다. .ply 형식의 Gaussian splat 파일로 제공됩니다.
model_glb
object {url, content_type, file_name, file_size}GLB로 저장된 3D 출력입니다. 여러 객체는 하나의 장면으로 조합되며, 그 외 결과에는 메시 하나가 포함됩니다.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}회전, 이동 및 스케일을 포함한 각 객체의 메타데이터입니다.
individual_splats
array of object {url, content_type, file_name, file_size} | null여러 객체가 있는 장면에서만 사용할 수 있는 객체별 별도 Gaussian splat 파일입니다.
individual_glbs
array of object {url, content_type, file_name, file_size} | null여러 객체가 있는 장면에서만 사용할 수 있는 객체별 별도 GLB 메시 파일입니다.
artifacts_zip
object {url, content_type, file_name, file_size} | null모든 산출물과 메타데이터의 ZIP 아카이브입니다.

더 많은 모델: 이미지를 3D로

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/sam-3/3d-objects.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt