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

Hi3D Image to 3D

אינטעגרירן

מאָדעל־id hitem3d/hi3d/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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.50⁩ 500 API־קרעדיטן · ≈ ⁨₽ 53.79⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

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

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

Hitem3D · 3D

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

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

בויען אַ בעטן

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

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

צושטעלן דעם אַרײַנגעבונגס־בילד דורך URL ווי אַ PNG, JPEG אָדער WebP פֿײַל וואָס איז נישט גרעסער פֿון 20 MB.

resolution

גענערירונג־רעזאָלוציע, סטאַנדאַרט לויט דער מאָדעל־רעקאָמענדאַציע: 1024 פֿאַר v1.5/v2.0 און דער שנעלער טיר אַנדערש. פֿאַר v1.5/v2.0 זענען די אָפּציעס 512, 1024, 1536 און 1536pro; פֿאַר v2.1 — 1536fast און 1536pro; פֿאַר scene-portraitv1.5 — 1536; פֿאַר scene-portraitv2.0 — 1536pro; און פֿאַר scene-portraitv2.1 — 1536profast און 1536pro.

פֿאָרגעשריטן model · export_format · face_count · enable_texture · enable_pbr · enable_safety_checker
model סטאַנדאַרט hitem3dv2.1

גענערירונג־מאָדעל־אויסקלײַבער: קלײַבט פֿון דער פּאָרטרעט־און־כאַראַקטער־אָפּגעשטימטער 'scene-portrait*' פֿאַמיליע אָדער דער אַלגעמיינער 'hitem3d*' פֿאַמיליע.

export_format סטאַנדאַרט glb

פֿאָרמאַט פֿאַר שפּאָרן דעם גענערירטן מאָדעל.

געוואלטע צאָל פֿעיס פֿאַרן גענערירטן מאָדעל, איבערשרײַבנדיק דעם פּאַרטנער־רעקאָמענדאַציע לויט רעזאָלוציע. אויב נישט צוגעשטעלט, קלײַבט דער פּאַרטנער די רעקאָמענדאַציע, למשל 500k בײַ 512, 1M בײַ 1024 אָדער 2M בײַ 1536.

POST /run/hitem3d/hi3d/image-to-3d?wait=20 פּרײַז → ⁨$ 0.50⁩
# 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/hitem3d/hi3d/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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 שליסל

וועגן Hi3D Image to 3D

בויט אַ 3D מאָדעל פֿון איין בילד (PNG, JPEG אָדער WebP, ביז 20MB). די `model` אָפּציע נעמט אַרײַן אַלגעמיינע און פּאָרטרעט־אָפּטימיזירטע ווערסיעס, און ערלויבטע `resolution` ווערטן הענגען אָפּ פֿון איר. טעקסטור־ און PBR מאַפּעס קענען ווערן אַקטיווירט אָדער אויסגעלאָשן, `face_count` גייט פֿון 100,000 ביז 2,000,000, און עקספּאָרט איז glb, obj, stl, fbx אָדער usdz.

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

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
modelאָפּציאָנעל
טיפּenum
סטאַנדאַרטhitem3dv2.1
hitem3dv1.5hitem3dv2.0hitem3dv2.1scene-portraitv1.5scene-portraitv2.0scene-portraitv2.1
גענערירונג־מאָדעל־אויסקלײַבער: קלײַבט פֿון דער פּאָרטרעט־און־כאַראַקטער־אָפּגעשטימטער 'scene-portrait*' פֿאַמיליע אָדער דער אַלגעמיינער 'hitem3d*' פֿאַמיליע.
resolutionאָפּציאָנעל
טיפּenum
512102415361536pro1536fast1536profast
גענערירונג־רעזאָלוציע, סטאַנדאַרט לויט דער מאָדעל־רעקאָמענדאַציע: 1024 פֿאַר v1.5/v2.0 און דער שנעלער טיר אַנדערש. פֿאַר v1.5/v2.0 זענען די אָפּציעס 512, 1024, 1536 און 1536pro; פֿאַר v2.1 — 1536fast און 1536pro; פֿאַר scene-portraitv1.5 — 1536; פֿאַר scene-portraitv2.0 — 1536pro; און פֿאַר scene-portraitv2.1 — 1536profast און 1536pro.
enable_textureאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי טעקסטורן ווערן גענערירט צוזאַמען מיט געאָמעטריע.
enable_pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי PBR־מאַטעריאַל־מאַפּעס ווערן געשאַפֿן צוזאַמען מיט דער טעקסטור.
face_countאָפּציאָנעל
טיפּinteger | null
100,000 – 2,000,000
געוואלטע צאָל פֿעיס פֿאַרן גענערירטן מאָדעל, איבערשרײַבנדיק דעם פּאַרטנער־רעקאָמענדאַציע לויט רעזאָלוציע. אויב נישט צוגעשטעלט, קלײַבט דער פּאַרטנער די רעקאָמענדאַציע, למשל 500k בײַ 512, 1M בײַ 1024 אָדער 2M בײַ 1536.
export_formatאָפּציאָנעל
טיפּenum
סטאַנדאַרטglb
glbobjstlfbxusdz
פֿאָרמאַט פֿאַר שפּאָרן דעם גענערירטן מאָדעל.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
זיכערקייט־טשעק פֿאַר אַרײַנגעבונגס־בילדער: true פֿאָדערט אַ זיכערקייט־טשעק איידער בילד־פּראַסעסירונג הייבט אָן.
image_urlפארלאנגט image
טיפּurl · image
צושטעלן דעם אַרײַנגעבונגס־בילד דורך URL ווי אַ PNG, JPEG אָדער WebP פֿײַל וואָס איז נישט גרעסער פֿון 20 MB.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/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": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "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
    },
    "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
    }
  },
  "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_mesh
object {url, content_type, file_name, file_size}פֿײַל מיטן גענערירטן 3D־מאָדעל.
thumbnail
object {url, content_type, file_name, file_size} | nullמאָדעל־פּריוויו־בילד, צוגעשטעלט ווען פֿאַראַן.

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

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