Microsoft의 TRELLIS 이미지→3D 모델입니다 (83만+ 실행, Replicate 최다 사용 3D 모델). 이미지 1장 이상으로 텍스처가 입혀진 GLB 3D 에셋을 만들고, 턴테이블 렌더 영상과 Gaussian PLY도 출력할 수 있습니다.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "firtoz/trellis",
"input": {
"images": [
"https://example.com/product.png"
],
"generate_model": true,
"texture_size": 1024
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
images | array | Yes | - | 대상 오브젝트 이미지 1장 이상 (여러 각도면 품질 향상) |
seed | integer | No | 0 | 시드 (randomize_seed가 우선) |
randomize_seed | boolean | No | true | 시드 무작위화 |
generate_color | boolean | No | true | 컬러 턴테이블 렌더 영상 생성 |
generate_normal | boolean | No | false | 노멀 비디오 렌더링 생성 |
generate_model | boolean | No | false | 텍스처 GLB 3D 모델 파일 생성 |
save_gaussian_ply | boolean | No | false | 가우시안 포인트 클라우드를 PLY 파일로 저장 |
return_no_background | boolean | No | false | 배경을 제거한 전처리 이미지 반환 |
ss_guidance_strength | number | No | 7.5 | 1단계: Sparse Structure 생성 - 가이던스 강도 |
ss_sampling_steps | integer | No | 12 | 1단계: Sparse Structure 생성 - 샘플링 스텝 |
slat_guidance_strength | number | No | 3 | 2단계: Structured Latent 생성 - 가이던스 강도 |
slat_sampling_steps | integer | No | 12 | 2단계: Structured Latent 생성 - 샘플링 스텝 |
mesh_simplify | number | No | 0.95 | GLB 메시 단순화 비율 |
texture_size | integer | No | 1024 | GLB 텍스처 해상도 (generate_model 시) |
이 모델의 images 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=firtoz/trellis" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:images=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "firtoz/trellis",
"input": {
"prompt": "your prompt here",
"images": ["https://example.com/image.jpg"]
}
}POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
상품 사진 한 장으로 텍스처 3D 모델 생성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "firtoz/trellis",
"input": {
"images": [
"https://example.com/product.png"
],
"generate_model": true,
"texture_size": 1024
}
}'