빠른 시작

사진 한 장으로 몇 분 만에 GLB까지.

  1. 1. API 키 만들기

    서버의 환경 변수에 보관하세요.

    export WANDY3D_API_KEY="hg_live_…"
  2. 2. 잔액 충전하기

    $5부터 충전할 수 있어요. 잔액은 무료 호출로 언제든 확인할 수 있어요.

    curl https://api.wandy3d.com/api/platform/balance \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"balance_usd": "<balance>", "month_spent_usd": "<spent>", …}
  3. 3. 모델 생성하기

    사진을 보내고, 작업 상태를 확인한 뒤 GLB를 다운로드하세요. 요금은 잔액에서 차감되고 응답에 표시돼요.

    # 1. Start a generation from a photo (Wandy 2)curl -s -X POST "https://api.wandy3d.com/generate/cloud/ultra" \  -H "Authorization: Bearer $WANDY3D_API_KEY" \  -F "file=@photo.jpg"# → {"task_id": "<task_id>", "status": "queued", "billing": {"cost_usd": "<price>", "balance_usd": "<balance>"}, …}# 2. Poll until "status" is "done"curl -s "https://api.wandy3d.com/task/<task_id>/status" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "done", "model_id": "<model_id>", …}# 3. Get a download link, then download the GLBcurl -s "https://api.wandy3d.com/model/<model_id>/export?format=glb" \  -H "Authorization: Bearer $WANDY3D_API_KEY"# → {"status": "ready", "url": "<download_url>", "filename": "<name>.glb", …}curl -L -o model.glb "<download_url>"
  4. 4. 알아 두면 좋은 점

    결제, 오류, 한도가 어떻게 작동하는지 알아보세요.

    • 모든 응답에 결제 정보 포함
      유료 호출의 응답에는 billing.cost_usd와 billing.balance_usd, 그리고 X-Wandy-Cost-USD / X-Wandy-Balance-USD 헤더가 포함돼요.
    • 오류
      402 insufficient_balance / monthly_limit_reached / key_limit_reached, 429 rate_limited / too_many_jobs. 모든 오류는 코드와 메시지가 담긴 JSON으로 반환돼요.
    • 자동 환불
      실패한 작업은 잔액으로 환불돼요. 받지 못한 모델에는 비용을 내지 않아요.
    • 한도
      키당 분당 60회 요청, 계정당 동시 작업 5개까지 가능해요. 월 한도는 한도 페이지에서 설정하세요.