Seed3D v1

Seed3D v1 API 레퍼런스

단일 이미지 URL에서 GLB 3D 에셋을 생성합니다. 공개 API는 사용자 API 키로 비동기 작업을 만들고 상태와 출력 URL을 반환합니다.

API v1https://seed3d-ai.org/v180 credits

빠른 시작

curl -X POST 'https://seed3d-ai.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "https://example.com/product.png",
    "prompt": "clean topology, neutral studio lighting",
    "subdivision_level": "medium"
  }'

인증

모든 공개 API 요청에는 Authorization 헤더에 사용자 API 키를 보내야 합니다.

대시보드에서 키를 만들거나 복사하세요: API 키

Authorization: Bearer YOUR_ZA_API_KEY

가격

image-to-3D 생성

작업이 승인되면 크레딧이 차감됩니다. Provider 제출 실패는 backend에서 환불됩니다.

80 credits

API 엔드포인트

이미지 URL과 선택 힌트를 제출합니다. 응답은 즉시 task_id를 반환합니다.

`image` required string	공개 HTTP 또는 HTTPS 이미지 URL. JPG, PNG, WebP를 권장합니다.
`prompt` optional string	표면, 재질, 형상, 용도에 대한 선택 힌트. 최대 2000자.
`subdivision_level` optional string	메시 디테일 힌트. low, medium, high 또는 0, 1, 2.default: provider default
`public` optional boolean	하위 기능에서 결과를 공개 콘텐츠로 처리할 수 있는지 여부.default: false
`callback_url` optional string	선택 공개 webhook URL. localhost는 거부됩니다.

요청 예시

{
  "image": "https://example.com/product.png",
  "prompt": "clean topology, neutral studio lighting",
  "subdivision_level": "medium",
  "public": false,
  "callback_url": "https://example.com/webhooks/seed3d"
}

응답

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "IN_PROGRESS",
    "consumed_credits": 80
  }
}

SUCCESS 또는 FAILED까지 폴링합니다. 성공 작업은 response를 출력 URL 배열로 반환합니다.

task_id

required string

POST /v1/generate가 반환한 작업 ID.

요청 예시

curl -X GET 'https://seed3d-ai.org/v1/status?task_id=n105abc123s3d' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

응답

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "SUCCESS",
    "consumed_credits": 80,
    "request": {
      "image": "https://example.com/product.png",
      "prompt": "clean topology, neutral studio lighting",
      "subdivision_level": "medium"
    },
    "response": [
      "https://cdn.example.com/seed3d-output.glb"
    ],
    "error_message": null
  }
}

Authorization 헤더의 API 키로 생성된 최근 작업을 조회합니다.

`page` optional number	페이지 번호.default: 1
`limit` optional number	페이지당 항목 수, backend에서 제한됩니다.default: 20
`task_id` optional string	선택 정확한 작업 ID 필터.

요청 예시

curl -X GET 'https://seed3d-ai.org/v1/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

대시보드 도구

연동 개발 중 대시보드에서 키를 만들고 로그를 확인하세요.

API 키 열기 API 로그 열기

오류 코드

HTTP	이유
400	요청 파라미터가 누락되었거나 올바르지 않습니다.
401	Authorization bearer token이 없거나 유효하지 않습니다.
402	API 키 계정의 크레딧이 부족합니다.
403	요청 API key가 bearer token과 일치하지 않습니다.
404	작업 ID를 찾을 수 없습니다.
405	이 라우트에서 허용되지 않는 HTTP 메서드입니다.
500	서버 또는 provider 오류입니다. 나중에 다시 시도하거나 지원팀에 문의하세요.