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

Hyper3D Rodin

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

ID โมเดล hyper3d/rodin
# 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?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 รวดเร็ว #stylized

การสร้าง 3D ด้วย Rodin จากข้อความหรือภาพ พร้อมวัสดุ PBR หรือแบบมีเงาและระดับคุณภาพหลายระดับ

Hyper3D · 3D

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

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

สร้างคำขอ

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

0 / 1024

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

ขั้นสูง input_image_urls · condition_mode · geometry_file_format · material · quality · tier · addons · seed · use_hyper · TAPose · bbox_condition
วางไฟล์ หรือ

URL รูปภาพต้นทาง ซึ่ง Image-to-3D จำเป็นต้องใช้ และ Text-to-3D อาจใช้เพื่อสร้างโมเดลได้

condition_mode ค่าเริ่มต้น concat

วิธีการปรับเงื่อนไขรูปภาพ: concat จะสร้างโมเดลจากหลายมุมมองของวัตถุเดียว โดยไม่กำหนดลำดับการอัปโหลด หรือใช้ fuse ซึ่งต้องมีรูปภาพอย่างน้อยหนึ่งรูป และสร้างโมเดลโดยดึงคุณลักษณะของวัตถุแล้วรวมเข้าด้วยกันจากหลายรูปภาพ

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

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

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

การเลือกวัสดุ: PBR หรือ Shaded โดยมีค่าเริ่มต้นเป็น PBR

quality ค่าเริ่มต้น medium

ระดับคุณภาพสำหรับการสร้าง: high, medium, low, extra-low โดยมีค่าเริ่มต้นเป็น medium

tier ค่าเริ่มต้น Regular

การเลือกระดับการสร้าง: ใช้ Sketch สำหรับ Rodin Sketch หรือ Regular สำหรับ Rodin Regular

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

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

อาร์เรย์กรอบขอบเขต ซึ่งโดยทั่วไปจัดเรียงเป็น 3 รายการ: ความยาวตามแกน X ความกว้างตามแกน Y และความสูงตามแกน Z ค่าเหล่านี้ระบุขนาดและตัวคูณการปรับขนาดของกรอบ

POST /run/hyper3d/rodin?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?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

สร้างโมเดล 3D จากพรอมต์ความยาวไม่เกิน 1024 อักขระ ภาพอินพุต หรือทั้งสองอย่าง `condition_mode` เป็น fuse หรือ concat สำหรับอินพุตหลายภาพ ตัวเลือกประกอบด้วย `quality` ตั้งแต่ extra-low ถึง high, `material` แบบ PBR หรือ Shaded, `tier` แบบ Regular หรือ Sketch, `TAPose`, `bbox_condition` และการส่งออกเป็น glb, usdz, fbx, obj หรือ stl

พารามิเตอร์

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
promptไม่บังคับ
ประเภทstring
ค่าเริ่มต้น
≤ 1,024 อักขระ
คำแนะนำสำหรับการสร้างที่ส่งเป็นข้อความ ซึ่งโหมด Text-to-3D จำเป็นต้องใช้ แต่โหมด Image-to-3D สามารถเว้นได้
input_image_urlsไม่บังคับ
ประเภทurl[] · image
URL รูปภาพต้นทาง ซึ่ง Image-to-3D จำเป็นต้องใช้ และ Text-to-3D อาจใช้เพื่อสร้างโมเดลได้
condition_modeไม่บังคับ
ประเภทenum
ค่าเริ่มต้นconcat
fuseconcat
วิธีการปรับเงื่อนไขรูปภาพ: concat จะสร้างโมเดลจากหลายมุมมองของวัตถุเดียว โดยไม่กำหนดลำดับการอัปโหลด หรือใช้ fuse ซึ่งต้องมีรูปภาพอย่างน้อยหนึ่งรูป และสร้างโมเดลโดยดึงคุณลักษณะของวัตถุแล้วรวมเข้าด้วยกันจากหลายรูปภาพ
seedไม่บังคับ
ประเภทinteger | null
0 – 65,535
ค่า seed แบบสุ่มที่ไม่บังคับ โดยมีช่วงตั้งแต่ 0–65535
geometry_file_formatไม่บังคับ
ประเภทenum
ค่าเริ่มต้นglb
glbusdzfbxobjstl
รูปแบบไฟล์เรขาคณิต เลือกจาก glb, usdz, fbx, obj, stl โดยมีค่าเริ่มต้นเป็น glb
materialไม่บังคับ
ประเภทenum
ค่าเริ่มต้นPBR
PBRShaded
การเลือกวัสดุ: PBR หรือ Shaded โดยมีค่าเริ่มต้นเป็น PBR
qualityไม่บังคับ
ประเภทenum
ค่าเริ่มต้นmedium
highmediumlowextra-low
ระดับคุณภาพสำหรับการสร้าง: high, medium, low, extra-low โดยมีค่าเริ่มต้นเป็น medium
use_hyperไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
ควบคุมการส่งออกโมเดลในโหมด hyper โดยมีค่าเริ่มต้นเป็น false
tierไม่บังคับ
ประเภทenum
ค่าเริ่มต้นRegular
RegularSketch
การเลือกระดับการสร้าง: ใช้ Sketch สำหรับ Rodin Sketch หรือ Regular สำหรับ Rodin Regular
TAPoseไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
ควบคุมว่าจะสร้างโมเดลลักษณะมนุษย์ในท่า T/A หรือไม่
bbox_conditionไม่บังคับ
ประเภทinteger[]
อาร์เรย์กรอบขอบเขต ซึ่งโดยทั่วไปจัดเรียงเป็น 3 รายการ: ความยาวตามแกน X ความกว้างตามแกน Y และความสูงตามแกน Z ค่าเหล่านี้ระบุขนาดและตัวคูณการปรับขนาดของกรอบ
addonsไม่บังคับ
ประเภทstring | null
ส่วนเสริมการสร้างที่ไม่บังคับ โดยมีค่าเริ่มต้นเป็น [] ตัวเลือก HighPack ที่มีให้จะจัดเตรียมโมเดลโพลิกอนสูง และเพิ่มความละเอียดพื้นผิวจากค่าเริ่มต้น 1K เป็น 4K
จำเป็น

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

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin",
  "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
    },
    "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 ที่สร้างขึ้น
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.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt