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

Tripo H3.1 Text to 3D

אינטעגרירן

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

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

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

Tripo · 3D

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

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

בויען אַ בעטן

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

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

טעקסט־באַשרײַבונג פֿונעם געוואונטשן 3D אָביעקט, באַגרענעצט צו 1024 אותיות.

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

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

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

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

פֿאָרגעשריטן negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

באַשרײַבונג פֿון פֿעיִקייטן וואָס זאָלן אויסגעשלאָסן ווערן פֿונעם גענערירטן מאָדעל.

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

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

סיד גענוצט בעת דער text-to-image בינע.

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

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

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

בויט אַ 3D־מאָדעל פֿון אַ טעקסט־באַשרײַבונג ביז 1024 אותיות, מיט אַן אַפּשאַנאַל `negative_prompt` פֿאַר פֿעיִקייטן וואָס מען זאָל אויסמײַדן. `face_limit` נעמט 1,000 ביז 2,000,000 פֿעיס. `geometry_quality` און `texture_quality` קענען יעדע זײַן standard אָדער detailed. אָפּציעס אַרײַננעמען PBR־מאַטעריאַלן, קוואַד־טאָפּאָלאָגיע, אויטאָמאַטישן סקיילינג צו דער רעאַלער גרייס, און באַזונדערע סעעדס פֿאַר געאָמעטריע, דעם טעקסט־צו־בילד־טריט און טעקסטור.

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

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
promptפארלאנגט
טיפּstring
≤ 1,024 כאַראַקטערן
טעקסט־באַשרײַבונג פֿונעם געוואונטשן 3D אָביעקט, באַגרענעצט צו 1024 אותיות.
negative_promptאָפּציאָנעל
טיפּstring | null
≤ 1,024 כאַראַקטערן
באַשרײַבונג פֿון פֿעיִקייטן וואָס זאָלן אויסגעשלאָסן ווערן פֿונעם גענערירטן מאָדעל.
face_limitאָפּציאָנעל
טיפּinteger | null
1,000 – 2,000,000
עקספּליציטער ציל פֿאַר פֿאַס־צאָל בײַם שאַפֿן דעם מעש, וואָס איבעררײַסט דעם מאָדעלס אַדאַפּטיוון צאָל־אויסקלײַב ווען צוגעשטעלט.
textureאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
קאָנטראָלירט צי דער מאָדעל באַקומען גענערירטע געוועבן.
pbrאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
אַקטיווירט PBR מאַטעריאַלן (Physically Based Rendering), וואָס אַקטיווירט אויך טעקסטור־גענערירונג ווען דער ווערט איז true.
model_seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט צו מאַכן דזשיאַמאַטריע־גענערירונג רעפּראָדוצירבאַר.
image_seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט בעת דער text-to-image בינע.
texture_seedאָפּציאָנעל
טיפּinteger | null
סיד גענוצט צו מאַכן טעקסטור־גענערירונג רעפּראָדוצירבאַר.
texture_qualityאָפּציאָנעל
טיפּenum
סטאַנדאַרטstandard
standarddetailed
טעקסטור־קוואַליטעט־באַשטעטיקונג; אויסקלייבן 'detailed' פֿאַר העכערע טעקסטור־רעזאָלוציע.
geometry_qualityאָפּציאָנעל
טיפּenum
סטאַנדאַרטstandard
standarddetailed
קוואַליטעט־באַשטעטיקונג פֿאַר דער דזשיאַמאַטריע.
auto_sizeאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
אָטאָמאַטישע סקאַלירונג צו געבן דעם מאָדעל רעאַלע דימענסיעס געמאסטן אין מעטער.
quadאָפּציאָנעל
טיפּboolean
סטאַנדאַרטfalse
קלײַבט צווישן דרײַעקיקע פֿעדער און קוואַדראַטן מיט 4 זײַטן דורך אַקטיווירן קוואַד־טאָפּאָלאָגיע. פֿאַר קוואַד־רעזולטאַטן ווערט אַ FBX פֿײַל צוריקגעגעבן ווען Tripo גיט די דאַטן ווי FBX־בײַטס.
enable_safety_checkerאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
סקרינינג קען ווערן פאַרלייכטערט דורך שטעלן false, אויב דער רופער איז אָטעריזירט.
פארלאנגט

אויסגאַבע

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