Sleppa yfir í efni

Tripo H3.1 Image to 3D

Tengja

Auðkenni líkans 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"

Skrár eins og dæmið: 0,30 $ 300 API-inneignir · ≈ 32,27 ₽ skrárnar þínar eru mældar áður en keyrt er Keyra á þessari síðu

Fá API-lykil
Tripo Mynd í 3D #3d#image-to-3d#3d-generation#tripo

Þrívíddargerð úr einni mynd með PBR-efnum, fjórhyrndum formum og stýringu á fjölda flata

Tripo · 3D

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

•áskilið image_url
Slepptu skrá eða

URL-slóð inntaksmyndar sem notuð er til að búa til 3D-líkan.

texture_quality sjálfgefið standard

Stilling fyrir áferðargæði; val á 'detailed' eykur áferðarupplausn.

geometry_quality sjálfgefið standard

Gæðastilling fyrir rúmfræðina.

Ítarlegt texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment sjálfgefið original_image

Tilvísun fyrir áferðarsamræmingu: notaðu 'geometry' fyrir myndaða rúmfræðina eða 'original_image' fyrir inntaksmyndina.

orientation sjálfgefið default

Stefna líkansins; 'align_image' snýr því sjálfkrafa til að passa við inntaksmyndina.

Skýrt mark fyrir fjölda yfirborðsflata við gerð möskva, sem tekur yfir aðlagandi val líkansins þegar það er gefið upp.

Seed-gildi sem er notað til að gera endurtekna rúmfræðigerð mögulega.

Seed-gildi sem er notað til að gera endurtekna áferðagerð mögulega.

POST /run/tripo3d/h3.1/image-to-3d?wait=20 verðtilboð → 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"

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Tripo H3.1 Image to 3D

Byggir þrívíddarlíkan úr einni mynd á `image_url`. Valkostir fela í sér `face_limit` (1,000 til 2,000,000), `texture`, `pbr`, staðlaða eða ítarlega `texture_quality` og `geometry_quality`, `quad`-formgerð, `auto_size` og `orientation`. Niðurstaðan inniheldur forskoðun og verkefnisauðkenni fyrir síðari beinagrindargerð.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
image_urláskilið image
Gerðurl · image
URL-slóð inntaksmyndar sem notuð er til að búa til 3D-líkan.
face_limitvalfrjálst
Gerðinteger | null
1.000 – 2.000.000
Skýrt mark fyrir fjölda yfirborðsflata við gerð möskva, sem tekur yfir aðlagandi val líkansins þegar það er gefið upp.
texturevalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir því hvort líkanið fái myndaðar áferðir.
pbrvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Virkjaðu PBR-efni (Physically Based Rendering), sem kveikir einnig á áferðagerð þegar gildið er true.
model_seedvalfrjálst
Gerðinteger | null
Seed-gildi sem er notað til að gera endurtekna rúmfræðigerð mögulega.
texture_seedvalfrjálst
Gerðinteger | null
Seed-gildi sem er notað til að gera endurtekna áferðagerð mögulega.
texture_qualityvalfrjálst
Gerðenum
Sjálfgefiðstandard
standarddetailed
Stilling fyrir áferðargæði; val á 'detailed' eykur áferðarupplausn.
geometry_qualityvalfrjálst
Gerðenum
Sjálfgefiðstandard
standarddetailed
Gæðastilling fyrir rúmfræðina.
texture_alignmentvalfrjálst
Gerðenum
Sjálfgefiðoriginal_image
original_imagegeometry
Tilvísun fyrir áferðarsamræmingu: notaðu 'geometry' fyrir myndaða rúmfræðina eða 'original_image' fyrir inntaksmyndina.
auto_sizevalfrjálst
Gerðboolean
Sjálfgefiðfalse
Sjálfvirk stærðarstilling sem gefur líkaninu raunverulegar stærðir mældar í metrum.
orientationvalfrjálst
Gerðenum
Sjálfgefiðdefault
defaultalign_image
Stefna líkansins; 'align_image' snýr því sjálfkrafa til að passa við inntaksmyndina.
quadvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Veldu milli þríhyrningsflata og fjórhliða flata með því að virkja quad-topology. Fyrir quad-niðurstöður er FBX-skrá skilað þegar Tripo útvegar gögnin sem FBX-bæti.
enable_safety_checkervalfrjálst
Gerðboolean
Sjálfgefiðtrue
Hægt er að slaka á skimun með því að stilla false, ef beiðandi hefur heimild.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
model_mesh
object {url, content_type, file_name, file_size}GLB- eða FBX-skrá sem inniheldur myndaða 3D-líkanið, með sniði sem ræðst af því sem Tripo framleiðir.
model_urls
object {glb, fbx, base_model, pbr_model}Vefslóðir sem vísa á aðrar útgáfur af 3D-líkaninu.
rendered_image
object {url, content_type, file_name, file_size} | nullMyndgerð forskoðun sem sýnir myndaða 3D-líkanið.
task_id
string | nullEndurnýtanlegt Tripo-task ID sem auðkennir myndaða líkanið fyrir rig eða rig-check og gerir þessar aðgerðir mögulegar án annarrar upphleðslu líkans.

Fleiri líkön: Mynd í 3D

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/tripo3d/h3.1/image-to-3d.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt