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

Tripo H3.1 Image to 3D

אינטעגרירן

מאָדעל־id tripo3d/h3.1/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/tripo3d/h3.1/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.30⁩ 300 API־קרעדיטן · ≈ ⁨₽ 32.27⁩ אײַערע פֿײַלן ווערן געמאסטן איידערן לויפֿן לויפֿן עס אויף דער דאָזיקער בלאַט

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

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

Tripo · 3D

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

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

בויען אַ בעטן

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

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

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

texture_quality סטאַנדאַרט standard

טעקסטור־קוואַליטעט־באַשטעטיקונג; אויסקלייבן 'detailed' פֿאַר העכערע טעקסטור־רעזאָלוציע.

geometry_quality סטאַנדאַרט standard

קוואַליטעט־באַשטעטיקונג פֿאַר דער דזשיאַמאַטריע.

פֿאָרגעשריטן texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment סטאַנדאַרט original_image

רעפֿערענץ פֿאַר טעקסטור־אויסריכטן: ניצט 'geometry' פֿאַר די גענערירטע דזשיאַמאַטריע אָדער 'original_image' פֿאַר דער אַרײַנגעבונגס־בילד.

orientation סטאַנדאַרט default

אָריענטאַציע פֿון דעם מאָדעל; 'align_image' דרייט אים אָטאָמאַטיש צו פּאַסן צו דער אַרײַנגעבונגס־בילד.

עקספּליציטער ציל פֿאַר פֿאַס־צאָל בײַם שאַפֿן דעם מעש, וואָס איבעררײַסט דעם מאָדעלס אַדאַפּטיוון צאָל־אויסקלײַב ווען צוגעשטעלט.

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

סיד גענוצט צו מאַכן טעקסטור־גענערירונג רעפּראָדוצירבאַר.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 פּרײַז → ⁨$ 0.30⁩
# 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/tripo3d/h3.1/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 שליסל

וועגן Tripo H3.1 Image to 3D

שאַפֿט אַ 3D מאָדעל פֿון איין בילד ביי `image_url`. די אָפּציעס אַרייַננעמען `face_limit` (1,000 ביז 2,000,000), `texture`, `pbr`, נאָרמאַלע אָדער דעטאַלירטע `texture_quality` און `geometry_quality`, `quad` טאָפּאָלאָגיע, `auto_size` און `orientation`. דער רעזולטאַט כולל אַ פּריוויו־רענדער און אַ טאַסק ID פֿאַר שפּעטערדיקן ריגינג.

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

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון אַרײַנגעבונג־בילד גענוצט צו שאַפֿן אַ 3D־מאָדעל.
face_limitאָפּציאָנעל
טיפּinteger | null
1,000 – 2,000,000
עקספּליציטער ציל פֿאַר פֿאַס־צאָל בײַם שאַפֿן דעם מעש, וואָס איבעררײַסט דעם מאָדעלס אַדאַפּטיוון צאָל־אויסקלײַב ווען צוגעשטעלט.
textureאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי דער מאָדעל באַקומען גענערירטע געוועבן.
pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיווירט PBR מאַטעריאַלן (Physically Based Rendering), וואָס אַקטיווירט אויך טעקסטור־גענערירונג ווען דער ווערט איז true.
model_seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט צו מאַכן דזשיאַמאַטריע־גענערירונג רעפּראָדוצירבאַר.
texture_seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט צו מאַכן טעקסטור־גענערירונג רעפּראָדוצירבאַר.
texture_qualityאָפּציאָנעל
טיפּenum
סטאַנדאַרטstandard
standarddetailed
טעקסטור־קוואַליטעט־באַשטעטיקונג; אויסקלייבן 'detailed' פֿאַר העכערע טעקסטור־רעזאָלוציע.
geometry_qualityאָפּציאָנעל
טיפּenum
סטאַנדאַרטstandard
standarddetailed
קוואַליטעט־באַשטעטיקונג פֿאַר דער דזשיאַמאַטריע.
texture_alignmentאָפּציאָנעל
טיפּenum
סטאַנדאַרטoriginal_image
original_imagegeometry
רעפֿערענץ פֿאַר טעקסטור־אויסריכטן: ניצט 'geometry' פֿאַר די גענערירטע דזשיאַמאַטריע אָדער 'original_image' פֿאַר דער אַרײַנגעבונגס־בילד.
auto_sizeאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָטאָמאַטישע סקאַלירונג צו געבן דעם מאָדעל רעאַלע דימענסיעס געמאסטן אין מעטער.
orientationאָפּציאָנעל
טיפּenum
סטאַנדאַרטdefault
defaultalign_image
אָריענטאַציע פֿון דעם מאָדעל; 'align_image' דרייט אים אָטאָמאַטיש צו פּאַסן צו דער אַרײַנגעבונגס־בילד.
quadאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קלײַבט צווישן דרײַעקיקע פֿעדער און קוואַדראַטן מיט 4 זײַטן דורך אַקטיווירן קוואַד־טאָפּאָלאָגיע. פֿאַר קוואַד־רעזולטאַטן ווערט אַ FBX פֿײַל צוריקגעגעבן ווען Tripo גיט די דאַטן ווי FBX־בײַטס.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

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

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "tripo3d/h3.1/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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    },
    "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
      },
      "base_model": {
        "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
      },
      "pbr_model": {
        "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
      }
    },
    "rendered_image": {
      "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
    },
    "task_id": "string"
  },
  "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}GLB אָדער FBX פֿײַל מיטן גענערירטן 3D מאָדעל; דער פֿאָרמאַט ווערט באַשטימט לויט דעם וואָס Tripo פּראָדוצירט.
model_urls
object {glb, fbx, base_model, pbr_model}URL־ס וואָס ווײַזן אויף אַלטערנאַטיווע ווערסיעס פֿונעם 3D מאָדעל.
rendered_image
object {url, content_type, file_name, file_size} | nullרענדערטער פאָרויסקוק מיטן גענערירטן 3D מאָדעל.
task_id
string | nullווידערניצבאַרער Tripo task ID וואָס אידענטיפיצירט דעם גענערירטן מאָדעל פֿאַר rig אָדער rig-check, און דערמעגלעכט די אָפּעראַציעס אָן אַן אַנדערן מאָדעל־אויפֿלאָד.

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

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