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

Hunyuan 3D Pro Image to 3D

אינטעגרירן

מאָדעל־id hunyuan-3d/v3.1/pro/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/pro/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.375⁩ 375 API־קרעדיטן · ≈ ⁨₽ 40.24⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

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

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

Tencent · 3D

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

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

בויען אַ בעטן

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

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

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

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

URL פֿון אַ הינטער־אויסקוק־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.

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

URL פֿון אַ לינקער־זײַט־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.

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

URL פֿון אַ רעכטער־זײַט־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.

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

URL פֿון אַן אויבן־אויסקוק־בילד, אָפּציאָנעל און בלויז פֿאַראַן אין v3.1; JPG/PNG ווערט רעקאָמענדירט.

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

URL פֿון אַן אָפּציאָנעלן אונטן־אויסקוק־בילד, געשטיצט נאָר אין v3.1. JPG/PNG ווערט רעקאָמענדירט.

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

אָפּציאָנעלער בילד־URL וואָס איז פֿאַראַן נאָר אין v3.1, בעסער אין JPG/PNG פֿאָרמאַט. דאָס בילד גיט אַ 45־גראַד־אויסקוק פֿון לינקן פֿראָנט.

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

אָפּציאָנעלער בילד־URL וואָס איז פֿאַראַן נאָר אין v3.1, בעסער אין JPG/PNG פֿאָרמאַט. דאָס בילד גיט אַ 45־גראַד־אויסקוק פֿון רעכטן פֿראָנט.

סטאַנדאַרט 500000

געוואלטע צאָל פּאָליגאָן־פֿעיס, פֿון 40,000 ביז 1,500,000. סטאַנדאַרט איז 500,000.

פֿאָרגעשריטן generate_type
generate_type סטאַנדאַרט Normal

קלײַבט צווישן אַ טעקסטורירטן מאָדעל מיט Normal און אַן אומטעקסטורירטן ווײַסן, בלויז־געאָמעטריע־מאָדעל מיט Geometry. אין v3.1 קען מען נישט אויסקלײַבן LowPoly/Sketch.

POST /run/hunyuan-3d/v3.1/pro/image-to-3d?wait=20 פּרײַז → ⁨$ 0.375⁩
# 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/pro/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 Pro Image to 3D

שאַפֿט אַ 3D־מאָדעל פֿון אַ נייטיק פֿאָרנט־בילד, `input_image_url`. אַפּשאַנאַלע בילדער פֿון הינטן, לינקס, רעכטס, אויבן, אונטן און צוויי 45-degree־קוקן קענען צולייגן דעטאַל. `generate_type` קלייַבט אַ טעקסטורירטן מאָדעל אָדער אַ ווײַסן מאָדעל נאָר מיט געאָמעטריע, `enable_pbr` לייגט צו PBR־מאַטעריאַלן, און `face_count` גייט פֿון 40,000 ביז 1,500,000. גיט צוריק אַ GLB, URL־ען פֿאַר אַנדערע פֿאָרמאַטן און אַ טאַמבנײַל.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlפארלאנגט
טיפּurl · image
URL פֿון אַ פֿראָנט־אויסקוק־בילד אין JPG, PNG אָדער WEBP, מיט רעזאָלוציע פֿון 128 ביז 5000px און גרייס נישט גרעסער פֿון 8 MB. אַ פּשוטער הינטערגרונט און איין אָביעקט וואָס פֿילט מער ווי 50% פֿונעם ראַם ווערן רעקאָמענדירט.
back_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ הינטער־אויסקוק־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.
left_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ לינקער־זײַט־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.
right_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ רעכטער־זײַט־בילד, אָפּציאָנעל; JPG/PNG ווערט רעקאָמענדירט.
top_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַן אויבן־אויסקוק־בילד, אָפּציאָנעל און בלויז פֿאַראַן אין v3.1; JPG/PNG ווערט רעקאָמענדירט.
bottom_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַן אָפּציאָנעלן אונטן־אויסקוק־בילד, געשטיצט נאָר אין v3.1. JPG/PNG ווערט רעקאָמענדירט.
left_front_image_urlאָפּציאָנעל
טיפּurl · image
אָפּציאָנעלער בילד־URL וואָס איז פֿאַראַן נאָר אין v3.1, בעסער אין JPG/PNG פֿאָרמאַט. דאָס בילד גיט אַ 45־גראַד־אויסקוק פֿון לינקן פֿראָנט.
right_front_image_urlאָפּציאָנעל
טיפּurl · image
אָפּציאָנעלער בילד־URL וואָס איז פֿאַראַן נאָר אין v3.1, בעסער אין JPG/PNG פֿאָרמאַט. דאָס בילד גיט אַ 45־גראַד־אויסקוק פֿון רעכטן פֿראָנט.
generate_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטNormal
NormalGeometry
קלײַבט צווישן אַ טעקסטורירטן מאָדעל מיט Normal און אַן אומטעקסטורירטן ווײַסן, בלויז־געאָמעטריע־מאָדעל מיט Geometry. אין v3.1 קען מען נישט אויסקלײַבן LowPoly/Sketch.
enable_pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
PBR־גענערירונג־באַשטעטיקונג, נישט אַקטיוו ווען generate_type איז Geometry. אַנדערש לייגט איר אַקטיווירנדיק עס צו מעטאַלישע, ראַפֿנאַס־און־נאָרמאַל־טעקסטורן אין די גענערירטע מאַטעריאַלן.
face_countאָפּציאָנעל
טיפּinteger
סטאַנדאַרט500000
40,000 – 1,500,000
געוואלטע צאָל פּאָליגאָן־פֿעיס, פֿון 40,000 ביז 1,500,000. סטאַנדאַרט איז 500,000.
פארלאנגט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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": 375,
    "usd": "0.375",
    "charged": 375,
    "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
    },
    "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
      }
    },
    "seed": 42
  },
  "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}GLB־פֿײַל מיטן גענערירטן 3D־אָביעקט.
thumbnail
object {url, content_type, file_name, file_size} | nullטהומבנייל מיט אַ פּריוויו פֿונעם גענערירטן מאָדעל.
model_urls
object {glb, fbx, obj, mtl, texture, usdz}לינקס צו דעם 3D־מאָדעל אין פֿאַרשידענע פֿאָרמאַטן.
seed
integer | nullסיד־ווערט גענוצט בעת גענערירונג.

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

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