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

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"

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

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

แปลงข้อความเป็น 3D ด้วย Rodin V2.5 ครบทั้งหกระดับ จากพรอมต์ความยาวสูงสุด 1024 อักขระ

Hyper3D · 3D

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

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

สร้างคำขอ

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

•จำเป็น 88 / 1024

คำสั่งข้อความที่ใช้กำกับการสร้างโมเดล จำเป็นต้องใช้ในโหมด Text-to-3D

ขั้นสูง geometry_file_format · material · texture_mode · tier · quality_mesh_option · seed · enable_creative_mode · hd_texture · texture_delight · is_micro · TAPose · enable_safety_checker · bbox_condition · addons
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/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"

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

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

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

สร้างโมเดล 3D จาก `prompt` ที่จำเป็นและมีความยาวสูงสุด 1024 อักขระ เลือก `tier` ตั้งแต่ Gen-2.5-Minimum ถึง Gen-2.5-Extreme-High (ค่าเริ่มต้น High) ขนาดเมชแบบสี่เหลี่ยมหรือสามเหลี่ยม และ `material` เช่น PBR หรือ Shaded ส่งออกเป็น 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 โดยอัตโนมัติและบังคับใช้ 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)
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
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 คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ 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/text-to-3d.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt