3D 모델

#1. 모델 선택

#2. 요청 복사

YOUR_API_KEY를 내 키로 바꾼 뒤 실행하세요. 표시된 옵션은 이 모델이 받는 옵션입니다.

curl https://www.aisplice.store/v1/model3d/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo-3d",
    "operation": "text_to_model",
    "prompt": "A small ceramic fox, stylised, smooth glaze",
    "texture": true,
    "pbr": true
  }'
# → {"task_id": "…", "status": "queued"}

curl https://www.aisplice.store/v1/model3d/tasks/$TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

모든 필드: API 레퍼런스의 /v1/model3d/tasks →

#3. 결과 받기

제출 호출은 바로 task_id로 응답합니다. status가 completed가 될 때까지 몇 초마다 작업을 조회하거나, webhook_url을 넘기면 완료 시 저희가 호출해 드립니다.

status가 completed가 되면 모델 파일은 url(그리고 output.model_url)에 있습니다. 3D에는 /content 경로가 없습니다.

상태 값과 폴링 → · 조회 대신 콜백 받기 →

#문제가 생겼을 때

• 입력 작업을 찾을 수 없음: 텍스처링, 분할, 리토폴로지, 리깅에는 완료된 3D 모델의 작업 ID가 필요합니다.
• 402: 잔액이 이 요청에 부족합니다. 지갑에서 충전한 뒤 다시 시도하세요.
• 429: 요청 속도를 줄이고 Retry-After 초만큼 기다린 뒤 다시 시도하세요.
• 503 model_not_found: 모델 이름이 틀렸거나 모델이 오프라인입니다. 1단계에서 다시 고르세요.

다른 오류 찾아보기 →

#단계 연결하기

먼저 모델을 만든 뒤, 그 작업 ID를 input으로 넘겨 텍스처링, 분할, 리토폴로지, 리깅을 하세요. 각 단계는 별도의 작업으로 과금됩니다.