ข้ามไปยังเนื้อหา

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

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

รับคีย์ API
Hyper3D ภาพเป็น 3D เอาต์พุต 4Kรวดเร็ว #image-to-3d

แปลงภาพเป็น 3D ด้วย Rodin V2.5 โดยใช้ภาพอ้างอิงสูงสุด 5 ภาพและเลือกระดับคุณภาพได้

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 เลือก โดย API จะใช้ค่าเริ่มต้นที่เหมาะกับระดับนั้น

ค่าเริ่มต้น Gen-2.5-High

ระดับรายละเอียดของเมช การเพิ่มระดับจะเพิ่มรายละเอียด แต่ Gen-2.5-Minimum จะเปิดใช้โหมด minimum โดยอัตโนมัติและบังคับใช้ 50K Triangle โดยไม่คำนึงถึง quality_mesh_option ดูรายละเอียดเพิ่มเติมใน [เอกสาร](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`

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

จำกัดขนาดสูงสุดของโมเดลที่สร้างโดยใช้ ControlNet

การเลือกส่วนเสริมที่ไม่บังคับ ส่งเป็นรายการ หรือส่งเป็นค่าเดียวเมื่อมีส่วนเสริมเพียงรายการเดียว

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

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

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

เกี่ยวกับ Hyper3D - Rodin V2.5 - Image to 3D

สร้างโมเดล 3D จากรูปภาพหนึ่งถึงห้ารายการใน `image_urls` พร้อม `prompt` ที่เป็นตัวเลือกและยาวได้สูงสุด 1024 อักขระ มีหกระดับตั้งแต่ 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 โดยอัตโนมัติและบังคับใช้ 50K Triangle โดยไม่คำนึงถึง quality_mesh_option ดูรายละเอียดเพิ่มเติมใน [เอกสาร](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
ค่า seed แบบสุ่มที่ไม่บังคับ โดยมีช่วงตั้งแต่ 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 เลือก โดย API จะใช้ค่าเริ่มต้นที่เหมาะกับระดับนั้น
enable_creative_modeไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
โหมดการสร้างเชิงสร้างสรรค์ เทียบเท่ากับการตั้งค่า `geometry_instruct_mode` เป็น `creative` ใน Hyper3D API การเปิดใช้ช่วยให้การสร้างมีความเสถียรมากขึ้นโดยไม่ลดความสอดคล้องของเอาต์พุต
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 มีจำนวนหน้าประมาณ 16 เท่าของจำนวนที่ร้องขอผ่านพารามิเตอร์คุณภาพ และพื้นผิวใช้ความละเอียด 4K แทนค่าเริ่มต้น 2K
preview_renderไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
สวิตช์เปิดใช้การเรนเดอร์ตัวอย่าง ซึ่งเพิ่มรูปภาพที่แสดงโมเดล 3D ที่สร้างลงในไฟล์โมเดลที่ส่งกลับ
enable_safety_checkerไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
สามารถผ่อนปรนการคัดกรองได้โดยตั้งค่าเป็น false หากผู้เรียกมีสิทธิ์
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ 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.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

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

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