01
hunyuan-3d/v3.1/pro/image-to-3d
正面画像から 3D アセットを生成し、PBR、ジオメトリ、面数、追加ビューを利用できます。
Examples
価格詳細
透明な価格設定。隠れた費用はありません。使った分だけ支払えます。
hunyuan-3d/v3.1/pro/text-to-3dBase generation
PoYo価格
$0.300/生成
60 クレジット
公式価格
$0.375/生成
Official
節約率
20%
hunyuan-3d/v3.1/pro/image-to-3dBase generation
PoYo価格
$0.300/生成
60 クレジット
公式価格
$0.375/生成
Official
節約率
20%
hunyuan-3d/v3.1/rapid/text-to-3dBase generation
PoYo価格
$0.180/生成
36 クレジット
公式価格
$0.225/生成
Official
節約率
20%
hunyuan-3d/v3.1/rapid/image-to-3dBase generation
PoYo価格
$0.180/生成
36 クレジット
公式価格
$0.225/生成
Official
節約率
20%
hunyuan-3d/v3.1/pro/image-to-3dPBR add-on
PoYo価格
$0.120
24 クレジット
公式価格
$0.150
Official
節約率
20%
hunyuan-3d/v3.1/pro/image-to-3dMulti-view add-on
PoYo価格
$0.120
24 クレジット
公式価格
$0.150
Official
節約率
20%
hunyuan-3d/v3.1/pro/text-to-3dCustom face count add-on
PoYo価格
$0.120
24 クレジット
公式価格
$0.150
Official
節約率
20%
| モデル | 仕様 | PoYo価格 | 公式価格 | 節約率 |
|---|---|---|---|---|
| hunyuan-3d/v3.1/pro/text-to-3d | Base generation | $0.300/生成 60 クレジット /生成 | $0.375/生成 Official | 20% |
Custom face count add-on | $0.120 24 クレジット additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/pro/image-to-3d | Base generation | $0.300/生成 60 クレジット /生成 | $0.375/生成 Official | 20% |
PBR add-on | $0.120 24 クレジット additional | $0.150 Official | 20% | |
Multi-view add-on | $0.120 24 クレジット additional | $0.150 Official | 20% | |
| hunyuan-3d/v3.1/rapid/text-to-3d | Base generation | $0.180/生成 36 クレジット /生成 | $0.225/生成 Official | 20% |
| hunyuan-3d/v3.1/rapid/image-to-3d | Base generation | $0.180/生成 36 クレジット /生成 | $0.225/生成 Official | 20% |
* 実際の料金は最終出力に基づきます。
紹介
Hunyuan 3D v3.1 API を使用するための完全なガイド
Hunyuan 3D v3.1 API
PoYo.ai では 4 つの Hunyuan 3D v3.1 モデルを利用でき、タスク送信、ステータス確認、コールバック、3D ファイル取得を同じ流れで扱えます。
Hunyuan 3D v3.1 API の主な機能
PoYo で公開されている制御項目を使い、Pro または Rapid の text-to-3D / image-to-3D を選択できます。
01
Pro image-to-3D と複数ビュー参照
正面の物体画像をアップロードし、必要に応じて側面、背面、上面、下面、斜め方向の参照画像を追加できます。Pro image-to-3D では PBR、ジオメトリモード、面数指定も利用できます。
- 正面画像は PoYo image_urls で送信
- Pro image-to-3D は任意の複数ビュー項目に対応
- 必要に応じて PBR と面数を指定
02
Pro text-to-3D は詳細なプロンプト向け
形状、素材方向、アセットのコンセプトを文章で指定したい場合に Pro text-to-3D を使います。PoYo はステータス確認とコールバックに同じ非同期 API 手順を使います。
- 長めのプロンプトに対応
- PBR、ジオメトリ、面数を任意指定
- ステータスとファイル取得を統一
03
Rapid text-to-3D は素早い草案向け
Rapid text-to-3D は初期アイデア、物体探索、低コストの草案生成に向いています。短いプロンプトで複数方向をすばやく比較できます。
- Pro より低い基本コスト
- ジオメトリ未選択時に PBR を利用可能
- アセット探索と反復に適合
04
Rapid image-to-3D は単一参照から生成
製品、プロップ、スケッチ、物体の参照画像がある場合、Rapid image-to-3D で素早く 3D 結果を得られます。
- 1 枚の画像を入力
- 対応範囲で PBR またはジオメトリを利用
- サムネイルとモデルファイルを返却
利用シーン
01
ゲーム用プロップの構想
手作業モデリング前に、プロンプトや物体参照から初期コンセプトを生成します。
02
製品・物体の可視化
正面画像や複数ビュー参照を、確認可能でダウンロードできる 3D 出力へ変換します。
03
3D アセットの比較探索
同じ API 形式で Pro と Rapid の結果、ステータス、ファイル取得を比較できます。
04
非同期 3D パイプライン
コールバックまたはポーリングで Hunyuan 3D タスクを送信し、完了ファイルを制作ツールへ渡します。
Hunyuan 3D v3.1 Pro と Rapid の比較
PoYo で利用できる 4 つの Hunyuan 3D v3.1 モデルの比較です。
| 機能 | Pro | Rapid |
|---|---|---|
| 入力モデル | Text-to-3D と image-to-3D | Text-to-3D と image-to-3D |
| 最適な用途 | PBR、ジオメトリ、面数、複数ビューが必要な高制御タスク | プロンプトまたは 1 枚画像からの低コスト草案 |
| プロンプト長 | 最大 1024 文字 | 最大 200 文字 |
| 画像制御 | 正面画像と Pro image の追加ビュー URL | 単一の正面画像 |
| 料金パターン | 基本生成に任意オプションを追加 | 基本生成に任意の PBR オプションを追加 |
実際の出力は選択モデルと返却ファイルによって異なります。
PoYo で Hunyuan 3D v3.1 API を使う方法
ステップ 1: API キーを作成
PoYo に登録し、ダッシュボードで API キーを作成します。
API キーを作成 ->
ステップ 2: Hunyuan 3D v3.1 モデルを選択
Pro image、Pro text、Rapid text、Rapid image のいずれかを選択します。
ステップ 3: PoYo 入力を送信
テキストモデルでは prompt、画像モデルでは image_urls を使います。PBR、ジオメトリ、面数、複数ビューは対応モデルでのみ追加します。
ステップ 4: 生成アセットを取得
ステータスをポーリングするか callback URL を指定し、完了後に GLB、OBJ、MTL、テクスチャ、サムネイル、モデル URL を取得します。
ドキュメントを見る ->
Hunyuan 3D v3.1 API の料金
PoYo の Hunyuan 3D v3.1 は生成ごとの料金で、任意機能に追加料金が発生します。
Pro と Rapid では基本価格が異なります。PBR、複数ビュー入力、カスタム面数などは、対応モデルで有効化した場合に追加で計算されます。
クレジットを追加して Hunyuan 3D v3.1 をテストできます。 クレジットを追加 ->
FAQ
どの Hunyuan 3D v3.1 モデルを選ぶべきですか？
PBR、ジオメトリ、面数、複数ビューが必要な場合は Pro、低コストの素早い草案には Rapid を選びます。
PoYo の画像入力はどう使いますか？
画像モデルでは image_urls に正面画像 URL を 1 つ入れます。Hunyuan 3D の画像モデル間で同じ入力形式です。
複数ビュー画像は使えますか？
はい。ただし hunyuan-3d/v3.1/pro/image-to-3d のみです。背面、左、右、上、下、左前、右前の画像 URL を指定できます。
API はどのファイルを返しますか？
モデルにより GLB、OBJ、MTL、テクスチャ、サムネイル、モデル URL 一覧が含まれます。
PoYo.ai を使う理由
01
1 つの非同期 3D API
4 つの Hunyuan 3D v3.1 モデルで同じ送信、ステータス、コールバック、ファイル取得を使えます。
02
透明なクレジット料金
送信前に基本生成と追加オプションの見積もりを確認できます。
03
モデル別の制御項目
Playground は選択中の Pro または Rapid モデルが対応する項目だけを表示します。
04
統一された出力ファイル
PoYo はモデル、テクスチャ、サムネイルを一貫したタスク結果として整理します。