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

Hunyuan3d V3 · Image to 3D

אינטעגרירן

מאָדעל־id hunyuan3d-v3/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/hunyuan3d-v3/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.34⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Tencent בילד צו 3D

Hunyuan3D V3 פֿון בילד צו 3D מיט אַפּשאַנאַלע קוקן פֿון הינטן, לינקס און רעכטס, PBR און low-poly־מאָדעס

Tencent · 3D

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

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

בויען אַ בעטן

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

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

בילד־URL גענוצט פֿאַר 3D־מאָדעל־גענערירונג.

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

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

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

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

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

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

generate_type סטאַנדאַרט Normal

גענערירונג־מאָדע: `Normal` שאַפֿט אַ טעקסטורירט מאָדעל; `LowPoly` רעדוצירט פּאָליגאָנן; `Geometry` שאַפֿט אַן אומטעקסטורירט ווײַסן מאָדעל.

סטאַנדאַרט 500000

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

פֿאָרגעשריטן polygon_type · enable_safety_checker
polygon_type סטאַנדאַרט triangle

פּאָליגאָן־טיפּ, געווענדט בלויז ווען `GenerateType` איז `LowPoly`.

POST /run/hunyuan3d-v3/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/hunyuan3d-v3/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 שליסל

וועגן Hunyuan3d V3 · Image to 3D

שאַפֿט אַ 3D־מאָדעל פֿון `input_image_url`, מיט אַפּשאַנאַלע `back_image_url`, `left_image_url` און `right_image_url` צו פֿאַרבעסערן די רעקאָנסטרוקציע. `generate_type` קלייַבט Normal, LowPoly אָדער Geometry (אומטעקסטורירט), און `polygon_type` קלייַבט triangle אָדער quadrilateral פֿאַר LowPoly. `enable_pbr` לייגט צו PBR־מאַטעריאַלן און `face_count` גייט פֿון 40000 ביז 1500000. גיט צוריק אַ GLB, URL־ען פֿאַר אַנדערע פֿאָרמאַטן און אַ טאַמבנײַל.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlפארלאנגט
טיפּurl · image
בילד־URL גענוצט פֿאַר 3D־מאָדעל־גענערירונג.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
back_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ בילד פֿון הינטן, אָפּציאָנאַל צוגעשטעלט צו פֿאַרבעסערן 3D־רעקאָנסטרוקציע.
left_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ בילד פֿון לינקס, אָפּציאָנאַל צוגעשטעלט צו פֿאַרבעסערן 3D־רעקאָנסטרוקציע.
right_image_urlאָפּציאָנעל
טיפּurl · image
URL פֿון אַ בילד פֿון רעכטס, אָפּציאָנאַל צוגעשטעלט צו פֿאַרבעסערן 3D־רעקאָנסטרוקציע.
enable_pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
גענערירט PBR־מאַטעריאַלן, סיידן generate_type איז Geometry; אין דעם פֿאַל האָט די באַשטעטיקונג קיין ווירקונג נישט.
face_countאָפּציאָנעל
טיפּinteger
סטאַנדאַרט500000
40,000 – 1,500,000
געוווּנטשענע צאָל פֿראָנטן, פֿון 40,000 ביז 1,500,000.
generate_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטNormal
NormalLowPolyGeometry
גענערירונג־מאָדע: `Normal` שאַפֿט אַ טעקסטורירט מאָדעל; `LowPoly` רעדוצירט פּאָליגאָנן; `Geometry` שאַפֿט אַן אומטעקסטורירט ווײַסן מאָדעל.
polygon_typeאָפּציאָנעל
טיפּenum
סטאַנדאַרטtriangle
trianglequadrilateral
פּאָליגאָן־טיפּ, געווענדט בלויז ווען `GenerateType` איז `LowPoly`.
פארלאנגט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/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
      },
      "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, usdz}לינקס צו דעם 3D־מאָדעל אין פֿאַרשידענע פֿאָרמאַטן.
seed
integer | nullסיד־ווערט גענוצט בעת גענערירונג.

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

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