Pāriet uz saturu

Tripo H3.1 Image to 3D

Integrēt

Modeļa 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"

Faili, piemēram, paraugā: 0,30 $ 300 API kredītu · ≈ 32,27 ₽ jūsu faili tiek izmērīti pirms izpildes Izpildīt šajā lapā

Iegūt API atslēgu
Tripo Attēls uz 3D #3d#image-to-3d#3d-generation#tripo

3D ģenerēšana no viena attēla ar PBR materiāliem, četrstūru tīkliem un skaldņu skaita vadību

Tripo · 3D

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts image_url
Nometiet failu vai

Ievades attēla URL 3D modeļa izveidei.

texture_quality noklusējums standard

Tekstūras kvalitātes iestatījums; izvēloties 'detailed', tiek palielināta tekstūras izšķirtspēja.

geometry_quality noklusējums standard

Ģeometrijas kvalitātes iestatījums.

Papildu texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment noklusējums original_image

Tekstūras izlīdzināšanas atsauce: izmantojiet 'geometry' ģenerētajai ģeometrijai vai 'original_image' ievades attēlam.

orientation noklusējums default

Modeļa orientācija; 'align_image' to automātiski pagriež, lai tā atbilstu ievades attēlam.

Tieši norādīts skaldņu skaita mērķis režģa ģenerēšanai, kas ignorē modeļa adaptīvo skaita izvēli, ja tas tiek nodrošināts.

Sēkla, ko izmanto reproducējamai ģeometrijas ģenerēšanai.

Sēkla, ko izmanto reproducējamai tekstūru ģenerēšanai.

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

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Tripo H3.1 Image to 3D

Izveido 3D modeli no viena attēla vietnē `image_url`. Opcijas ietver `face_limit` (1,000 līdz 2,000,000), `texture`, `pbr`, standarta vai detalizētu `texture_quality` un `geometry_quality`, četrstūru topoloģiju `quad`, `auto_size` un `orientation`. Rezultātā ir priekšskatījuma renderējums un uzdevuma ID vēlākai rigēšanai.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlobligāts image
Tipsurl · image
Ievades attēla URL 3D modeļa izveidei.
face_limitneobligāts
Tipsinteger | null
1000 – 2 000 000
Tieši norādīts skaldņu skaita mērķis režģa ģenerēšanai, kas ignorē modeļa adaptīvo skaita izvēli, ja tas tiek nodrošināts.
textureneobligāts
Tipsboolean
Noklusējumstrue
Nosaka, vai modelis saņem ģenerētas tekstūras.
pbrneobligāts
Tipsboolean
Noklusējumstrue
Iespējo PBR materiālus (Physically Based Rendering), kas, ja iestatīts true, ieslēdz arī tekstūru ģenerēšanu.
model_seedneobligāts
Tipsinteger | null
Sēkla, ko izmanto reproducējamai ģeometrijas ģenerēšanai.
texture_seedneobligāts
Tipsinteger | null
Sēkla, ko izmanto reproducējamai tekstūru ģenerēšanai.
texture_qualityneobligāts
Tipsenum
Noklusējumsstandard
standarddetailed
Tekstūras kvalitātes iestatījums; izvēloties 'detailed', tiek palielināta tekstūras izšķirtspēja.
geometry_qualityneobligāts
Tipsenum
Noklusējumsstandard
standarddetailed
Ģeometrijas kvalitātes iestatījums.
texture_alignmentneobligāts
Tipsenum
Noklusējumsoriginal_image
original_imagegeometry
Tekstūras izlīdzināšanas atsauce: izmantojiet 'geometry' ģenerētajai ģeometrijai vai 'original_image' ievades attēlam.
auto_sizeneobligāts
Tipsboolean
Noklusējumsfalse
Automātiska mērogošana, lai modelim piešķirtu metros mērītus reālās pasaules izmērus.
orientationneobligāts
Tipsenum
Noklusējumsdefault
defaultalign_image
Modeļa orientācija; 'align_image' to automātiski pagriež, lai tā atbilstu ievades attēlam.
quadneobligāts
Tipsboolean
Noklusējumsfalse
Izvēlieties starp trijstūra skaldnēm un četrstūriem, iespējojot četrstūru topoloģiju. Četrstūru rezultātiem tiek atgriezts FBX fails, kad Tripo piegādā datus FBX baitos.
enable_safety_checkerneobligāts
Tipsboolean
Noklusējumstrue
Pārbaudi var atslābināt, iestatot false, ja izsaucējam ir atļauja.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
model_mesh
object {url, content_type, file_name, file_size}GLB vai FBX fails ar ģenerēto 3D modeli; formātu nosaka tas, ko izveido Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL, kas norāda uz alternatīvām 3D modeļa versijām.
rendered_image
object {url, content_type, file_name, file_size} | nullRenderēts priekšskatījums ar ģenerēto 3D modeli.
task_id
string | nullAtkārtoti izmantojams Tripo uzdevuma ID, kas identificē ģenerēto modeli rig vai rig-check darbībām un ļauj tās veikt bez atkārtotas modeļa augšupielādes.

Vairāk modeļu: Attēls uz 3D

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/tripo3d/h3.1/image-to-3d.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt