Seed3D 2.0 API

ByteDance

이미지 한 장으로 질감이 풍부한 3D 모델, 캐릭터에 강함

bytedance/seed3d-2.0/image-to-3d
  • 이미지를 3D로

Seed3D 2.0 소개

이미지 한 장으로 질감이 풍부한 3D 모델, 캐릭터에 강함.

POST /jobs/createTask에서 모델 이름을 bytedance/seed3d-2.0/image-to-3d(으)로 지정하면 호출할 수 있습니다. US$0.48부터.

소개

Seed3D 2.0은 ByteDance Seed 팀의 3D 에셋 모델로, 2026년 4월에 공개되었습니다. 사진 한 장을 읽어 그 안의 물체를 재질을 갖춘 완전한 3D 메시로 만듭니다. 그래서 제품 사진이나 캐릭터 렌더링을 돌려 보고, 조명을 비추고, 장면에 배치할 수 있는 것으로 바꿀 수 있습니다. 요청은 이미지 한 장(image_url)과 선택 사항인 밀도 스위치(mesh_detail)를 받습니다. 프롬프트, seed, 스타일 필드는 없습니다. 결과는 텍스처가 내장된 바이너리 glTF 파일 한 개(.glb)입니다.

주요 특징

사진 한 장에서 형상과 재질을

Seed3D 2.0은 형상과 물리 기반 재질을 함께 생성합니다. 저희 테스트에서 모든 모델은 4096×4096 텍스처 두 장, 즉 베이스 컬러 맵과 메탈-러프니스 맵으로 반환되었습니다. 그래서 가죽은 낡고 무광한 질감으로 보였고, 황동 아일릿과 헬멧 바이저에는 하이라이트가 살아났습니다. 별도의 노멀 맵은 없으며, 표면 디테일은 메시 자체에 들어 있습니다.

촘촘하고 닫힌 메시

기본 medium 레벨에서 두 테스트 모델은 모두 하나의 메시와 하나의 재질로, 약 50만 삼각형에 조금 못 미치게 반환되었습니다. low에서는 같은 부츠가 99,977개의 면을 가졌습니다. 공식 설명으로는 레벨이 약 10만, 50만, 100만 면에 해당합니다. 메시가 촘촘하면 신발끈, 스티칭, 손가락 같은 작은 특징을 더 잘 담고, 가벼우면 브라우저에서 더 빨리 로드됩니다.

저희가 측정한 결과

1024×1024 가죽 부츠 스튜디오 사진과 682×1024 장난감 우주비행사 렌더링을 보냈습니다. 둘 다 유효한 GLB 파일로 반환되었습니다. 크기는 37.2 MB와 28.6 MB, 삼각형은 499,998개와 499,992개였고, 처리 시간은 356초와 340초였습니다. 우주비행사는 얼굴, 바이저, 가슴 패널, 오렌지색 트림을 모든 방향에서 유지했습니다. 부츠는 정면을 곧게 바라보는 뷰로 보냈고, 결과에서는 뒤쪽 절반이 앞쪽의 거울상으로 나타났습니다.

요청 파라미터

파라미터필수설명
image_url예출발점이 되는 이미지.
mesh_detail아니요메시 밀도: low(약 10만 면), medium(약 50만 면), high(약 100만 면). 세 단계 가격은 같고, 단계가 높을수록 세부가 살아나며 파일이 커집니다. low · medium · high · 기본값: medium

가격

요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

옵션USD /회
기본US$0.48

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

활용 사례

이커머스와 제품 뷰어

패키지샷을 제품 페이지나 AR 미리보기용 인터랙티브 모델로 바꿀 수 있습니다. 제품은 단색 배경에서 3/4 각도로 촬영하거나 렌더링하고, 물체 전체가 프레임 안에 들어가도록 하세요. 디테일과 다운로드 크기의 균형을 위해 medium 레벨을 쓰세요.

캐릭터, 장난감, 컬렉터블

캐릭터 렌더링과 피규어 사진은 형태가 단순하고 색이 선명해 잘 변환됩니다. 텍스처는 얼굴, 배지, 줄무늬 같은 그려진 디테일을 담습니다. 뒷면은 추론되므로, 캐릭터의 대부분이 보이는 포즈를 고르세요.

프롬프트 가이드와 고급 팁

사진 준비하기

피사체는 하나, 가운데 배치, 주변에 여백을 두고 프레임 가장자리에 닿지 않게 하세요. 밝고 단순한 배경은 물체를 깔끔하게 분리합니다. JPEG, PNG, WebP를 10 MB까지 받으며, 이미지 비율은 대략 2:5에서 5:2 사이여야 합니다.

의도적으로 각도 고르기

모델은 한쪽 면만 봅니다. 신발이나 자동차를 정면으로 곧게 찍으면 길이를 알 수 없고, 가려진 쪽이 앞면의 거울상으로 채워질 수 있습니다. 앞면과 한쪽 옆면이 함께 보이는 3/4 뷰가 훨씬 신뢰할 만한 결과를 줍니다.

사용처에 맞는 디테일 레벨 고르기

모바일 미리보기와 소품이 많은 장면에는 low, 대부분의 웹 뷰어에는 medium, 가까이에서 검사하거나 3D 프린팅할 때는 high를 쓰세요.

배포 전에 결과 확인

뷰어에서 GLB를 열어 끝까지 한 바퀴 돌려 보고, 보여 주지 않은 쪽을 확인하세요. 뒷면이 이상하면 다른 디테일 레벨보다 다른 각도의 사진을 시도하세요.

API 빠른 시작

Seed3D 2.0 API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 bytedance/seed3d-2.0/image-to-3d, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seed3d-2.0/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "mesh_detail": "medium"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Seed3D 2.0 API 질문

Seed3D 2.0 API 요금은 얼마인가요?

Seed3D 2.0 가격은 US$0.48 /회입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

API에서 Seed3D 2.0의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 모델 이름 이미지를 3D로: bytedance/seed3d-2.0/image-to-3d 값을 입력하세요.

무엇을 받게 되나요?

텍스처가 내장된 .glb 파일(바이너리 glTF 2.0) 하나입니다. 테스트에서는 베이스 컬러와 메탈릭-러프니스 맵 두 장, 둘 다 4096×4096 PNG였습니다. Blender, three.js, model-viewer, Unity, Unreal에서 바로 불러옵니다.

프롬프트가 필요한가요?

아니요. 필수 입력은 이미지 하나뿐입니다. mesh_detail은 선택 사항이며 메시 밀도만 바꿉니다.

어떤 이미지가 좋나요?

피사체 하나가 프레임 안에 모두 들어오고, 배경은 단색이며, 45도 각도에서 본 이미지입니다. 복잡한 장면, 잘린 사물, 정면 사진은 보이지 않는 부분을 모델이 추측하게 만듭니다.

Seed3D 2.0 API의 제한은 무엇인가요?

최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

Seed3D 2.0 모델을 코드 없이 사용해 볼 수 있나요?

Playground에서 API 키 없이 API의 미국 달러 잔액으로 Seed3D 2.0 모델을 실행할 수 있습니다. 각 실행은 해당 코드와 함께 개발자 기록에 저장됩니다.

Seed3D 2.0 더 알아보기