Lompat ke konten

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"

File seperti contoh: $0,30 300 kredit API · ≈ ₽32,27 file Anda diukur sebelum dijalankan Jalankan di halaman ini

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

Generasi 3D dari satu gambar dengan material PBR, mesh quad, dan kontrol jumlah face

Tripo · 3D

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_url
Jatuhkan file, atau

URL gambar input yang digunakan untuk membuat model 3D.

texture_quality bawaan standard

Pengaturan kualitas tekstur; memilih 'detailed' meningkatkan resolusi tekstur.

geometry_quality bawaan standard

Pengaturan kualitas geometri.

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

Referensi penyelarasan tekstur: gunakan 'geometry' untuk geometri yang dibuat atau 'original_image' untuk gambar input.

orientation bawaan default

Orientasi model; 'align_image' memutarnya secara otomatis agar sesuai dengan gambar input.

Target jumlah wajah eksplisit untuk pembuatan mesh, yang menggantikan pemilihan jumlah adaptif model jika diberikan.

Seed yang digunakan agar pembuatan geometri dapat direproduksi.

Seed yang digunakan agar pembuatan tekstur dapat direproduksi.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Tripo H3.1 Image to 3D

Membangun model 3D dari satu gambar di `image_url`. Opsi mencakup `face_limit` (1,000 hingga 2,000,000), `texture`, `pbr`, `texture_quality` dan `geometry_quality` standar atau detail, topologi `quad`, `auto_size`, dan `orientation`. Hasilnya mencakup render pratinjau dan ID tugas untuk rigging berikutnya.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar input yang digunakan untuk membuat model 3D.
face_limitopsional
Tipeinteger | null
1.000 – 2.000.000
Target jumlah wajah eksplisit untuk pembuatan mesh, yang menggantikan pemilihan jumlah adaptif model jika diberikan.
textureopsional
Tipeboolean
Bawaantrue
Mengontrol apakah model menerima tekstur yang dibuat.
pbropsional
Tipeboolean
Bawaantrue
Aktifkan material PBR (Physically Based Rendering), yang juga mengaktifkan pembuatan tekstur jika bernilai true.
model_seedopsional
Tipeinteger | null
Seed yang digunakan agar pembuatan geometri dapat direproduksi.
texture_seedopsional
Tipeinteger | null
Seed yang digunakan agar pembuatan tekstur dapat direproduksi.
texture_qualityopsional
Tipeenum
Bawaanstandard
standarddetailed
Pengaturan kualitas tekstur; memilih 'detailed' meningkatkan resolusi tekstur.
geometry_qualityopsional
Tipeenum
Bawaanstandard
standarddetailed
Pengaturan kualitas geometri.
texture_alignmentopsional
Tipeenum
Bawaanoriginal_image
original_imagegeometry
Referensi penyelarasan tekstur: gunakan 'geometry' untuk geometri yang dibuat atau 'original_image' untuk gambar input.
auto_sizeopsional
Tipeboolean
Bawaanfalse
Penskalaan otomatis untuk memberikan model dimensi dunia nyata yang diukur dalam meter.
orientationopsional
Tipeenum
Bawaandefault
defaultalign_image
Orientasi model; 'align_image' memutarnya secara otomatis agar sesuai dengan gambar input.
quadopsional
Tipeboolean
Bawaanfalse
Pilih antara sisi segitiga dan quad dengan 4 sisi dengan mengaktifkan topologi quad. Untuk hasil quad, file FBX dikembalikan setiap kali Tripo menyediakan data sebagai byte FBX.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Penyaringan dapat dilonggarkan dengan menetapkan false, jika pemanggil berwenang.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
model_mesh
object {url, content_type, file_name, file_size}File GLB atau FBX yang berisi model 3D yang dibuat, dengan format ditentukan oleh hasil Tripo.
model_urls
object {glb, fbx, base_model, pbr_model}URL yang mengarah ke versi alternatif model 3D.
rendered_image
object {url, content_type, file_name, file_size} | nullPratinjau hasil render yang menampilkan model 3D yang dibuat.
task_id
string | nullID tugas Tripo yang dapat digunakan kembali untuk mengidentifikasi model yang dibuat pada rig atau rig-check, sehingga operasi tersebut dapat dilakukan tanpa mengunggah model lagi.

Model lainnya: Gambar ke 3D

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