Seed3D v1

Seed3D v1 API リファレンス

1つの画像 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 まで polling します。成功時の 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	1ページの件数。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 エラーです。後で再試行するかサポートへ連絡してください。