콘텐츠로 건너뛰기

Hunyuan3d V3 · Image to 3D

통합

모델 id hunyuan3d-v3/image-to-3d
# 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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

예시와 같은 파일: $0.375 375 API 크레딧 · ≈ ₽40.34 실행 전에 파일을 측정합니다 이 페이지에서 실행

API 키 받기

선택적 뒤/왼쪽/오른쪽 시점, PBR 및 저폴리 모드를 지원하는 Hunyuan3D V3 이미지-3D 변환

Tencent · 3D

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

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

요청 만들기

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

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

3D 모델 생성에 사용하는 이미지 URL입니다.

파일을 끌어다 놓거나

3D 재구성을 개선하기 위해 선택적으로 제공하는 후면 이미지 URL입니다.

파일을 끌어다 놓거나

3D 재구성을 개선하기 위해 선택적으로 제공하는 왼쪽 이미지 URL입니다.

파일을 끌어다 놓거나

3D 재구성을 개선하기 위해 선택적으로 제공하는 오른쪽 이미지 URL입니다.

generate_type 기본값 Normal

생성 모드입니다. `Normal`은 텍스처가 적용된 모델을 생성하고, `LowPoly`는 폴리곤 수를 줄이며, `Geometry`는 텍스처가 없는 흰색 모델을 생성합니다.

기본값 500000

원하는 면 수이며, 40,000~1,500,000 범위입니다.

고급 polygon_type · enable_safety_checker
polygon_type 기본값 triangle

폴리곤 유형입니다. `GenerateType`이 `LowPoly`인 경우에만 적용됩니다.

POST /run/hunyuan3d-v3/image-to-3d?wait=20 견적 → $0.375
# 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/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Hunyuan3d V3 · Image to 3D 정보

`input_image_url`에서 3D 모델을 생성하며, 재구성 개선을 위해 선택적으로 `back_image_url`, `left_image_url` 및 `right_image_url`을 제공합니다. `generate_type`은 Normal, LowPoly 또는 Geometry(텍스처 없음)를 선택하고, `polygon_type`은 LowPoly에 사용할 triangle 또는 quadrilateral을 선택합니다. `enable_pbr`은 PBR 재질을 추가하며 `face_count`는 40000~1500000 범위입니다. GLB, 다른 형식의 URL 및 썸네일을 반환합니다.

매개변수

이름유형 기본값허용됨 설명
input_image_url필수
유형url · image
3D 모델 생성에 사용하는 이미지 URL입니다.
enable_safety_checker선택 사항
유형boolean
기본값true
호출자에게 권한이 있으면 false로 설정해 검사를 완화할 수 있습니다.
back_image_url선택 사항
유형url · image
3D 재구성을 개선하기 위해 선택적으로 제공하는 후면 이미지 URL입니다.
left_image_url선택 사항
유형url · image
3D 재구성을 개선하기 위해 선택적으로 제공하는 왼쪽 이미지 URL입니다.
right_image_url선택 사항
유형url · image
3D 재구성을 개선하기 위해 선택적으로 제공하는 오른쪽 이미지 URL입니다.
enable_pbr선택 사항
유형boolean
기본값false
PBR 재질을 생성합니다. 단, generate_type이 Geometry이면 이 설정은 적용되지 않습니다.
face_count선택 사항
유형integer
기본값500000
40,000 – 1,500,000
원하는 면 수이며, 40,000~1,500,000 범위입니다.
generate_type선택 사항
유형enum
기본값Normal
NormalLowPolyGeometry
생성 모드입니다. `Normal`은 텍스처가 적용된 모델을 생성하고, `LowPoly`는 폴리곤 수를 줄이며, `Geometry`는 텍스처가 없는 흰색 모델을 생성합니다.
polygon_type선택 사항
유형enum
기본값triangle
trianglequadrilateral
폴리곤 유형입니다. `GenerateType`이 `LowPoly`인 경우에만 적용됩니다.
필수

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

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/image-to-3d",
  "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": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "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
    },
    "thumbnail": {
      "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_urls": {
      "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "usdz": {
        "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
      }
    },
    "seed": 42
  },
  "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은 모델 자체의 결과 객체입니다.
출력 필드
model_glb
object {url, content_type, file_name, file_size}생성된 3D 객체가 포함된 GLB 파일입니다.
thumbnail
object {url, content_type, file_name, file_size} | null생성된 모델의 미리보기를 보여주는 썸네일입니다.
model_urls
object {glb, fbx, obj, usdz}다양한 형식의 3D 모델 링크입니다.
seed
integer | null생성 중 사용하는 시드 값입니다.

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

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