Ruka hadi kwenye maudhui

Tripo H3.1 Text to 3D

Unganisha

Kitambulisho cha modeli 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"

Faili kama mfano: $ 0.20 salio za API 200 · ≈ ₽ 21.52 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Tripo Maandishi hadi 3D #3d#text-to-3d#3d-generation#tripo

Jenereta ya mesh ya maandishi-hadi-3D yenye kidokezo hasi, viwango tofauti vya ubora wa jiometri na tekstura, na kikomo cha juu sana cha nyuso

Tripo · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika 88 / 1024

Maelezo ya maandishi ya kitu cha 3D kinachohitajika, yenye kikomo cha herufi 1024.

texture_quality chaguomsingi standard

Mpangilio wa ubora wa texture; kuchagua 'detailed' huongeza mwonekano wa texture.

geometry_quality chaguomsingi standard

Mpangilio wa ubora wa jiometri.

Ya kina negative_prompt · face_limit · model_seed · image_seed · texture_seed · auto_size · enable_safety_checker
0 / 1024

Maelezo ya vipengele vinavyopaswa kuondolewa kwenye modeli iliyozalishwa.

Lengo mahususi la idadi ya nyuso kwa uzalishaji wa mesh, linalobatilisha uteuzi wa idadi unaobadilika wa modeli linapotolewa.

Seed inayotumika kufanya uzalishaji wa jiometri uweze kurudiwa.

Seed inayotumika wakati wa hatua ya text-to-image.

Seed inayotumika kufanya uzalishaji wa texture uweze kurudiwa.

POST /run/tripo3d/h3.1/text-to-3d?wait=20 makadirio → $ 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"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Tripo H3.1 Text to 3D

Hujenga modeli ya 3D kutoka kwa maelezo ya maandishi yenye hadi vibambo 1024, ikiwa na `negative_prompt` ya hiari kwa vipengele vya kuepuka. `face_limit` hukubali nyuso 1,000 hadi 2,000,000. `geometry_quality` na `texture_quality` kila kimoja kinaweza kuwa cha kawaida au cha kina. Chaguo ni pamoja na nyenzo za PBR, topolojia ya quad, ukubwa kiotomatiki kulingana na ukubwa halisi, na mbegu tofauti za jiometri, hatua ya maandishi-hadi-picha na tekstura.

Vigezo

JinaAina ChaguomsingiInaruhusiwa Maelezo
promptinahitajika
Ainastring
≤ herufi 1,024
Maelezo ya maandishi ya kitu cha 3D kinachohitajika, yenye kikomo cha herufi 1024.
negative_promptsi lazima
Ainastring | null
≤ herufi 1,024
Maelezo ya vipengele vinavyopaswa kuondolewa kwenye modeli iliyozalishwa.
face_limitsi lazima
Ainainteger | null
1,000 – 2,000,000
Lengo mahususi la idadi ya nyuso kwa uzalishaji wa mesh, linalobatilisha uteuzi wa idadi unaobadilika wa modeli linapotolewa.
texturesi lazima
Ainaboolean
Chaguomsingitrue
Hudhibiti ikiwa modeli itapokea maumbo yaliyotengenezwa.
pbrsi lazima
Ainaboolean
Chaguomsingitrue
Washa nyenzo za PBR (Physically Based Rendering), ambayo pia huwasha uzalishaji wa texture ikiwa ni true.
model_seedsi lazima
Ainainteger | null
Seed inayotumika kufanya uzalishaji wa jiometri uweze kurudiwa.
image_seedsi lazima
Ainainteger | null
Seed inayotumika wakati wa hatua ya text-to-image.
texture_seedsi lazima
Ainainteger | null
Seed inayotumika kufanya uzalishaji wa texture uweze kurudiwa.
texture_qualitysi lazima
Ainaenum
Chaguomsingistandard
standarddetailed
Mpangilio wa ubora wa texture; kuchagua 'detailed' huongeza mwonekano wa texture.
geometry_qualitysi lazima
Ainaenum
Chaguomsingistandard
standarddetailed
Mpangilio wa ubora wa jiometri.
auto_sizesi lazima
Ainaboolean
Chaguomsingifalse
Upimaji wa kiotomatiki ili kuipa modeli vipimo vya ulimwengu halisi vinavyopimwa kwa mita.
quadsi lazima
Ainaboolean
Chaguomsingifalse
Chagua kati ya nyuso za pembetatu na quad zenye pande 4 kwa kuwasha topolojia ya quad. Kwa matokeo ya quad, faili la FBX hurudishwa Tripo inapotoa data kama baiti za FBX.
enable_safety_checkersi lazima
Ainaboolean
Chaguomsingitrue
Ukaguzi unaweza kulegezwa kwa kuweka false, ikiwa mpigaji simu ameidhinishwa.
inahitajika

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
model_mesh
object {url, content_type, file_name, file_size}Faili la GLB au FBX lenye modeli ya 3D iliyozalishwa, ambapo umbizo huamuliwa na kile Tripo inachozalisha.
model_urls
object {glb, fbx, base_model, pbr_model}URL zinazoelekeza kwenye matoleo mbadala ya modeli ya 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullHakikisho lililorekodiwa linaloonyesha modeli ya 3D iliyozalishwa.
task_id
string | nullKitambulisho cha kazi cha Tripo kinachoweza kutumika tena, kinachotambulisha modeli iliyozalishwa kwa rig au rig-check na kuruhusu operesheni hizo bila kupakia modeli nyingine.

Miundo zaidi: Maandishi hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/tripo3d/h3.1/text-to-3d.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt