Langkau ke kandungan

Tripo P2 Image to 3D

Integrasikan

ID model tripo3d/p2/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.com/v1/run/tripo3d/p2/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fail seperti contoh: $1.10 1,100 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

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

Imej kepada 3D dengan PBR, topologi quad, empat tahap kualiti tekstur dan pemilihan versi tekstur

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 untuk tekstur.

Lanjutan texture_version · export_orientation · face_limit · model_seed · texture_seed · delight · auto_size · export_uv · quad · enable_safety_checker
texture_version

Versi yang digunakan untuk pemodelan tekstur. Untuk kualiti pantas, pilih v3.5-20260815; versi lain tidak disokong untuk kualiti tersebut.

export_orientation

Tetapan paksi hadapan untuk eksport model, jika dinyatakan.

Had atas muka mesh, dengan had berasingan sebanyak 25,000 untuk topologi quad.

Seed yang digunakan untuk menjadikan penjanaan geometri boleh dihasilkan semula.

Seed yang digunakan untuk menjadikan penjanaan tekstur boleh dihasilkan semula.

POST /run/tripo3d/p2/image-to-3d?wait=20 sebut harga → $1.10
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/tripo3d/p2/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.com/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 P2 Image to 3D

Menukar satu imej daripada `image_url` kepada model 3D dengan sehingga 50,000 muka (25,000 untuk jejaring quad). Kualiti tekstur boleh berupa fast, standard, detailed atau extreme, dan `texture_version` memilih model tekstur. Pilihan lain meliputi peta PBR, delighting, eksport UV, saiz automatik dan paksi hadapan eksport (`export_orientation`). Seed berasingan mengawal geometri dan tekstur.

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
48 – 50,000
Had atas muka mesh, dengan had berasingan sebanyak 25,000 untuk topologi quad.
texturepilihan
Jenisboolean
Lalaitrue
Mengawal sama ada model menerima tekstur yang dijana.
pbrpilihan
Jenisboolean
Lalaitrue
Mengawal penjanaan peta bahan PBR. Menghidupkan PBR turut mengaktifkan tekstur.
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
faststandarddetailedextreme
Tetapan kualiti untuk tekstur.
texture_versionpilihan
Jenisenum
v3.5-20260815v3.0-20250812v2.5-20250123
Versi yang digunakan untuk pemodelan tekstur. Untuk kualiti pantas, pilih v3.5-20260815; versi lain tidak disokong untuk kualiti tersebut.
delightpilihan
Jenisboolean
Lalaitrue
Pembuangan pencahayaan terbina dalam sebelum tekstur digunakan menggunakan v3.5-20260815.
auto_sizepilihan
Jenisboolean
Lalaifalse
Penskalaan automatik untuk memberikan model dimensi dunia sebenar yang diukur dalam meter.
export_uvpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada model menerima koordinat UV yang dijana.
export_orientationpilihan
Jenisenum
+x-x-y+y
Tetapan paksi hadapan untuk eksport model, jika dinyatakan.
quadpilihan
Jenisboolean
Lalaifalse
Topologi mesh menggunakan quad dan bukannya segi tiga.
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/p2/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": 1100,
    "usd": "1.10",
    "charged": 1100,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/p2/image-to-3d.md. Semua model dan panduan: https://doitong.com/developers/llms.txt