Langkau ke kandungan

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

Integrasikan

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

Permintaan ini: $0.10 100 kredit API · ≈ ₽10.76 Jalankan pada halaman ini

Dapatkan kunci API
Hyper3D Teks ke 3D Output 4KPantas #text-to-3d

Teks kepada 3D pantas dengan Rodin V2.5 yang dihadkan kepada peringkat rendah 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.

•diperlukan 88 / 1024

Arahan teks yang memandu penjanaan model; wajib dalam mod Text-to-3D.

Lanjutan 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
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/text-to-3d/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.ru/v1/run/hyper3d/rodin/v2.5/text-to-3d/fast?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"

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 - Text to 3D - Fast

Menukarkan `prompt` wajib (sehingga 1024 aksara) kepada model 3D menggunakan peringkat Minimum, Extreme-Low (lalai) dan Low. Pilihan jejaring menyokong sehingga 20K muka dan bahan lalai ialah Shaded. Menyokong output glb, usdz, fbx, obj dan stl, `seed` daripada 0 hingga 65535 serta `TAPose` untuk watak.

Parameter

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 1,024 aksara
Arahan teks yang memandu penjanaan model; wajib dalam mod Text-to-3D.
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).
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.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2.5/text-to-3d/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": "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"
  }
}
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: Teks ke 3D

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