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

Hunyuan 3D Pro Text to 3D

אינטעגרירן

מאָדעל־id hunyuan-3d/v3.1/pro/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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#text-to-3d

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

Tencent · 3D

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

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

בויען אַ בעטן

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

•פארלאנגט 88 / 1024

גענערירונג־פּראָמפּט מיט אַ מאַקסימום לענג פֿון 1024 UTF-8 אותיות, וואָס באַשרײַבט וואָס פֿאַר 3D־אינהאַלט צו שאַפֿן.

סטאַנדאַרט 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/text-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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Text to 3D

שאַפֿט אַ 3D מאָדעל פֿון אַ `prompt` מיט ביז 1024 אותיות. `generate_type` קלײַבט אַ טעקסטורירטע רעזולטאַט אָדער אַ געאָמעטריע־בלויז ווײַסן מאָדעל, `enable_pbr` לייגט צו מעטאַלישע, ראַווענעס־ און נאָרמאַל־טעקסטורן, און `face_count` גייט פֿון 40,000 ביז 1,500,000. גיט צוריק אַ GLB פֿײַל, URL־ן צו אַנדערע פֿאָרמאַטן, אַ זוימען און אַ טאַמבנייל.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
≤ 1,024 כאַראַקטערן
גענערירונג־פּראָמפּט מיט אַ מאַקסימום לענג פֿון 1024 UTF-8 אותיות, וואָס באַשרײַבט וואָס פֿאַר 3D־אינהאַלט צו שאַפֿן.
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.
פארלאנגט

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/text-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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/text-to-3d.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt