Hyper3d

ผสานการทำงาน

ID โมเดล hyper3d/rodin/v2

# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hyper3d/rodin/v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/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?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": ""
  }),
});
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.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2", 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/th/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "hyper3d/rodin/v2",
  "input": {
    "prompt": ""
  }
}

เรียกใช้โมเดล Hyper3d (hyper3d/rodin/v2) ผ่าน Doitong API เอกสารสำหรับเอเจนต์: https://doitong.com/th/developers/models/hyper3d/rodin/v2.md

POST https://api.doitong.com/v1/run/hyper3d/rodin/v2?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "prompt": ""
}

หากสถานะการตอบกลับเป็น "queued" หรือ "running" ให้ส่งคำขอแบบสำรวจ GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 จนกว่าจะเป็น "succeeded" ไฟล์อยู่ใน outputs[].url การส่ง POST https://api.doitong.com/v1/quote/hyper3d/rodin/v2 ด้วยบอดี้เดียวกันจะแสดงราคาที่แน่นอนก่อนเรียกใช้

คำขอนี้: $0.40 400 เครดิต API เรียกใช้ในหน้านี้

รับคีย์ API

Hyper3D ภาพเป็น 3D เอาต์พุต 4Kรวดเร็ว #image-to-3d#text-to-3d

Rodin v2 แปลงข้อความหรือภาพเป็น 3D รองรับภาพอินพุตสูงสุด 5 ภาพ พรีเซ็ตเมชแบบสี่เหลี่ยมหรือสามเหลี่ยม และการเรนเดอร์ตัวอย่าง

OpenAPI Markdown

Hyper3D · 3D

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

prompt 0 / 1024

แนะนำการสร้างด้วยพรอมต์ข้อความ หรือเว้นว่างไว้ในโหมด Image-to-3D เพื่อให้ AI สร้างพรอมต์จากรูปภาพของคุณ

ขั้นสูง input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition

input_image_urls

วางไฟล์ หรือ

URL รูปภาพต้นทาง จำกัดไม่เกิน 5 รูปภาพ และจำเป็นต้องใช้ในโหมด Image-to-3D สำหรับสร้างโมเดล

geometry_file_format ค่าเริ่มต้น glb

รูปแบบไฟล์เรขาคณิต เลือกจาก glb, usdz, fbx, obj, stl โดยมีค่าเริ่มต้นเป็น glb

material ค่าเริ่มต้น All

การเลือกวัสดุ โดย All จะรวมทั้งสองตัวเลือก: PBR ใช้วิธีอิงฟิสิกส์เพื่อสร้างแสงที่สมจริง ส่วน Shaded ใช้วัสดุแบบง่ายและแสงที่อบไว้

quality_mesh_option ค่าเริ่มต้น 500K Triangle

ตัวเลือกเมชและคุณภาพรวมกัน ซึ่งแมปใน Hyper3D API ไปยัง `quality_override` โดยใช้ส่วนตัวเลขของตัวเลือก และไปยัง `mesh_mode` โดยใช้ 'Raw' หากตัวเลือกมี 'Triangle' หรือใช้ 'Quad' ในกรณีอื่น Quad เหมาะกับพื้นผิวเรียบ ส่วน Triangle เหมาะกับเรขาคณิตที่มีรายละเอียด

addons

HighPack จัดเตรียมโมเดลโพลิกอนสูง และเพิ่มความละเอียดพื้นผิวจากค่าเริ่มต้น 1K เป็น 4K

seed

ค่า seed แบบสุ่มที่ไม่บังคับ โดยมีช่วงตั้งแต่ 0–65535

bbox_condition

ขนาดกรอบขอบเขตที่แสดงเป็นอาร์เรย์ตามลำดับ [width, height, length]

POST /run/hyper3d/rodin/v2?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.com/v1/run/hyper3d/rodin/v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

const API = "https://api.doitong.com/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?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": ""
  }),
});
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.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2", 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",
      "input": {
        "prompt": ""
      },
      "wait_seconds": 20
    }
  }
}

เรียกใช้คำขอนี้

คีย์ API

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง Doitong API เท่านั้น และจะบันทึกใน localStorage ก็ต่อเมื่อคุณเลือกจดจำ จดจำในเบราว์เซอร์นี้ รับคีย์ API

เกี่ยวกับ Hyper3d

สร้างโมเดล 3D จากพรอมต์ (สูงสุด 1024 อักขระ) และภาพสูงสุด 5 ภาพใน `input_image_urls` `quality_mesh_option` มีเมชสี่เหลี่ยมตั้งแต่ 4K ถึง 50K และเมชสามเหลี่ยมตั้งแต่ 2K ถึง 500K รองรับ `material` แบบ PBR, Shaded หรือ All, `TAPose`, `use_original_alpha` และ `preview_render`

พารามิเตอร์

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย

promptไม่บังคับ

ประเภทstring

ค่าเริ่มต้น

≤ 1,024 อักขระ

input_image_urlsไม่บังคับ

ประเภทurl[] · image

use_original_alphaไม่บังคับ

ประเภทboolean

ค่าเริ่มต้นfalse

ควบคุมการคงช่องความโปร่งใสของรูปภาพอินพุตไว้เมื่อสร้างเนื้อหา 3D

seedไม่บังคับ

ประเภทinteger | null

0 – 65,535

ค่า seed แบบสุ่มที่ไม่บังคับ โดยมีช่วงตั้งแต่ 0–65535

geometry_file_formatไม่บังคับ

ประเภทenum

ค่าเริ่มต้นglb

glbusdzfbxobjstl

รูปแบบไฟล์เรขาคณิต เลือกจาก glb, usdz, fbx, obj, stl โดยมีค่าเริ่มต้นเป็น glb

materialไม่บังคับ

ประเภทenum

ค่าเริ่มต้นAll

PBRShadedAll

quality_mesh_optionไม่บังคับ

ประเภทenum

ค่าเริ่มต้น500K Triangle

4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle

TAPoseไม่บังคับ

ประเภทboolean

ค่าเริ่มต้นfalse

การตั้งค่าท่าทางตัวละครเพื่อให้การทำริกและแอนิเมชันในซอฟต์แวร์ 3D ง่ายขึ้น การเปิดใช้จะสร้างตัวละครในท่า T-pose หรือ A-pose

bbox_conditionไม่บังคับ

ประเภทinteger[]

ขนาดกรอบขอบเขตที่แสดงเป็นอาร์เรย์ตามลำดับ [width, height, length]

addonsไม่บังคับ

ประเภทstring | null

preview_renderไม่บังคับ

ประเภทboolean

ค่าเริ่มต้นfalse

สวิตช์เปิดใช้การเรนเดอร์ตัวอย่าง ซึ่งเพิ่มรูปภาพที่แสดงโมเดล 3D ที่สร้างลงในไฟล์โมเดลที่ส่งกลับ

จำเป็น

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t

{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2",
  "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}

ไฟล์ของคุณ คุณเลือกเองทุก outputs[].url คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=

รูปแบบเดียวกันในทุกโมเดล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}ไฟล์วัตถุ 3D เพิ่มเติมที่สร้างโดย Hyper3D และส่งกลับนอกเหนือจาก model_mesh
seed: integerSeed ที่ใช้ระหว่างการสร้าง
textures: array of object {url, content_type, file_name, file_size, width, height}พื้นผิวที่สร้างสำหรับวัตถุ 3D

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/hyper3d/rodin/v2.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอ

เรียกใช้คำขอนี้

เกี่ยวกับ Hyper3d

พารามิเตอร์

เอาต์พุต

โมเดลเพิ่มเติม: ภาพเป็น 3D

Hyper3D - Rodin V2.5 - Image to 3D รูปแบบ: 4

Hyper3D - Rodin V2.5 - Image to 3D - Fast รูปแบบ: 4

Hyper3D Rodin

Hi3D Image to 3D รูปแบบ: 6