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

Hyper3d

אינטעגרירן

מאָדעל־id hyper3d/rodin/v2
# 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?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#text-to-3d

Rodin v2 פֿון טעקסט אָדער בילד צו 3D מיט ביז 5 אַרײַנגעבונג בילדער, קוואַדראַט־ אָדער דרײַעק־מעש־פּרעסעטן און אַ פּריוויו־רענדער

Hyper3D · 3D

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

0 / 1024

פֿירן די גענערירונג מיט אַ טעקסט־פּראָמפּט, אָדער לאָזן עס ליידיק אין Image-to-3D מאָדע, כּדי AI זאָל אַרויסלייגן דעם פּראָמפּט פֿון אײַערע בילדער.

פֿאָרגעשריטן input_image_urls · geometry_file_format · material · quality_mesh_option · addons · seed · use_original_alpha · TAPose · preview_render · bbox_condition
לייגט אַרײַן אַ טעקע, אָדער

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

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

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

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

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

quality_mesh_option סטאַנדאַרט 500K Triangle

צונויפֿגעשטעלטער mesh און קוואַליטעט־אויסקלײַב, מאַפּירט אין Hyper3D API צו `quality_override` ניצנדיק דעם נומערישן טייל פֿון דער אָפּציע, און צו `mesh_mode` ניצנדיק 'Raw' ווען די אָפּציע אַנטהאַלט 'Triangle', אַנדערש 'Quad'. Quad גיט פֿאָרזיכט גלאַטערע ייבערפֿלאַכן; Triangle גיט פֿאָרזיכט פּרטימדיקע געאָמעטריע.

HighPack גיט high-poly מאָדעלן און הייבט די טעקסטור־רעזאָלוציע פֿון סטאַנדאַרט 1K צו 4K.

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

Bounding-box גרייס ווי אַ ליסטע אין דער סדר [width, height, length].

POST /run/hyper3d/rodin/v2?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?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

שאַפֿט 3D־מאָדעלן פֿון אַ פּראָמפּט (ביז 1024 כאַראַקטערן) און ביז 5 בילדער אין `input_image_urls`. `quality_mesh_option` אָפפערט קוואַדראַט־מעשן פֿון 4K ביז 50K און טריאַנגלע־מעשן פֿון 2K ביז 500K. שטיצט `material` PBR, Shaded אָדער All, `TAPose`, `use_original_alpha` און `preview_render`.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptאָפּציאָנעל
טיפּstring
סטאַנדאַרט
≤ 1,024 כאַראַקטערן
פֿירן די גענערירונג מיט אַ טעקסט־פּראָמפּט, אָדער לאָזן עס ליידיק אין Image-to-3D מאָדע, כּדי AI זאָל אַרויסלייגן דעם פּראָמפּט פֿון אײַערע בילדער.
input_image_urlsאָפּציאָנעל
טיפּurl[] · image
URL־ען פֿון קוואַל־בילדער, באַגרענעצט צו 5 בילדער און מאַנדאַטאָריש אין 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
סטאַנדאַרטAll
PBRShadedAll
מאַטעריאַל־אויסקלײַב, מיט All וואָס נעמט אַרײַן ביידע אַלטערנאַטיוון: PBR ניצט אַ פֿיזיקאַליש־באזירטע צוגאַנג פֿאַר רעאַליסטישע ליכט, בשעת Shaded ניצט פּשוטע מאַטעריאַלן און בייקט ליכט.
quality_mesh_optionאָפּציאָנעל
טיפּenum
סטאַנדאַרט500K Triangle
4K Quad8K Quad18K Quad50K Quad2K Triangle20K Triangle150K Triangle500K Triangle
צונויפֿגעשטעלטער mesh און קוואַליטעט־אויסקלײַב, מאַפּירט אין Hyper3D API צו `quality_override` ניצנדיק דעם נומערישן טייל פֿון דער אָפּציע, און צו `mesh_mode` ניצנדיק 'Raw' ווען די אָפּציע אַנטהאַלט 'Triangle', אַנדערש 'Quad'. Quad גיט פֿאָרזיכט גלאַטערע ייבערפֿלאַכן; Triangle גיט פֿאָרזיכט פּרטימדיקע געאָמעטריע.
TAPoseאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
כאַראַקטער־פּאָזע פֿאַר גרינגער rigging און אַנימאַציע אין 3D־פּראָגראַם: אַקטיוויזירן עס גענערירט כאַראַקטערן אין T-pose אָדער A-pose.
bbox_conditionאָפּציאָנעל
טיפּinteger[]
Bounding-box גרייס ווי אַ ליסטע אין דער סדר [width, height, length].
addonsאָפּציאָנעל
טיפּstring | null
HighPack גיט high-poly מאָדעלן און הייבט די טעקסטור־רעזאָלוציע פֿון סטאַנדאַרט 1K צו 4K.
preview_renderאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
Preview-render באַשטימער וואָס לייגט צו אַ בילד פֿון דעם גענערירטן 3D־מאָדעל אין די איבערגעגעבענע מאָדעל־פֿײַלן.
פארלאנגט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם file_url פֿון אַן אַרויפֿלאָד. טעקעס

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hyper3d/rodin/v2",
  "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־אָבדזשעקט.

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