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

Hunyuan 3D Rapid Image to 3D

אינטעגרירן

מאָדעל־id hunyuan-3d/v3.1/rapid/image-to-3d
# 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/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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.225⁩ 225 API־קרעדיטן · ≈ ⁨₽ 24.15⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Tencent בילד צו 3D #3d#hunyuan#image-to-3d

שנעלער בילד־צו־3D וואָס בויט אַ מאָדעל פֿון איין פֿאָרנט־קוק־בילד, מיט אַפּשאַנאַל PBR אָדער אַן אומטעקסטורירטן מעש

Tencent · 3D

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

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

בויען אַ בעטן

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

•פארלאנגט
לייגט אַרײַן אַ טעקע, אָדער

צושטעלן אַ פֿראָנט־אויסקוק־בילד דורך URL; אַ פּשוטער הינטערגרונט מיט איין אָביעקט וואָס דעקט מער ווי 50% פֿונעם ראַם ווערט רעקאָמענדירט. ניצט JPG, PNG אָדער WEBP מיט רעזאָלוציע צווישן 128 און 5000px, מיט אַן 8 MB־גרענעץ; פֿאַר base64־קאָדירונג ווערט 6 MB אָדער ווייניקער רעקאָמענדירט.

פֿאָרגעשריטן enable_geometry
POST /run/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20 פּרײַז → ⁨$ 0.225⁩
# 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/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Hunyuan 3D Rapid Image to 3D

שאַפֿט אַ 3D־מאָדעל פֿון איין פֿאָרנט־קוק־בילד (`input_image_url`, 128 ביז 5000 px, ביז 8MB, JPG, PNG אָדער WEBP). אַרבעט בעסטער מיט אַ פּשוטן הינטערגרונט און איין אָביעקט וואָס פֿילט מער ווי העלפֿט פֿונעם פֿרעם. `enable_pbr` לייגט צו מעטאַלישע, גראָבקייט־ און נאָרמאַל־טעקסטורן, בשעת `enable_geometry` גיט צוריק אַן אומטעקסטורירטן ווײַסן מאָדעל ווי GLB. די רעזולטאַטן אַרייַננעמען דעם מאָדעל, URL־ען לויט פֿאָרמאַט, טעקסטור, MTL־טעקע און אַ טאַמבנײַל.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlפארלאנגט
טיפּurl · image
צושטעלן אַ פֿראָנט־אויסקוק־בילד דורך URL; אַ פּשוטער הינטערגרונט מיט איין אָביעקט וואָס דעקט מער ווי 50% פֿונעם ראַם ווערט רעקאָמענדירט. ניצט JPG, PNG אָדער WEBP מיט רעזאָלוציע צווישן 128 און 5000px, מיט אַן 8 MB־גרענעץ; פֿאַר base64־קאָדירונג ווערט 6 MB אָדער ווייניקער רעקאָמענדירט.
enable_pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
PBR־גענערירונג־באַשטעטיקונג, נישט אַקטיוו ווען enable_geometry איז True. אַנדערש לייגט איר אַקטיווירנדיק עס צו מעטאַלישע, ראַפֿנאַס־און־נאָרמאַל־טעקסטורן אין די גענערירטע מאַטעריאַלן.
enable_geometryאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
באַשטעטיקונג פֿאַר בלויז־געאָמעטריע־גענערירונג וואָס שטעלט אַוועק OBJ־שטיצע, שטעלט דעם רעזולטאַט־פֿאָרמאַט אויף GLB און איגנאָרירט enable_pbr ווען אַקטיווירט. דער רעזולטירנדיקער מאָדעל איז ווײַס און האָט קיין טעקסטורן נישט.
פארלאנגט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/rapid/image-to-3d",
  "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": 225,
    "usd": "0.225",
    "charged": 225,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "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
    },
    "material_mtl": {
      "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
    },
    "texture": {
      "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
    },
    "thumbnail": {
      "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_urls": {
      "glb": {
        "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
      },
      "fbx": {
        "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
      },
      "obj": {
        "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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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
      },
      "usdz": {
        "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
      }
    }
  },
  "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־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
model_glb
object {url, content_type, file_name, file_size} | nullפֿײַל מיטן גענערירטן 3D־מאָדעל, מיט GLB ווען פֿאַראַן און אַנדערש OBJ.
material_mtl
object {url, content_type, file_name, file_size} | nullMTL־פֿײַל מיט מאַטעריאַלן פֿאַרן OBJ־מאָדעל.
texture
object {url, content_type, file_name, file_size} | nullבילד וואָס גיט די 3D־מאָדעלס טעקסטור.
thumbnail
object {url, content_type, file_name, file_size} | nullטהומבנייל מיט אַ פּריוויו פֿונעם גענערירטן מאָדעל.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}לינקס צו דעם 3D־מאָדעל אין פֿאַרשידענע פֿאָרמאַטן.

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

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/hunyuan-3d/v3.1/rapid/image-to-3d.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt