Langkau ke kandungan

Tripo H3.1 Image to 3D

Integrasikan

ID model 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"

Fail seperti contoh: $0.30 300 kredit API · ≈ ₽32.27 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Tripo Imej ke 3D #3d#image-to-3d#3d-generation#tripo

Penjanaan 3D imej tunggal dengan bahan PBR, jejaring segi empat dan kawalan bilangan muka

Tripo · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL imej input yang digunakan untuk mencipta model 3D.

texture_quality lalai standard

Tetapan kualiti tekstur; memilih 'detailed' meningkatkan resolusi tekstur.

geometry_quality lalai standard

Tetapan kualiti untuk geometri.

Lanjutan texture_alignment · orientation · face_limit · model_seed · texture_seed · auto_size · enable_safety_checker
texture_alignment lalai original_image

Rujukan penjajaran tekstur: gunakan 'geometry' untuk geometri yang dijana atau 'original_image' untuk imej input.

orientation lalai default

Orientasi model; 'align_image' memutarkannya secara automatik agar sepadan dengan imej input.

Sasaran bilangan muka khusus untuk penjanaan mesh, mengatasi pemilihan bilangan adaptif model apabila diberikan.

Seed yang digunakan untuk menjadikan penjanaan geometri boleh dihasilkan semula.

Seed yang digunakan untuk menjadikan penjanaan tekstur boleh dihasilkan semula.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Tripo H3.1 Image to 3D

Membina model 3D daripada satu imej di `image_url`. Pilihan termasuk `face_limit` (1,000 hingga 2,000,000), `texture`, `pbr`, `texture_quality` dan `geometry_quality` standard atau terperinci, topologi `quad`, `auto_size` dan `orientation`. Hasilnya termasuk pemaparan pratonton dan ID tugas untuk rigging kemudian.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej input yang digunakan untuk mencipta model 3D.
face_limitpilihan
Jenisinteger | null
1,000 – 2,000,000
Sasaran bilangan muka khusus untuk penjanaan mesh, mengatasi pemilihan bilangan adaptif model apabila diberikan.
texturepilihan
Jenisboolean
Lalaitrue
Mengawal sama ada model menerima tekstur yang dijana.
pbrpilihan
Jenisboolean
Lalaitrue
Dayakan bahan PBR (Physically Based Rendering), yang turut menghidupkan penjanaan tekstur apabila bernilai true.
model_seedpilihan
Jenisinteger | null
Seed yang digunakan untuk menjadikan penjanaan geometri boleh dihasilkan semula.
texture_seedpilihan
Jenisinteger | null
Seed yang digunakan untuk menjadikan penjanaan tekstur boleh dihasilkan semula.
texture_qualitypilihan
Jenisenum
Lalaistandard
standarddetailed
Tetapan kualiti tekstur; memilih 'detailed' meningkatkan resolusi tekstur.
geometry_qualitypilihan
Jenisenum
Lalaistandard
standarddetailed
Tetapan kualiti untuk geometri.
texture_alignmentpilihan
Jenisenum
Lalaioriginal_image
original_imagegeometry
Rujukan penjajaran tekstur: gunakan 'geometry' untuk geometri yang dijana atau 'original_image' untuk imej input.
auto_sizepilihan
Jenisboolean
Lalaifalse
Penskalaan automatik untuk memberikan model dimensi dunia sebenar yang diukur dalam meter.
orientationpilihan
Jenisenum
Lalaidefault
defaultalign_image
Orientasi model; 'align_image' memutarkannya secara automatik agar sepadan dengan imej input.
quadpilihan
Jenisboolean
Lalaifalse
Pilih antara muka segi tiga dan segi empat dengan mendayakan topologi quad. Untuk hasil quad, fail FBX dikembalikan apabila Tripo membekalkan data sebagai bait FBX.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_mesh
object {url, content_type, file_name, file_size}Fail GLB atau FBX yang mengandungi model 3D yang dijana, dengan format ditentukan oleh hasil keluaran Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL yang menunjuk kepada versi alternatif model 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullPratonton yang dirender untuk menunjukkan model 3D yang dijana.
task_id
string | nullID tugas Tripo yang boleh digunakan semula untuk mengenal pasti model yang dijana bagi rig atau rig-check, membolehkan operasi tersebut tanpa memuat naik model sekali lagi.

Lebih banyak model: Imej ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/tripo3d/h3.1/image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt