שפּרינגען צו אינהאַלט

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

דער דאָזיקער ריקוועסט: ⁨$ 0.10⁩ 100 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן 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

מאַטעריאַל־רעזולטאַט־אויסקלײַב: קלײַבט None פֿאַר געאָמעטריע אָן טעקסטורן, אָדער All פֿאַר ביידע מאַטעריאַל־וואַריאַנטן. פֿאַר רעאַליסטישע ליכט מיט פֿיזיקאַליש־באזירטע מאַטעריאַלן קלײַבט PBR; פֿאַר בייקט ליכט אָן PBR־מאַפּעס קלײַבט Shaded.

texture_mode

קלײַבט די טעקסטור־קוואַליטעט בפֿירוש, אָדער לאָזט די ברירה בײַם API, וואָס ניצט אַ סטאַנדאַרט פּאַסיק צום ראַנג.

סטאַנדאַרט Gen-2.5-Extreme-Low

גענערירונג־ראַנג; Gen-2.5-Minimum צווינגט minimum מאָדע און אַ 50K Triangle mesh, ניט קוקנדיק אויף `quality_mesh_option`. פּרטים וועגן די ראַנגען זײַנען אין דער [Hyper3D דאָקומענטאַציע](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).

סטאַנדאַרט Auto

קלײַבט קוואַליטעט צוזאַמען מיט mesh־טאָפּאָלאָגיע: Quad גיט פֿאָרזיכט גלאַטערע ייבערפֿלאַכן, בשעת Triangle גיט פֿאָרזיכט געאָמעטרישן פּרט. דער שנעלער ענדפּוינט איז בעיקר פֿאַר טעסטינג און פּראָוטאָטײַפּינג, מיט אַ 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.

באַגרענעצט ווי גרויס דער גענערירטער מאָדעל קען זײַן דורך אַ 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.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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Hyper3D - Rodin V2.5 - Image to 3D - Fast

שאַפֿט אַ 3D־מאָדעל פֿון איין ביז פֿינף בילדער אין `image_urls`, מיט אַן אַפּשאַנאַל `prompt`. `tier` איז באַגרענעצט צו Minimum, Extreme-Low (באַשטאַנד) און Low, און די מעש־אָפּציעס דערגרייכן לכל־היותר 20K פֿאַסעס. דער מאַטעריאַל איז לויטן באַשטאַנד 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
גענערירונג־ראַנג; Gen-2.5-Minimum צווינגט minimum מאָדע און אַ 50K Triangle mesh, ניט קוקנדיק אויף `quality_mesh_option`. פּרטים וועגן די ראַנגען זײַנען אין דער [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־אינהאַלט־גענערירונג.
seedאָפּציאָנעל
טיפּinteger | null
0 – 65,535
אָפּציאָנאַלער צופֿעליקער זוימען מיט אַ ריי פֿון 0–65535.
geometry_file_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטglb
glbusdzfbxobjstl
פֿאָרמאַט פֿון דער געאָמעטריע־פֿײַל, אויסגעקליבן פֿון glb, usdz, fbx, obj, stl; סטאַנדאַרט איז glb.
materialאָפּציאָנעל
טיפּenum
סטאַנדאַרטShaded
PBRShadedAllNone
מאַטעריאַל־רעזולטאַט־אויסקלײַב: קלײַבט None פֿאַר געאָמעטריע אָן טעקסטורן, אָדער All פֿאַר ביידע מאַטעריאַל־וואַריאַנטן. פֿאַר רעאַליסטישע ליכט מיט פֿיזיקאַליש־באזירטע מאַטעריאַלן קלײַבט PBR; פֿאַר בייקט ליכט אָן PBR־מאַפּעס קלײַבט Shaded.
quality_mesh_optionאָפּציאָנעל
טיפּenum
סטאַנדאַרטAuto
Auto1K Quad4K Quad8K Quad18K Quad20K Quad2K Triangle4K Triangle8K Triangle10K Triangle20K Triangle
קלײַבט קוואַליטעט צוזאַמען מיט mesh־טאָפּאָלאָגיע: Quad גיט פֿאָרזיכט גלאַטערע ייבערפֿלאַכן, בשעת Triangle גיט פֿאָרזיכט געאָמעטרישן פּרט. דער שנעלער ענדפּוינט איז בעיקר פֿאַר טעסטינג און פּראָוטאָטײַפּינג, מיט אַ 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
קלײַבט די טעקסטור־קוואַליטעט בפֿירוש, אָדער לאָזט די ברירה בײַם API, וואָס ניצט אַ סטאַנדאַרט פּאַסיק צום ראַנג.
enable_creative_modeאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קרעאַטיווע גענערירונג־מאָדע, עקוויוואַלענט צו `geometry_instruct_mode` באַשטימט אויף `creative` אין Hyper3D API. אַקטיוויזירן עס מאַכט די גענערירונג מער שטאַביל אָן אָפּצוגעבן פֿון דער קאָנסיסטענץ פֿונעם רעזולטאַט.
hd_textureאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קאָנטראָלירט פֿאָרגעשריטענע טעקסטור־נאָך־פּראַסעסירונג צו פֿאַרבעסערן וויזועלער געטרײַקייט.
texture_delightאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אַרויסנעמט בייקט ליכט און הויכליכטונגען פֿון גענערירטע טעקסטורן.
is_microאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
לייגט צו פֿײַנערע געאָמעטרישע פּרטים אויף מיקראָ־מאַס; ווירקט בלויז ווען `tier="Gen-2.5-Extreme-High"`.
TAPoseאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
כאַראַקטער־פּאָזע פֿאַר גרינגער rigging און אַנימאַציע אין 3D־פּראָגראַם: אַקטיוויזירן עס גענערירט כאַראַקטערן אין T-pose אָדער A-pose.
bbox_conditionאָפּציאָנעל
טיפּobject
באַגרענעצט ווי גרויס דער גענערירטער מאָדעל קען זײַן דורך אַ ControlNet.
bbox_condition.widthאָפּציאָנעל
טיפּinteger
סטאַנדאַרט0
1 – 2,048
Bounding-box באַגרענעצונג: ברייט צוזאמען דער x־אַקס.
bbox_condition.heightאָפּציאָנעל
טיפּinteger
סטאַנדאַרט0
1 – 2,048
Bounding-box באַגרענעצונג: הייך צוזאמען דער y־אַקס.
bbox_condition.lengthאָפּציאָנעל
טיפּinteger
סטאַנדאַרט0
1 – 2,048
Bounding-box באַגרענעצונג: לענג צוזאמען דער z־אַקס.
preview_renderאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
Preview-render באַשטימער וואָס לייגט צו אַ בילד פֿון דעם גענערירטן 3D־מאָדעל אין די איבערגעגעבענע מאָדעל־פֿײַלן.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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־אָבדזשעקט.
model_meshes
array of object {url, content_type, file_name, file_size}עקסטרע 3D־אָבדזשעקט־פֿײַלן געשאַפֿן דורך Hyper3D און צוריקגעגעבן אין צוגאָב צו model_mesh.
seed
integerסיד געניצט בעת גענערירונג.
textures
array of object {url, content_type, file_name, file_size, width, height}טעקסטורן געשאַפֿן פֿאַרן 3D־אָבדזשעקט.

מער מאָדעלן: בילד צו 3D

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/hyper3d/rodin/v2.5/fast.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt