콘텐츠로 건너뛰기

Tripo3D · Image to 3D

통합

모델 id tripo3d/tripo/v2.5/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/tripo3d/tripo/v2.5/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

API 키 받기
Tripo 이미지를 3D로 #image-to-3d#stylized

스타일 프리셋, HD 텍스처링, 쿼드 출력 및 정렬 옵션을 지원하는 이미지-3D 변환(v2.5)

Tripo · 3D

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

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

요청 만들기

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

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

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

texture 기본값 standard

모델의 텍스처 설정입니다. 'standard'가 기본값이고, 'no'는 텍스처를 비활성화하며, 'HD'는 고해상도 텍스처를 생성합니다.

스타일 설정입니다. 원래 외관과 스타일을 유지하려면 지정하지 마세요.

고급 texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment 기본값 original_image

3D 모델의 텍스처 정렬 우선순위 설정입니다. 다른 값을 제공하지 않으면 original_image를 사용합니다.

orientation 기본값 default

모델 방향이며 처음에는 `default`로 설정됩니다. `align_image`를 선택하면 원본 이미지에 맞도록 모델을 자동으로 회전합니다.

출력 면 수의 상한입니다. 명시적인 제한을 제공하지 않으면 적응적으로 선택됩니다.

지오메트리 생성을 제어하는 정수 시드입니다. 재사용하면 동일한 모델이 생성됩니다. 생략하면 임의의 값이 선택됩니다.

텍스처 생성 시드입니다. 정수로 제공하거나 생략 시 무작위로 선택할 수 있습니다. 동일한 시드 값은 동일한 텍스처를 재생성합니다. 모델 시드를 유지한 채 모델 텍스처를 변경하려면 texture_seed를 변경하세요.

POST /run/tripo3d/tripo/v2.5/image-to-3d?wait=20 견적 → $0.30
# 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/tripo3d/tripo/v2.5/image-to-3d?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

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

Tripo3D · Image to 3D 정보

단일 `image_url`에서 3D 모델을 생성합니다. `texture`는 no, standard 또는 HD로 설정할 수 있으며 PBR 출력을 선택할 수 있습니다. clay, steampunk, gold, ancient bronze 등의 `style` 프리셋으로 결과물의 스타일을 바꿀 수 있습니다. 그 밖에 `face_limit`, `quad`(FBX 강제), `auto_size`, `texture_alignment`, `orientation`으로 모델을 이미지에 맞게 정렬할 수 있습니다.

매개변수

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

이름유형 기본값허용됨 설명
seed선택 사항
유형integer | null
지오메트리 생성을 제어하는 정수 시드입니다. 재사용하면 동일한 모델이 생성됩니다. 생략하면 임의의 값이 선택됩니다.
face_limit선택 사항
유형integer | null
출력 면 수의 상한입니다. 명시적인 제한을 제공하지 않으면 적응적으로 선택됩니다.
pbr선택 사항
유형boolean | null
기본값false
PBR 전환 옵션입니다. False이면 PBR이 없는 모델을 생성하고, True이면 텍스처 설정을 덮어써 True로 처리합니다. PBR은 기본적으로 활성화됩니다.
texture선택 사항
유형enum
기본값standard
nostandardHD
모델의 텍스처 설정입니다. 'standard'가 기본값이고, 'no'는 텍스처를 비활성화하며, 'HD'는 고해상도 텍스처를 생성합니다.
texture_seed선택 사항
유형integer | null
텍스처 생성 시드입니다. 정수로 제공하거나 생략 시 무작위로 선택할 수 있습니다. 동일한 시드 값은 동일한 텍스처를 재생성합니다. 모델 시드를 유지한 채 모델 텍스처를 변경하려면 texture_seed를 변경하세요.
auto_size선택 사항
유형boolean | null
기본값false
실제 크기 조정 옵션입니다. 기본값은 False이며, 미터를 사용해 모델 크기를 자동으로 조정합니다.
style선택 사항
유형enum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
스타일 설정입니다. 원래 외관과 스타일을 유지하려면 지정하지 마세요.
quad선택 사항
유형boolean | null
기본값false
활성화하면 쿼드 모드가 FBX 출력을 강제합니다. quad=True이고 face_limit을 지정하지 않으면 face_limit의 기본값은 10000입니다.
texture_alignment선택 사항
유형enum
기본값original_image
original_imagegeometry
3D 모델의 텍스처 정렬 우선순위 설정입니다. 다른 값을 제공하지 않으면 original_image를 사용합니다.
orientation선택 사항
유형enum
기본값default
defaultalign_image
모델 방향이며 처음에는 `default`로 설정됩니다. `align_image`를 선택하면 원본 이미지에 맞도록 모델을 자동으로 회전합니다.
image_url필수 image
유형url · image
모델 생성에 사용하는 이미지 URL입니다.
필수 표준 이름, 사용 가능

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

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/tripo/v2.5/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": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "task_id": "string",
    "model_mesh": {
      "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
    },
    "base_model": {
      "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
    },
    "pbr_model": {
      "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
    },
    "rendered_image": {
      "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.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은 모델 자체의 결과 객체입니다.
출력 필드
task_id
string3D 모델 생성을 위한 작업 식별자입니다.
model_mesh
object {url, content_type, file_name, file_size} | null모델 출력입니다.
base_model
object {url, content_type, file_name, file_size} | null기본 모델 출력입니다.
pbr_model
object {url, content_type, file_name, file_size} | nullPBR 모델 출력입니다.
rendered_image
object {url, content_type, file_name, file_size} | null모델 미리보기를 보여 주는 이미지입니다.

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

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