混元大モデルに基づき、入力されたテキストの記述/画像に応じて3Dモデルをインテリジェント生成します。デフォルトでコンカレント数3を提供、これは同時に処理可能な提出済みタスクの最大数が3つであることを意味;前のタスクの処理が完了した後、初めて次のタスクの処理を開始できます。
インターフェースを呼び出す際、異なるパラメーターの組み合わせは対応する課金基準となり、デフォルトモードはテキスト/画像から3D生成+標準テクスチャモードで、1回の実行に0.4 PTCを消費します。
✅ 生成に失敗したタスクはいかなる費用も発生しません(コンテンツリスクコントロールポリシーによる失敗を含み、あらゆる失敗原因に適用)。生成タスクの種別
GenerateTypeは必須パラメーターで、デフォルト値はNormal;4種類の生成モードから1種類を選択可能で、費用は対応する種別に基づき発生します。| 生成タスクの種別 | 機能の説明 | 消費費用 |
|---|
| Normal | テクスチャ付きジオメトリックモデルの生成 | 0.4 PTC/回 |
| LowPoly | インテリジェントポリゴン削減後のテクスチャ付きジオメトリックモデルの生成 | 0.5 PTC/回 |
| Geometry | テクスチャなしジオメトリックモデル(白紙モデル)の生成 | 0.3 PTC/回 |
| Sketch | スケッチ/線画の入力によるテクスチャ付きジオメトリックモデルの生成 | 0.5 PTC/回 |
追加パラメーター
生成タスクの種別を選択後に追加で使用可能で、パラメーターは複数選択に対応、費用は追加項目に基づき累計して発生します。| 追加パラメーター名 | 機能の説明 | 追加消費費用 |
|---|
| MultiViewImages | マルチビューによる3Dモデルの生成 | 0.2 PTC/回 |
| EnablePBR | PBRマテリアル付き3Dモデルの生成、メタリック、ラフネス、ノーマルマップを含む | 0.2 PTC/回 |
| FaceCount | カスタム面数の3Dモデルの生成 | 0.2 PTC/回 |
| ResultFormat | 生成モデル形式のカスタマイズ | 0.1 PTC/回 |
1.
三者一択の必須項目:ImageBase64、ImageUrl、Promptのいずれかは必須で、かつPromptはSketchモードを除き、ImageBase64/ImageUrlと同時に使用できません;
2.
バージョン制 限:3.1バージョンはLowPolyパラメーターに対応しておらず、トップ/ボトム/斜めフロントビューは3.1バージョンのみ対応;
3.
パラメーターの有効性:GeometryモードではEnablePBRパラメーターは無効、PolygonTypeはLowPolyモードでのみ有効。
Request
Body Params application/json
Request Code Samples
curl --location --request POST 'https://api.302.ai/tencent/hunyuan3d/pro-job' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
"Prompt": "一只小猫"
}'
Responses
application/json {
"Response": {
"JobId": "1407969018996203520",
"RequestId": "98ea38ef-48b6-4a45-ab04-9dab730d4994"
}
}
Modified at 2026-01-29 03:52:02