コンテンツへスキップ

Hyper3D - Rodin V2.5 - Image to 3D

統合

モデルID hyper3d/rodin/v2.5
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエスト: $0.40 400 APIクレジット · ≈ ₽42.19 このページで実行

APIキーを取得
Hyper3D 画像から3D 4K出力高速 #image-to-3d

最大5枚の参照画像と品質段階を選択できるRodin V2.5の画像から3Dへの変換

Hyper3D · 3D

最初の結果がここに表示されます

以下でリクエストを作成し、APIキーで実行してください。出力はストレージにコピーされ、永久保存または無料で7日保存されます。

リクエストを作成

コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。

0 / 1024

テキストで生成をガイドします。または Image-to-3D モードで空欄にすると、モデルが画像からプロンプトを自動生成します。

詳細設定 images · geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · use_original_alpha · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · preview_render · enable_safety_checker · bbox_condition · addons
image_urls
ファイルをドロップ、または · 5まで

ソース画像 URL。最大 5 枚で、モデル生成のため Image-to-3D モードでは必須です。

geometry_file_format デフォルト glb

ジオメトリのファイル形式。glb、usdz、fbx、obj、stl から選択します。デフォルトは glb です。

material デフォルト All

マテリアル出力の選択。テクスチャなしのジオメトリには None、両方のマテリアル形式を受け取るには All を選択します。物理ベースのマテリアルによる現実的なライティングには PBR、PBR マップなしのベイク済みライティングには Shaded を選択します。

texture_mode

テクスチャ品質を明示的に選択するか、ティアに適したデフォルトを使用する API に任せます。

デフォルト Gen-2.5-High

メッシュ詳細度のティア。ティアを上げると詳細が増えますが、Gen-2.5-Minimum は自動的に minimum モードを有効にし、quality_mesh_option に関係なく 50K Triangle を強制します。詳細は [ドキュメント](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) を参照してください。

デフォルト Auto

メッシュトポロジーと品質。利用可能な面数はティアで決まり、Extreme-Low、Low、Medium は最大 1M Triangle、High と Extreme-High は 20K Triangle~2M Triangle に対応します。Auto の推奨設定は次のとおりです: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle。手動選択では、Quad は滑らかな表面、Triangle は詳細なジオメトリを優先します。Hyper3D API にはトポロジーを `mesh_mode` (Quad/Raw)、面数を `quality_override` として渡します。

任意のランダム化シード。範囲は 0~65535 です。

ControlNet を使用して、生成モデルの大きさを制限します。

任意のアドオン選択。リスト、または 1 つだけの場合は単一の値で指定します。

POST /run/hyper3d/rodin/v2.5?wait=20 見積もり → $0.40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": ""
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

このリクエストを実行

キーはこのブラウザ内に保持されます。Doitong APIにのみ送信され、「記憶する」にチェックを入れた場合のみlocalStorageに保存されます。 APIキーを取得

Hyper3D - Rodin V2.5 - Image to 3Dについて

`image_urls`の1〜5枚の画像から3Dモデルを生成し、任意で最大1024文字の`prompt`を指定できます。6つの段階はGen-2.5-MinimumからGen-2.5-Extreme-Highまでで、デフォルトはHighです。ジオメトリ形式(glb、usdz、fbx、obj、stl)、`material`、四角形または三角形メッシュサイズ、リグ対応キャラクター向けの`TAPose`、`hd_texture`を指定できます。

パラメータ

正式名称またはネイティブ名のいずれか一方を送信してください。両方は送信しないでください。 正式名称

名前型 デフォルト許可される値 説明
prompt任意
型string
デフォルト
≤ 1,024文字
テキストで生成をガイドします。または Image-to-3D モードで空欄にすると、モデルが画像からプロンプトを自動生成します。
image_urls任意 images
型url[] · image
≤ 5項目
ソース画像 URL。最大 5 枚で、モデル生成のため Image-to-3D モードでは必須です。
tier任意
型enum
デフォルトGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
メッシュ詳細度のティア。ティアを上げると詳細が増えますが、Gen-2.5-Minimum は自動的に minimum モードを有効にし、quality_mesh_option に関係なく 50K Triangle を強制します。詳細は [ドキュメント](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) を参照してください。
use_original_alpha任意
型boolean
デフォルトfalse
3D コンテンツ生成時に入力画像の透明度チャンネルを保持するかどうかを制御します。
seed任意
型integer | null
0 – 65,535
任意のランダム化シード。範囲は 0~65535 です。
geometry_file_format任意
型enum
デフォルトglb
glbusdzfbxobjstl
ジオメトリのファイル形式。glb、usdz、fbx、obj、stl から選択します。デフォルトは glb です。
material任意
型enum
デフォルトAll
PBRShadedAllNone
マテリアル出力の選択。テクスチャなしのジオメトリには None、両方のマテリアル形式を受け取るには All を選択します。物理ベースのマテリアルによる現実的なライティングには PBR、PBR マップなしのベイク済みライティングには Shaded を選択します。
quality_mesh_option任意
型enum
デフォルトAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
メッシュトポロジーと品質。利用可能な面数はティアで決まり、Extreme-Low、Low、Medium は最大 1M Triangle、High と Extreme-High は 20K Triangle~2M Triangle に対応します。Auto の推奨設定は次のとおりです: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle。手動選択では、Quad は滑らかな表面、Triangle は詳細なジオメトリを優先します。Hyper3D API にはトポロジーを `mesh_mode` (Quad/Raw)、面数を `quality_override` として渡します。
texture_mode任意
型enum
legacyextreme-lowlowmediumhigh
テクスチャ品質を明示的に選択するか、ティアに適したデフォルトを使用する API に任せます。
enable_creative_mode任意
型boolean
デフォルトfalse
クリエイティブ生成モード。Hyper3D API の `geometry_instruct_mode` を `creative` に設定する場合と同等です。有効にすると出力の一貫性を損なわず、生成の堅牢性が向上します。
hd_texture任意
型boolean
デフォルトfalse
視覚的な忠実度を向上させる詳細設定のテクスチャ後処理を制御します。
texture_delight任意
型boolean
デフォルトfalse
生成されたテクスチャから焼き込み済みの照明とハイライトを除去します。
is_micro任意
型boolean
デフォルトfalse
マイクロスケールでより細かなジオメトリのディテールを追加します。`tier="Gen-2.5-Extreme-High"` の場合のみ有効です。
TAPose任意
型boolean
デフォルトfalse
3D ソフトウェアでのリギングとアニメーションを容易にするキャラクターポーズ設定。有効にすると、キャラクターを T-pose または A-pose で生成します。
bbox_condition任意
型object
ControlNet を使用して、生成モデルの大きさを制限します。
bbox_condition.width任意
型integer
デフォルト0
1 – 2,048
X 軸方向のバウンディングボックス制約の幅です。
bbox_condition.height任意
型integer
デフォルト0
1 – 2,048
Y 軸方向のバウンディングボックス制約の高さです。
bbox_condition.length任意
型integer
デフォルト0
1 – 2,048
Z 軸方向のバウンディングボックス制約の長さです。
addons任意
型object
任意のアドオン選択。リスト、または 1 つだけの場合は単一の値で指定します。
addons.high_pack任意
型boolean
デフォルトfalse
HighPack 拡張。Quad 出力の面数は quality パラメータで指定した数のおよそ 16 倍になり、テクスチャはデフォルトの 2K ではなく 4K 解像度を使用します。
preview_render任意
型boolean
デフォルトfalse
生成された 3D モデルを示す画像を納品モデルファイルに追加するプレビュー描画の切り替えです。
enable_safety_checker任意
型boolean
デフォルトtrue
呼び出し元に権限がある場合、false に設定するとスクリーニングを緩和できます。
必須 正式名称(こちらも使用可能)

ファイルパラメータには、公開されたhttps:// URL、10 MBまでのdata: URI、またはアップロードしたファイルのfile_urlを指定します。 ファイル

出力

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": ""
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_meshes": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    ],
    "seed": 42,
    "textures": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ファイルの保存期間を選択すべてのoutputs[].urlはストレージ上のコピーです。アカウント設定または?storage=により、永久保存(GB・月単位で有料)または無料で7日保存できます。
すべてのモデルで同じ形式画像、動画、音声のいずれでも、type、url、content_type、width、height、durationが含まれます。outputはモデル独自の結果オブジェクトです。
出力フィールド
model_mesh
object {url, content_type, file_name, file_size}生成された 3D オブジェクトを含むファイルです。
model_meshes
array of object {url, content_type, file_name, file_size}Hyper3D が生成し、model_mesh に加えて返す追加の 3D オブジェクトファイルです。
seed
integer生成時に適用するシード。
textures
array of object {url, content_type, file_name, file_size, width, height}3D オブジェクト用に生成されたテクスチャです。

その他のモデル: 画像から3D

AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/hyper3d/rodin/v2.5.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt