Langkau ke kandungan

Hyper3D - Rodin V2.5 - Image to 3D - Fast

Integrasikan

ID model hyper3d/rodin/v2.5/fast
# 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/fast?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"

Permintaan ini: $0.10 100 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Hyper3D Imej ke 3D Output 4KPantas #image-to-3d

Imej kepada 3D Rodin V2.5 yang lebih pantas, terhad kepada tiga peringkat terendah untuk prototaip pantas

Hyper3D · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

0 / 1024

Pandukan penjanaan dengan teks, atau biarkan model memperoleh prompt secara automatik daripada imej dengan mengosongkan medan ini dalam mod Image-to-3D.

Lanjutan 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
image_urls
Lepaskan fail, atau · sehingga 5

URL imej sumber, terhad kepada 5 imej dan wajib dalam mod Image-to-3D, untuk menjana model.

geometry_file_format lalai glb

Format fail geometri, dipilih daripada glb, usdz, fbx, obj, stl; lalai ialah glb.

material lalai Shaded

Pilihan output bahan: pilih None untuk geometri tanpa tekstur, atau All untuk menerima kedua-dua varian bahan. Untuk pencahayaan realistik dengan bahan berasaskan fizik, pilih PBR; untuk pencahayaan terprabina tanpa peta PBR, pilih Shaded.

texture_mode

Pilih kualiti tekstur secara jelas atau serahkan pilihan kepada API, yang menggunakan lalai sesuai dengan aras.

lalai Gen-2.5-Extreme-Low

Aras penjanaan; Gen-2.5-Minimum memaksa mod minimum dan mesh 50K Triangle tanpa mengira `quality_mesh_option`. Butiran aras tersedia dalam [dokumentasi Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

lalai Auto

Pilih kualiti bersama topologi mesh: Quad mengutamakan permukaan licin, manakala Triangle mengutamakan perincian geometri. Endpoint pantas ditujukan terutamanya untuk ujian dan prototaip, dengan had 20K; gunakan endpoint standard untuk mesh berkualiti lebih tinggi, dengan Minimum, Extreme-Low dan Low menyokong sehingga 1M Triangle, manakala bilangan muka yang tersedia bergantung pada aras. Dalam Hyper3D API, `quality_override` menentukan bilangan muka, manakala `mesh_mode` menentukan Quad/Raw. Auto memilih tetapan yang disyorkan: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

Seed rawak pilihan dengan julat 0–65535.

Hadkan saiz maksimum model yang dijana menggunakan ControlNet.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 sebut harga → $0.10
# 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/fast?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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Hyper3D - Rodin V2.5 - Image to 3D - Fast

Mencipta model 3D daripada satu hingga lima imej dalam `image_urls`, dengan `prompt` pilihan. `tier` terhad kepada Minimum, Extreme-Low (lalai) dan Low, manakala pilihan mesh mencapai maksimum 20K muka. Bahan lalai ialah Shaded. Format output ialah glb, usdz, fbx, obj atau stl.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urlspilihan images
Jenisurl[] · image
≤ 5 item
URL imej sumber, terhad kepada 5 imej dan wajib dalam mod Image-to-3D, untuk menjana model.
tierpilihan
Jenisenum
LalaiGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
Aras penjanaan; Gen-2.5-Minimum memaksa mod minimum dan mesh 50K Triangle tanpa mengira `quality_mesh_option`. Butiran aras tersedia dalam [dokumentasi Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
promptpilihan
Jenisstring
Lalai
≤ 1,024 aksara
Pandukan penjanaan dengan teks, atau biarkan model memperoleh prompt secara automatik daripada imej dengan mengosongkan medan ini dalam mod Image-to-3D.
use_original_alphapilihan
Jenisboolean
Lalaifalse
Mengawal pengekalan saluran ketelusan imej input semasa menjana kandungan 3D.
seedpilihan
Jenisinteger | null
0 – 65,535
Seed rawak pilihan dengan julat 0–65535.
geometry_file_formatpilihan
Jenisenum
Lalaiglb
glbusdzfbxobjstl
Format fail geometri, dipilih daripada glb, usdz, fbx, obj, stl; lalai ialah glb.
materialpilihan
Jenisenum
LalaiShaded
PBRShadedAllNone
Pilihan output bahan: pilih None untuk geometri tanpa tekstur, atau All untuk menerima kedua-dua varian bahan. Untuk pencahayaan realistik dengan bahan berasaskan fizik, pilih PBR; untuk pencahayaan terprabina tanpa peta PBR, pilih Shaded.
quality_mesh_optionpilihan
Jenisenum
LalaiAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Pilih kualiti bersama topologi mesh: Quad mengutamakan permukaan licin, manakala Triangle mengutamakan perincian geometri. Endpoint pantas ditujukan terutamanya untuk ujian dan prototaip, dengan had 20K; gunakan endpoint standard untuk mesh berkualiti lebih tinggi, dengan Minimum, Extreme-Low dan Low menyokong sehingga 1M Triangle, manakala bilangan muka yang tersedia bergantung pada aras. Dalam Hyper3D API, `quality_override` menentukan bilangan muka, manakala `mesh_mode` menentukan Quad/Raw. Auto memilih tetapan yang disyorkan: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modepilihan
Jenisenum
legacyextreme-lowlowmediumhigh
Pilih kualiti tekstur secara jelas atau serahkan pilihan kepada API, yang menggunakan lalai sesuai dengan aras.
enable_creative_modepilihan
Jenisboolean
Lalaifalse
Mod penjanaan kreatif, setara dengan `geometry_instruct_mode` yang ditetapkan kepada `creative` dalam Hyper3D API. Mendayakannya menjadikan penjanaan lebih teguh tanpa menjejaskan ketekalan output.
hd_texturepilihan
Jenisboolean
Lalaifalse
Mengawal pemprosesan pasca tekstur lanjutan untuk memperbaik kesetiaan visual.
texture_delightpilihan
Jenisboolean
Lalaifalse
Membuang pencahayaan dan sorotan terprabina daripada tekstur yang dijana.
is_micropilihan
Jenisboolean
Lalaifalse
Menambah perincian geometri yang lebih halus pada skala mikro; hanya berkuat kuasa apabila `tier="Gen-2.5-Extreme-High"`.
TAPosepilihan
Jenisboolean
Lalaifalse
Tetapan pose watak untuk pemrigaan dan animasi yang lebih mudah dalam perisian 3D: mendayakannya menjana watak dalam pose T atau A.
bbox_conditionpilihan
Jenisobject
Hadkan saiz maksimum model yang dijana menggunakan ControlNet.
bbox_condition.widthpilihan
Jenisinteger
Lalai0
1 – 2,048
Lebar kekangan kotak pembatas sepanjang paksi x.
bbox_condition.heightpilihan
Jenisinteger
Lalai0
1 – 2,048
Tinggi kekangan kotak pembatas sepanjang paksi y.
bbox_condition.lengthpilihan
Jenisinteger
Lalai0
1 – 2,048
Panjang kekangan kotak pembatas sepanjang paksi z.
preview_renderpilihan
Jenisboolean
Lalaifalse
Suis pratonton render yang menambah imej yang menunjukkan model 3D yang dijana kepada fail model yang dihantar.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/fast",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_mesh
object {url, content_type, file_name, file_size}Fail yang mengandungi objek 3D yang dijana.
model_meshes
array of object {url, content_type, file_name, file_size}Fail objek 3D tambahan yang dijana oleh Hyper3D dan dikembalikan selain model_mesh.
seed
integerSeed yang digunakan semasa penjanaan.
textures
array of object {url, content_type, file_name, file_size, width, height}Tekstur yang dihasilkan untuk objek 3D.

Lebih banyak model: Imej ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/hyper3d/rodin/v2.5/fast.md. Semua model dan panduan: https://doitong.com/developers/llms.txt