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

Hunyuan3D

אינטעגרירן

מאָדעל־id hunyuan3d/v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan3d/v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

דער דאָזיקער ריקוועסט: ⁨$ 0.16⁩ 160 API־קרעדיטן לויפֿן עס אויף דער דאָזיקער בלאַט

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

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

Tencent · 3D

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

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

בויען אַ בעטן

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

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

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

פֿאָרגעשריטן num_inference_steps · guidance_scale · octree_resolution · seed
סטאַנדאַרט 50

צאָל inference־טריט צו לויפֿן.

סטאַנדאַרט 7.5

סקייל פֿון דער guidance געווענדט צום מאָדעל.

סטאַנדאַרט 256

רעזאָלוציע פֿונעם מאָדעלס octree.

סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.

POST /run/hunyuan3d/v2?wait=20 פּרײַז → ⁨$ 0.16⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hunyuan3d/v2?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Hunyuan3D

בויט אַ 3D־אַסעט פֿון איין בילד וואָס ווערט איבערגעגעבן ווי `input_image_url`. שטעלט `textured_mesh` צו true פֿאַר אַ טעקסטורירטן רעזולטאַט; לויטן באַשטאַנד איז עס אויסגעלאָשן. `octree_resolution` גייט פֿון 1 ביז 1024 (באַשטאַנד 256), `num_inference_steps` ביז 50, און `guidance_scale` פֿון 0 ביז 20. אַ `seed` מאַכט די רעזולטאַטן איבערחזרבאַר.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
input_image_urlפארלאנגט
טיפּurl · image
בילד־URL גענוצט פֿאַר 3D־מאָדעל־גענערירונג.
seedאָפּציאָנעל
טיפּinteger | null
סיד פֿאַר רעפּראָדוצירבאַרע בילדער: אַן אידענטישער פּראָמפּט און סיד שאַפֿן אַן אידענטיש בילד ווען די מאָדעל־ווערסיע איז אומגעענדערט.
num_inference_stepsאָפּציאָנעל
טיפּinteger
סטאַנדאַרט50
1 – 50
צאָל inference־טריט צו לויפֿן.
guidance_scaleאָפּציאָנעל
טיפּnumber
סטאַנדאַרט7.5
0 – 20
סקייל פֿון דער guidance געווענדט צום מאָדעל.
octree_resolutionאָפּציאָנעל
טיפּinteger
סטאַנדאַרט256
1 – 1,024
רעזאָלוציע פֿונעם מאָדעלס octree.
textured_meshאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
פארלאנגט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d/v2",
  "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": 160,
    "usd": "0.16",
    "charged": 160,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_mesh": {
      "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
אייער טעקעס, אייער ברירהיעדער outputs[].url איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער GB־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
model_mesh
object {url, content_type, file_name, file_size}פֿײַל מיט דעם גענערירטן 3D־אָבדזשעקט.
seed
integerסיד געניצט בעת גענערירונג.

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

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