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

Unganisha

Kitambulisho cha modeli 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hyper3d/rodin/v2.5/fast?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": ""
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2.5/fast", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "hyper3d/rodin/v2.5/fast",
  "input": {
    "prompt": ""
  }
}

Piga modeli ya Hyper3D - Rodin V2.5 - Image to 3D - Fast (hyper3d/rodin/v2.5/fast) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/hyper3d/rodin/v2.5/fast.md

POST https://api.doitong.com/v1/run/hyper3d/rodin/v2.5/fast?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "prompt": ""
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.com/v1/quote/hyper3d/rodin/v2.5/fast yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Ombi hili: $ 0.10 salio za API 100 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Hyper3D Picha hadi 3D Pato la 4KHaraka #image-to-3d

Rodin V2.5 ya haraka kutoka picha hadi 3D, yenye viwango vitatu vya chini pekee kwa prototyping ya haraka

OpenAPI Markdown

Hyper3D · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt 0 / 1024

Ongoza uzalishaji kwa maandishi, au acha modeli itengeneze kidokezo kiotomatiki kutoka kwenye picha kwa kuacha sehemu hii tupu katika hali ya Image-to-3D.

Ya kina 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

images image_urls

Dondosha faili, au · hadi 5

URL za picha chanzo, zikiwa na kikomo cha picha 5 na lazima zitolewe katika hali ya Image-to-3D kwa ajili ya kuzalisha modeli.

geometry_file_format chaguomsingi glb

Umbizo la faili ya jiometri, huchaguliwa kutoka glb, usdz, fbx, obj, stl; chaguomsingi ni glb.

material chaguomsingi Shaded

Uteuzi wa tokeo la nyenzo: chagua None kwa jiometri isiyo na maandishi, au All kupokea aina zote mbili za nyenzo. Kwa mwangaza halisi wenye nyenzo zinazotegemea fizikia, chagua PBR; kwa mwangaza uliopikwa bila ramani za PBR, chagua Shaded.

texture_mode

Chagua ubora wa maandishi wazi au acha API ichague, ikitumia chaguomsingi inayofaa kiwango.

tier chaguomsingi Gen-2.5-Extreme-Low

Kiwango cha uzalishaji; Gen-2.5-Minimum hulazimisha hali ya minimum na mesh ya 50K Triangle bila kujali `quality_mesh_option`. Maelezo ya viwango yanapatikana katika [nyaraka za Hyper3D](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

quality_mesh_option chaguomsingi Auto

Chagua ubora pamoja na topolojia ya mesh: Quad hupendelea nyuso laini, huku Triangle ikipendelea maelezo ya jiometri. Endpoint ya haraka inalenga hasa majaribio na uundaji wa mfano, ikiwa na kikomo cha 20K; tumia endpoint ya kawaida kwa mesh zenye ubora wa juu, ambapo Minimum, Extreme-Low na Low huunga mkono hadi 1M Triangle, huku idadi ya nyuso ikitegemea kiwango. Katika Hyper3D API, `quality_override` hubainisha idadi ya nyuso, huku `mesh_mode` ikibainisha Quad/Raw. Auto huchagua mipangilio inayopendekezwa: 1. Gen-2.5-Minimum → 20K Triangle; 2. Gen-2.5-Extreme-Low → 20K Triangle; 3. Gen-2.5-Low → 20K Triangle.

seed

Mbegu ya hiari ya nasibu yenye masafa ya 0–65535.

bbox_condition

Punguza ukubwa wa juu wa modeli iliyozalishwa kwa kutumia ControlNet.

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

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/hyper3d/rodin/v2.5/fast?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": ""
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/hyper3d/rodin/v2.5/fast", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "hyper3d/rodin/v2.5/fast",
      "input": {
        "prompt": ""
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

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

Huunda modeli ya 3D kutoka picha moja hadi tano katika `image_urls`, ikiwa na `prompt` ya hiari. `tier` imezuiwa kuwa Minimum, Extreme-Low (chaguo-msingi) na Low, na chaguo za mesh hufikia nyuso 20K. Material chaguo-msingi ni Shaded. Miundo ya matokeo ni glb, usdz, fbx, obj au stl.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

image_urlssi lazima images

Ainaurl[] · image

≤ vipengee 5

URL za picha chanzo, zikiwa na kikomo cha picha 5 na lazima zitolewe katika hali ya Image-to-3D kwa ajili ya kuzalisha modeli.

tiersi lazima

Ainaenum

ChaguomsingiGen-2.5-Extreme-Low

Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-Low

promptsi lazima

Ainastring

Chaguomsingi

≤ herufi 1,024

Ongoza uzalishaji kwa maandishi, au acha modeli itengeneze kidokezo kiotomatiki kutoka kwenye picha kwa kuacha sehemu hii tupu katika hali ya Image-to-3D.

use_original_alphasi lazima

Ainaboolean

Chaguomsingifalse

Hudhibiti uhifadhi wa njia za uwazi za picha za ingizo wakati wa kuzalisha maudhui ya 3D.

seedsi lazima

Ainainteger | null

0 – 65,535

Mbegu ya hiari ya nasibu yenye masafa ya 0–65535.

geometry_file_formatsi lazima

Ainaenum

Chaguomsingiglb

glbusdzfbxobjstl

Umbizo la faili ya jiometri, huchaguliwa kutoka glb, usdz, fbx, obj, stl; chaguomsingi ni glb.

materialsi lazima

Ainaenum

ChaguomsingiShaded

PBRShadedAllNone

quality_mesh_optionsi lazima

Ainaenum

ChaguomsingiAuto

Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle

texture_modesi lazima

Ainaenum

legacyextreme-lowlowmediumhigh

Chagua ubora wa maandishi wazi au acha API ichague, ikitumia chaguomsingi inayofaa kiwango.

enable_creative_modesi lazima

Ainaboolean

Chaguomsingifalse

Hali ya uzalishaji bunifu, sawa na `geometry_instruct_mode` iliyowekwa kuwa `creative` katika Hyper3D API. Kuiwezesha hufanya uzalishaji uwe thabiti zaidi bila kupunguza uthabiti wa tokeo.

hd_texturesi lazima

Ainaboolean

Chaguomsingifalse

Hudhibiti uchakataji wa kina wa baada ya uzalishaji wa maandishi ili kuboresha uaminifu wa kuona.

texture_delightsi lazima

Ainaboolean

Chaguomsingifalse

Huondoa mwangaza na uangazaji uliopikwa kutoka kwenye maandishi yaliyotengenezwa.

is_microsi lazima

Ainaboolean

Chaguomsingifalse

Huongeza maelezo bora ya jiometri kwa kiwango kidogo; huathiri tu wakati `tier="Gen-2.5-Extreme-High"`.

TAPosesi lazima

Ainaboolean

Chaguomsingifalse

Mpangilio wa mkao wa mhusika kwa urahisi wa rigging na uhuishaji katika programu ya 3D: ukiwezeshwa, huzalisha wahusika katika mkao wa T au A.

bbox_conditionsi lazima

Ainaobject

Punguza ukubwa wa juu wa modeli iliyozalishwa kwa kutumia ControlNet.

bbox_condition.widthsi lazima

Ainainteger

Chaguomsingi0

1 – 2,048

Upana wa kizuizi cha kisanduku cha mipaka kwenye mhimili wa x.

bbox_condition.heightsi lazima

Ainainteger

Chaguomsingi0

1 – 2,048

Kimo cha kizuizi cha kisanduku cha mipaka kwenye mhimili wa y.

bbox_condition.lengthsi lazima

Ainainteger

Chaguomsingi0

1 – 2,048

Urefu wa kizuizi cha kisanduku cha mipaka kwenye mhimili wa z.

preview_rendersi lazima

Ainaboolean

Chaguomsingifalse

Kigeuza cha uonyeshaji wa hakikisho kinachoongeza picha inayoonyesha modeli ya 3D iliyozalishwa kwenye faili za modeli zilizowasilishwa.

enable_safety_checkersi lazima

Ainaboolean

Chaguomsingitrue

Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.

inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

model_mesh: object {url, content_type, file_name, file_size}Faili iliyo na kitu cha 3D kilichozalishwa.
model_meshes: array of object {url, content_type, file_name, file_size}Faili za ziada za vitu vya 3D zinazozalishwa na Hyper3D na kurejeshwa pamoja na model_mesh.
seed: integerSeed inayotumika wakati wa uzalishaji.
textures: array of object {url, content_type, file_name, file_size, width, height}Maandishi yaliyotengenezwa kwa kitu cha 3D.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/hyper3d/rodin/v2.5/fast.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt

Tokeo lako la kwanza linaonekana hapa

Unda ombi

Endesha ombi hili

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

Vigezo

Tokeo

Tofauti nyingine za Hyper3D - Rodin V2.5

Hyper3D - Rodin V2.5 - Image to 3D Tofauti: 4

Hyper3D - Rodin V2.5 - Text to 3D Tofauti: 4

Hyper3D - Rodin V2.5 - Text to 3D - Fast Tofauti: 4

Miundo zaidi: Picha hadi 3D

Hyper3d

Hyper3D Rodin

Hi3D Image to 3D Tofauti: 6

Hi3D Image to 3D · v3.0 Tofauti: 2