Hyper3D - Rodin V2.5 - Text to 3D
統合
モデルID
hyper3d/rodin/v2.5/text-to-3d
# 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/text-to-3d?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# 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"
const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hyper3d/rodin/v2.5/text-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2.5/text-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/ja/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.ru/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "hyper3d/rodin/v2.5/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}
Doitong APIを通じてHyper3D - Rodin V2.5 - Text to 3Dモデル(hyper3d/rodin/v2.5/text-to-3d)を呼び出します。エージェント向けドキュメント: https://doitong.com/ja/developers/models/hyper3d/rodin/v2.5/text-to-3d.md
POST https://api.doitong.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
レスポンスのステータスが"queued"または"running"の場合、"succeeded"になるまでGET https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20をポーリングしてください。ファイルはoutputs[].urlにあります。同じボディでPOST https://api.doitong.ru/v1/quote/hyper3d/rodin/v2.5/text-to-3dを実行すると、実行前の正確な価格が返されます。
このリクエスト: $0.40 400 APIクレジット · ≈ ₽43.03 このページで実行
新しいAPIキーです。 これは今だけ表示され、コードと下記のAPIキー欄にすでに入力されています。秘密にしてください。ブラウザで実行されるコードに決して含めないでください。
Hyper3D · 3D
最初の結果がここに表示されます
以下でリクエストを作成し、APIキーで実行してください。出力はストレージにコピーされ、永久保存または無料で7日保存されます。
リクエストを作成
コントロールはモデルスキーマから生成されます。値を変更するとコードと価格が更新されます。
POST
/run/hyper3d/rodin/v2.5/text-to-3d?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/text-to-3d?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# 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"
const API = "https://api.doitong.ru/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hyper3d/rodin/v2.5/text-to-3d?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2.5/text-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "hyper3d/rodin/v2.5/text-to-3d",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}
Hyper3D - Rodin V2.5 - Text to 3Dについて
最大1024文字の必須`prompt`から3Dモデルを生成します。Gen-2.5-Minimum〜Gen-2.5-Extreme-High(デフォルトHigh)の`tier`、四角形または三角形のメッシュサイズ、PBRやShadedなどの`material`を選択できます。glb、usdz、fbx、obj、stlでエクスポートし、`seed`は0〜65535に設定できます。
パラメータ
名前型
デフォルト許可される値
説明
prompt必須
型string
≤ 1,024文字
モデル生成を導くテキスト指示。Text-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) を参照してください。
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
必要に応じて適用する追加オプションです。
addons.high_pack任意
型boolean
デフォルトfalse
HighPack 拡張。Quad 出力の面数は quality パラメータで指定した数のおよそ 16 倍になり、テクスチャはデフォルトの 2K ではなく 4K 解像度を使用します。
enable_safety_checker任意
型boolean
デフォルトtrue
呼び出し元に権限がある場合、false に設定するとスクリーニングを緩和できます。
必須
出力
GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "hyper3d/rodin/v2.5/text-to-3d",
"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": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"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 オブジェクト用に生成されたテクスチャです。
その他のHyper3D - Rodin V2.5バリアント
その他のモデル: テキストから3D
AIエージェント向け:このページのMarkdown版はこちらです: https://doitong.com/ja/developers/models/hyper3d/rodin/v2.5/text-to-3d.md. すべてのモデルとガイド: https://doitong.com/developers/llms.txt