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

Hunyuan3d V3 · Sketch to 3D

אינטעגרירן

מאָדעל־id hunyuan3d-v3/sketch-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/sketch-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",
    "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

Hunyuan3D V3 וואָס פֿאַרוואַנדלט אַ סקיצע אָדער ליניע־קונסט מיט אַ טעקסט־פּראָמפּט אין אַ 3D־מאָדעל

Tencent · 3D

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

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

בויען אַ בעטן

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

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

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

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

URL פֿון אַ סקיצע אָדער line-art בילד פֿאַר פֿאַרוואַנדלונג אין אַ 3D־מאָדעל. געשטיצטע בילד־גרייסן זײַנען פֿון 128 × 128 ביז 5000 × 5000 פּיקסעלן.

סטאַנדאַרט 500000

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

פֿאָרגעשריטן enable_safety_checker
POST /run/hunyuan3d-v3/sketch-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/sketch-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",
    "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 שליסל

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

דאַרף אַ סקיצע אָדער ליניע־קונסט־בילד (`input_image_url`, 128x128 ביז 5000x5000 פּיקסעלן) און אַ `prompt` מיט ביז 1024 אותיות וואָס באַשרײַבט קאָליר, קאַטעגאָריע און מאַטעריאַל. `enable_pbr` צינדט אָן PBR מאַטעריאַלן, און `face_count` באַשטימט די ציל־פּאָליגאָן־צאָל פֿון 40000 ביז 1500000. גיט צוריק אַ GLB פֿײַל, URL־ן צו אַנדערע פֿאָרמאַטן און אַ טאַמבנייל.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlפארלאנגט
טיפּurl · image
URL פֿון אַ סקיצע אָדער line-art בילד פֿאַר פֿאַרוואַנדלונג אין אַ 3D־מאָדעל. געשטיצטע בילד־גרייסן זײַנען פֿון 128 × 128 ביז 5000 × 5000 פּיקסעלן.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
promptפארלאנגט
טיפּstring
≤ 1,024 כאַראַקטערן
ספּעציפֿיצירט אַטריבוטן אין אַ טעקסט־פּראָמפּט פֿאַרן 3D־אינהאַלט—למשל מאַטעריאַל, קאָליר אָדער קאַטעגאָריע.
enable_pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
באַשטימער פֿאַר גענערירן PBR־מאַטעריאַלן.
face_countאָפּציאָנעל
טיפּinteger
סטאַנדאַרט500000
40,000 – 1,500,000
געוווּנטשענע צאָל פֿראָנטן, פֿון 40,000 ביז 1,500,000.
פארלאנגט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/sketch-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",
    "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
      },
      "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/sketch-to-3d.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt