உள்ளடக்கத்திற்குச் செல்க

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

ஒருங்கிணை

மாடல் id 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கை: $0.10 100 API கிரெடிட்கள் · ≈ ₽10.47 இந்தப் பக்கத்தில் இயக்குங்கள்

API விசையைப் பெறுக
Hyper3D படத்திலிருந்து 3D-க்கு 4K வெளியீடுவேகமானது #image-to-3d

விரைவான முன்மாதிரிக்காக குறைந்த மூன்று அடுக்குகளுக்கு மட்டுப்படுத்தப்பட்ட வேகமான Rodin V2.5 படத்திலிருந்து 3D

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
image_urls
கோப்பை விடுங்கள் அல்லது · 5 வரை

மாதிரியை உருவாக்குவதற்கான மூலப் பட URL-கள்; அதிகபட்சம் 5 படங்கள், Image-to-3D பயன்முறையில் கட்டாயம்.

geometry_file_format இயல்புநிலை glb

glb, usdz, fbx, obj, stl ஆகியவற்றிலிருந்து தேர்ந்தெடுக்கப்படும் வடிவியல் கோப்பு வடிவம்; இயல்புநிலை glb.

material இயல்புநிலை Shaded

பொருள் வெளியீட்டுத் தேர்வு: textures இல்லாத வடிவியலுக்கு None அல்லது இரு பொருள் மாறுபாடுகளையும் பெற All தேர்வு செய்யவும். இயற்பியல் அடிப்படையிலான பொருட்களுடன் யதார்த்தமான ஒளியூட்டலுக்கு PBR; PBR maps இல்லாத baked ஒளியூட்டலுக்கு Shaded தேர்வு செய்யவும்.

texture_mode

Texture தரத்தை வெளிப்படையாகத் தேர்ந்தெடுக்கவும் அல்லது தேர்வை API-க்கு விடவும்; அது அடுக்குக்கு ஏற்ற இயல்புநிலையைப் பயன்படுத்தும்.

இயல்புநிலை Gen-2.5-Extreme-Low

உருவாக்க அடுக்கு; `quality_mesh_option`-ஐப் பொருட்படுத்தாமல் Gen-2.5-Minimum minimum பயன்முறையையும் 50K Triangle mesh-ஐயும் கட்டாயப்படுத்தும். அடுக்கு விவரங்கள் [Hyper3D ஆவணங்களில்](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) உள்ளன.

இயல்புநிலை Auto

Mesh topology-யுடன் தரத்தையும் தேர்ந்தெடுக்கவும்: Quad மென்மையான மேற்பரப்புகளுக்கு முன்னுரிமை அளிக்கும், Triangle வடிவியல் விவரங்களுக்கு முன்னுரிமை அளிக்கும். வேகமான முனையம் முதன்மையாகச் சோதனை மற்றும் prototype உருவாக்கத்திற்காக, 20K வரம்புடன் உள்ளது; உயர்தர meshes-க்கு நிலையான முனையத்தைப் பயன்படுத்தவும். இதில் Minimum, Extreme-Low, Low ஆகியவை அதிகபட்சம் 1M Triangle-ஐ ஆதரிக்கும்; கிடைக்கும் முக எண்ணிக்கை அடுக்கைப் பொறுத்தது. Hyper3D API-இல் `quality_override` முக எண்ணிக்கையையும், `mesh_mode` Quad/Raw-ஐயும் குறிப்பிடும். Auto பரிந்துரைக்கப்பட்ட அமைப்புகளைத் தேர்ந்தெடுக்கும்: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

0–65535 வரம்பைக் கொண்ட விருப்பமான சீரற்றமயமாக்கல் seed.

ControlNet-ஐப் பயன்படுத்தி உருவாக்கப்படும் மாதிரியின் அதிகபட்ச அளவைக் கட்டுப்படுத்தவும்.

POST /run/hyper3d/rodin/v2.5/fast?wait=20 விலை → $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/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

இந்தக் கோரிக்கையை இயக்கு

உங்கள் key இந்த உலாவியில் மட்டுமே இருக்கும்: அது Doitong API-க்கு மட்டும் அனுப்பப்படும்; Remember-ஐத் தேர்ந்தெடுத்தால் மட்டுமே (localStorage)-ல் சேமிக்கப்படும். API விசையைப் பெறுங்கள்

Hyper3D - Rodin V2.5 - Image to 3D - Fast பற்றி

`image_urls`-இல் உள்ள ஒன்று முதல் ஐந்து படங்களிலிருந்து 3D மாதிரியை உருவாக்குகிறது; விருப்பமான `prompt`-ஐ ஏற்கிறது. `tier` Minimum, Extreme-Low (இயல்புநிலை) மற்றும் Low ஆகியவற்றுக்கு மட்டுப்படுத்தப்பட்டுள்ளது; மெஷ் விருப்பங்கள் அதிகபட்சம் 20K முகங்களைக் கொண்டவை. Material இயல்புநிலையாக Shaded. வெளியீட்டு வடிவங்கள் glb, usdz, fbx, obj அல்லது stl.

அளவுருக்கள்

நியமப் பெயர் அல்லது நேட்டிவ் பெயர் இரண்டில் ஒன்றை மட்டும் அனுப்பவும். நியமப் பெயர்கள்

பெயர்வகை இயல்புநிலைஅனுமதிக்கப்பட்டது விளக்கம்
image_urlsவிருப்பத்தேர்வு images
வகைurl[] · image
≤ 5 உருப்படிகள்
மாதிரியை உருவாக்குவதற்கான மூலப் பட URL-கள்; அதிகபட்சம் 5 படங்கள், Image-to-3D பயன்முறையில் கட்டாயம்.
tierவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைGen-2.5-Extreme-Low
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low
உருவாக்க அடுக்கு; `quality_mesh_option`-ஐப் பொருட்படுத்தாமல் Gen-2.5-Minimum minimum பயன்முறையையும் 50K Triangle mesh-ஐயும் கட்டாயப்படுத்தும். அடுக்கு விவரங்கள் [Hyper3D ஆவணங்களில்](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers) உள்ளன.
promptவிருப்பத்தேர்வு
வகைstring
இயல்புநிலை
≤ 1,024 எழுத்துகள்
உரை மூலம் உருவாக்கத்தை வழிநடத்தவும்; அல்லது Image-to-3D பயன்முறையில் இதை காலியாக விட்டால், படங்களிலிருந்து மாதிரி தானாகப் ப்ராம்ப்ட்டைப் பெறும்.
use_original_alphaவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
3D உள்ளடக்கத்தை உருவாக்கும்போது உள்ளீட்டுப் படத்தின் transparency channels தக்கவைக்கப்பட வேண்டுமா என்பதைக் கட்டுப்படுத்துகிறது.
seedவிருப்பத்தேர்வு
வகைinteger | null
0 – 65,535
0–65535 வரம்பைக் கொண்ட விருப்பமான சீரற்றமயமாக்கல் seed.
geometry_file_formatவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைglb
glbusdzfbxobjstl
glb, usdz, fbx, obj, stl ஆகியவற்றிலிருந்து தேர்ந்தெடுக்கப்படும் வடிவியல் கோப்பு வடிவம்; இயல்புநிலை glb.
materialவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைShaded
PBRShadedAllNone
பொருள் வெளியீட்டுத் தேர்வு: textures இல்லாத வடிவியலுக்கு None அல்லது இரு பொருள் மாறுபாடுகளையும் பெற All தேர்வு செய்யவும். இயற்பியல் அடிப்படையிலான பொருட்களுடன் யதார்த்தமான ஒளியூட்டலுக்கு PBR; PBR maps இல்லாத baked ஒளியூட்டலுக்கு Shaded தேர்வு செய்யவும்.
quality_mesh_optionவிருப்பத்தேர்வு
வகைenum
இயல்புநிலைAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
Mesh topology-யுடன் தரத்தையும் தேர்ந்தெடுக்கவும்: Quad மென்மையான மேற்பரப்புகளுக்கு முன்னுரிமை அளிக்கும், Triangle வடிவியல் விவரங்களுக்கு முன்னுரிமை அளிக்கும். வேகமான முனையம் முதன்மையாகச் சோதனை மற்றும் prototype உருவாக்கத்திற்காக, 20K வரம்புடன் உள்ளது; உயர்தர meshes-க்கு நிலையான முனையத்தைப் பயன்படுத்தவும். இதில் Minimum, Extreme-Low, Low ஆகியவை அதிகபட்சம் 1M Triangle-ஐ ஆதரிக்கும்; கிடைக்கும் முக எண்ணிக்கை அடுக்கைப் பொறுத்தது. Hyper3D API-இல் `quality_override` முக எண்ணிக்கையையும், `mesh_mode` Quad/Raw-ஐயும் குறிப்பிடும். Auto பரிந்துரைக்கப்பட்ட அமைப்புகளைத் தேர்ந்தெடுக்கும்: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.
texture_modeவிருப்பத்தேர்வு
வகைenum
legacyextreme-lowlowmediumhigh
Texture தரத்தை வெளிப்படையாகத் தேர்ந்தெடுக்கவும் அல்லது தேர்வை API-க்கு விடவும்; அது அடுக்குக்கு ஏற்ற இயல்புநிலையைப் பயன்படுத்தும்.
enable_creative_modeவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
Hyper3D API-இல் `geometry_instruct_mode`-ஐ `creative` ஆக அமைப்பதற்கு இணையான படைப்பாற்றல் உருவாக்கப் பயன்முறை. இதை இயக்குவது வெளியீட்டு நிலைத்தன்மையைப் பாதிக்காமல் உருவாக்கத்தை மேலும் நம்பகமானதாக்கும்.
hd_textureவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
காட்சித் துல்லியத்தை மேம்படுத்தும் மேம்பட்ட texture பிந்தைய செயலாக்கத்தைக் கட்டுப்படுத்துகிறது.
texture_delightவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
உருவாக்கப்பட்ட textures-இலிருந்து baked செய்யப்பட்ட ஒளியூட்டலையும் highlights-ஐயும் நீக்குகிறது.
is_microவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
micro அளவில் நுணுக்கமான வடிவியல் விவரங்களைச் சேர்க்கிறது; `tier="Gen-2.5-Extreme-High"` இருக்கும்போது மட்டுமே செயல்படும்.
TAPoseவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
3D மென்பொருளில் rigging மற்றும் animation எளிதாக்கும் கதாபாத்திர நிலை அமைப்பு: இதை இயக்கினால் கதாபாத்திரங்கள் T-pose அல்லது A-pose-ல் உருவாக்கப்படும்.
bbox_conditionவிருப்பத்தேர்வு
வகைobject
ControlNet-ஐப் பயன்படுத்தி உருவாக்கப்படும் மாதிரியின் அதிகபட்ச அளவைக் கட்டுப்படுத்தவும்.
bbox_condition.widthவிருப்பத்தேர்வு
வகைinteger
இயல்புநிலை0
1 – 2,048
x அச்சில் bounding box கட்டுப்பாட்டு அகலம்.
bbox_condition.heightவிருப்பத்தேர்வு
வகைinteger
இயல்புநிலை0
1 – 2,048
y அச்சில் bounding box கட்டுப்பாட்டு உயரம்.
bbox_condition.lengthவிருப்பத்தேர்வு
வகைinteger
இயல்புநிலை0
1 – 2,048
z அச்சில் bounding box கட்டுப்பாட்டு நீளம்.
preview_renderவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைfalse
வழங்கப்படும் மாதிரி கோப்புகளில் உருவாக்கப்பட்ட 3D மாதிரியைக் காட்டும் படத்தைச் சேர்க்கும் preview-render நிலைமாற்றி.
enable_safety_checkerவிருப்பத்தேர்வு
வகைboolean
இயல்புநிலைtrue
அழைப்பாளர் அங்கீகரிக்கப்பட்டிருந்தால், false என அமைப்பதன் மூலம் திரையிடலைத் தளர்த்தலாம்.
தேவை நியமப் பெயர், இதுவும் ஏற்கப்படும்

கோப்பு அளவுருக்கள் பொதுவான https:// URL, 10 MB வரையிலான data: URI அல்லது பதிவேற்றத்தின் file_url-ஐ ஏற்கும். கோப்புகள்

வெளியீடு

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
உங்கள் கோப்புகள், உங்கள் தேர்வுஒவ்வொரு outputs[].url-ம் எங்கள் சேமிப்பகத்தில் உள்ள ஒரு நகல்: நிரந்தரமாக (GB-மாதத்திற்கு கட்டணம்) அல்லது உங்கள் கணக்கு அமைப்பு அல்லது ?storage= மூலம் இலவசமாக 7 நாட்கள் வைக்கப்படும்.
ஒவ்வொரு மாடலிலும் ஒரே வடிவம்படங்கள், வீடியோ மற்றும் ஆடியோ ஆகிய அனைத்திற்குமான 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}Hyper3D உருவாக்கி, model_mesh-க்கு கூடுதலாகத் திருப்பி வழங்கும் கூடுதல் 3D பொருள் கோப்புகள்.
seed
integerஉருவாக்கத்தின் போது பயன்படுத்தப்படும் seed.
textures
array of object {url, content_type, file_name, file_size, width, height}3D பொருளுக்காக உருவாக்கப்பட்ட textures.

மேலும் மாதிரிகள்: படத்திலிருந்து 3D-க்கு

AI ஏஜெண்டுகளுக்கு: இந்தப் பக்கம் Markdown வடிவில் இங்கே உள்ளது https://doitong.com/ta/developers/models/hyper3d/rodin/v2.5/fast.md. அனைத்து மாடல்களும் வழிகாட்டிகளும்: https://doitong.com/developers/llms.txt