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

Hyper3D - Rodin V2.5 - Image to 3D

אינטעגרירן

מאָדעל־id hyper3d/rodin/v2.5
# 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?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.40⁩ 400 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Hyper3D בילד צו 3D 4K רעזולטאַטשנעל #image-to-3d

בילד־צו־3D מיט Rodin V2.5 מיט ביז 5 רעפֿערענץ־בילדער און אַ ברירה פֿון קוואַליטעט־שטופֿן

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 · addons
image_urls
לייגט אַרײַן אַ טעקע, אָדער · ביז 5

URL־ען פֿון קוואַל־בילדער, באַגרענעצט צו 5 בילדער און מאַנדאַטאָריש אין Image-to-3D מאָדע, פֿאַר גענערירן דעם מאָדעל.

geometry_file_format סטאַנדאַרט glb

פֿאָרמאַט פֿון דער געאָמעטריע־פֿײַל, אויסגעקליבן פֿון glb, usdz, fbx, obj, stl; סטאַנדאַרט איז glb.

material סטאַנדאַרט All

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

texture_mode

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

סטאַנדאַרט Gen-2.5-High

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

סטאַנדאַרט Auto

Mesh־טאָפּאָלאָגיע און קוואַליטעט, מיט פֿראָנט־צאָלן באַשטימט לויטן ראַנג: Extreme-Low, Low און Medium לאָזן ביז 1M Triangle; High און Extreme-High שטיצן 20K Triangle ביז 2M Triangle. Auto ניצט די רעקאָמענדירטע באַשטעטיקונגען: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. בײַ מאַנועלן אויסקלײַב גיט Quad פֿאָרזיכט גלאַטערע ייבערפֿלאַכן און Triangle פּרטימדיקע געאָמעטריע; Hyper3D API באַקומט די טאָפּאָלאָגיע ווי `mesh_mode` (Quad/Raw) און די פֿראָנט־צאָל ווי `quality_override`.

אָפּציאָנאַלער צופֿעליקער זוימען מיט אַ ריי פֿון 0–65535.

באַגרענעצט ווי גרויס דער גענערירטער מאָדעל קען זײַן דורך אַ ControlNet.

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

POST /run/hyper3d/rodin/v2.5?wait=20 פּרײַז → ⁨$ 0.40⁩
# 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?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

בויט אַ 3D־מאָדעל פֿון איין ביז פֿינף בילדער אין `image_urls`, מיט אַן אַפּשאַנאַל `prompt` ביז 1024 כאַראַקטערן. זעקס שטופֿן גייען פֿון Gen-2.5-Minimum ביז Gen-2.5-Extreme-High, מיט High ווי באַשטאַנד. אָפּציעס אַרייַננעמען געאָמעטריע־פֿאָרמאַט (glb, usdz, fbx, obj, stl), `material`, קוואַדראַט־ אָדער טריאַנגלע־מעש־גרייסן, `TAPose` פֿאַר ריג־פרײַנדלעכע כאַראַקטערן און `hd_texture`.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
≤ 1,024 כאַראַקטערן
פֿירן די גענערירונג מיט טעקסט, אָדער לאָזן דעם מאָדעל אויטאָמאַטיש אַרויסלייגן אַ פּראָמפּט פֿון די בילדער דורך עס ליידיק צו לאָזן אין Image-to-3D מאָדע.
image_urlsאָפּציאָנעל images
טיפּurl[] · image
≤ 5 ייטעמס
URL־ען פֿון קוואַל־בילדער, באַגרענעצט צו 5 בילדער און מאַנדאַטאָריש אין Image-to-3D מאָדע, פֿאַר גענערירן דעם מאָדעל.
tierאָפּציאָנעל
טיפּenum
סטאַנדאַרטGen-2.5-High
Gen-2.5-MinimumGen-2.5-Extreme-LowGen-2.5-LowGen-2.5-MediumGen-2.5-HighGen-2.5-Extreme-High
Mesh־פּרטימדיקייט־ראַנג; העכערונג גיט מער פּרטים, אָבער Gen-2.5-Minimum אַקטיוויזירט אויטאָמאַטיש minimum מאָדע און צווינגט 50K Triangle, ניט קוקנדיק אויף quality_mesh_option. ווייטערדיקע פּרטים זײַנען אין דער [דאָקומענטאַציע](https://developer.hyper3d.ai/api-specification/rodin-gen2.5#use-gen-2.5-generation-with-following-gen-2.5-tiers).
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
סטאַנדאַרטAll
PBRShadedAllNone
מאַטעריאַל־רעזולטאַט־אויסקלײַב: קלײַבט None פֿאַר געאָמעטריע אָן טעקסטורן, אָדער All פֿאַר ביידע מאַטעריאַל־וואַריאַנטן. פֿאַר רעאַליסטישע ליכט מיט פֿיזיקאַליש־באזירטע מאַטעריאַלן קלײַבט PBR; פֿאַר בייקט ליכט אָן PBR־מאַפּעס קלײַבט Shaded.
quality_mesh_optionאָפּציאָנעל
טיפּenum
סטאַנדאַרטAuto
Auto4K Quad8K Quad18K Quad50K Quad100K Quad200K Quad2K Triangle20K Triangle50K Triangle150K Triangle500K Triangle1M Triangle2M Triangle
Mesh־טאָפּאָלאָגיע און קוואַליטעט, מיט פֿראָנט־צאָלן באַשטימט לויטן ראַנג: Extreme-Low, Low און Medium לאָזן ביז 1M Triangle; High און Extreme-High שטיצן 20K Triangle ביז 2M Triangle. Auto ניצט די רעקאָמענדירטע באַשטעטיקונגען: 1. Gen-2.5-Minimum → 50K Triangle; 2. Gen-2.5-Extreme-Low → 50K Triangle; 3. Gen-2.5-Low → 50K Triangle; 4. Gen-2.5-Medium → 500K Triangle; 5. Gen-2.5-High → 500K Triangle; Gen-2.5-Extreme-High → 1M Triangle. בײַ מאַנועלן אויסקלײַב גיט Quad פֿאָרזיכט גלאַטערע ייבערפֿלאַכן און Triangle פּרטימדיקע געאָמעטריע; Hyper3D API באַקומט די טאָפּאָלאָגיע ווי `mesh_mode` (Quad/Raw) און די פֿראָנט־צאָל ווי `quality_override`.
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־אַקס.
addonsאָפּציאָנעל
טיפּobject
אָפּציאָנאַלע צוגאָב־אויסקלײַב, צוגעשטעלט ווי אַ ליסטע אָדער, פֿאַר איין צוגאָב, ווי אַ יחיד־ווערט.
addons.high_packאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
HighPack פֿאַרבעסערונג: Quad־רעזולטאַט האָט בערך 16 מאָל די געבעטן פֿראָנט־צאָל דורך דעם quality פּאַראַמעטער, און טעקסטורן נוצן 4K רעזאָלוציע אַנשטאָט פֿון סטאַנדאַרט 2K.
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",
  "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": 400,
    "usd": "0.40",
    "charged": 400,
    "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.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt