Wandy3D

Wandy3D API

コード、ゲームエンジン、AI エージェントから 3D モデルを生成

写真、複数の視点、または一文を送るだけで、テクスチャ付きの 3D モデルが返ってきます。エクスポート、3D プリント、クアッドリメッシュ、自動リギング、ゲームエンジン向けパックにも対応。スタジオと同じパイプラインを、シンプルな HTTPS で。

API キーを取得エンドポイント一覧
  • 前払い残高から呼び出しごとに支払い
  • Bearer キー認証
  • キーごとに毎分 60 リクエスト
  • HTTPS 上の REST と JSON
# 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>"}, …}

クイックスタート

写真から GLB ファイルまで 4 ステップ。

  1. 1

    キーを作成

    API プラットフォームの「API キー」で作成し、API 残高をチャージします。キーは一度しか表示されません。WANDY3D_API_KEY などの環境変数に保管してください。

  2. 2

    生成を開始

    POST/generate/cloud/ultra

    写真 1 枚を multipart フィールド file で送信します。レスポンスに task_id が含まれます。

  3. 3

    タスクをポーリング

    GET/task/{task_id}/status

    数秒ごとに、status が done になるまで確認します。完了すると model_id が返ります。

  4. 4

    ダウンロード

    GET/model/{model_id}/export?format=glb

    GLB はすぐに期限付きリンクが返ります。ほかの形式は変換が必要なので、準備ができるまで同じ URL をポーリングしてください。

# 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>"

キーと制限

すべてのリクエストで、Authorization ヘッダーにキーを入れて送ります。

Authorization: Bearer hg_live_…

キーは秘密に

キーはあなたとして動作し、API 残高を消費します。サーバー、スクリプト、CI から使い、Web ページやモバイルアプリには入れないでください。漏えいしたキーは API プラットフォームで無効化すると、すぐに使えなくなります。

レート制限

キーごとに毎分 60 リクエスト。超えると 429 が返り、retry_after に待つべき秒数が入ります。

キーは最大 10 個

アプリやマシンごとに 1 つずつ使えば、ほかに影響を与えずに 1 つだけ無効化できます。

エラー

エラーは JSON で返り、多くは detail.error に安定したコードを含みます:

{"detail": {"error": "rate_limited", "retry_after": <seconds>, "message": "…"}}
ステータスdetail.error意味
401invalid_api_keyキーがない、間違っている、または無効化されています。
402insufficient_balancemonthly_limit_reachedkey_limit_reachedAPI 残高が足りないか、月間上限（アカウントまたはキー）に達しました。
403subscription_requiredsession_requiredWeb サイトへのサインイン、または Web サイトで作ったモデルをダウンロードするためのプランが必要です。
404feature_off見つからないか、まだ利用できません。
409file_not_readyモデルファイルの準備がまだできていません。
429rate_limitedtoo_many_jobsレート制限に達したか、同時に実行中の生成が多すぎます。

料金

有料の呼び出しはすべて、前払い API 残高から米ドルで請求されます。カードで $5 からチャージでき、残高に有効期限はなく、失敗したジョブは自動で返金されます。

API で生成したモデルはあなたのものです。すべての形式で無料でダウンロードできます。

API 料金を見る

エンドポイント

公開 API をひとつの表にまとめました。どのルートも同じ Bearer キーで呼び出せます。

OpenAPI ドキュメント ↗

生成

メソッドパス内容
POST/generate/cloud/ultra
写真 1 枚からモデル、Wandy 2有料
POST/generate/cloud
写真 1 枚からモデルを生成（Wandy 1.1）有料
POST/generate/cloud/fast
写真 1 枚からモデルを生成（Wandy 1）有料
POST/generate/cloud/multi/ultra
2〜4 ビューからモデル、Wandy 2有料
POST/generate/cloud/multi
同じオブジェクトの 2〜4 視点から生成（Wandy 1.1）有料
POST/generate/cloud/multi/fast
2〜4 視点から生成（Wandy 1）有料
POST/generate/text/imagine
テキスト → コンセプト画像有料
POST/generate/text
コンセプト画像 → 3D モデル有料
POST/generate/retexture
写真からモデルに新しいテクスチャ有料

タスク

メソッドパス内容
GET/task/{task_id}/status
生成の進捗

ライブラリ

メソッドパス内容
GET/library
あなたのモデル（新しい順）
GET/model/{model_id}
モデル 1 件と GLB リンク

ダウンロードと後処理

メソッドパス内容
GET/model/{model_id}/export
GLB・FBX・OBJ・USDZ・STL・Draco GLB でダウンロードダウンロード
GET/model/{model_id}/print
3D プリント用 STL / 3MFダウンロード
GET/model/{model_id}/retopo
テクスチャ焼き込み付きクアッドリメッシュ有料ダウンロード
GET/model/{model_id}/rig
アニメーション付き自動リギング有料
GET/model/{model_id}/parts
モデルをパーツに分割有料
GET/model/{model_id}/gamepack
LOD とコライダー付きのゲーム用パック有料ダウンロード
GET/model/{model_id}/make/{kind}
クラフト（ペーパークラフトなど）有料

アカウント

メソッドパス内容
GET/api/platform/balance
API 残高
GET/api/platform/prices
最新の料金一覧

最初の API 呼び出しを

API プラットフォームでキーを作成してチャージしましょう。1 分で完了します。

API キーを取得