Langkau ke kandungan

Tripo3D · Image to 3D

Integrasikan

ID model tripo3d/tripo/v2.5/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/tripo/v2.5/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.19 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
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 yang digunakan untuk menjana model.

texture lalai standard

Tetapan tekstur untuk model: 'standard' ialah lalai, 'no' melumpuhkan tekstur, dan 'HD' menghasilkan tekstur definisi tinggi.

Tetapan gaya; biarkan tidak dinyatakan untuk mengekalkan penampilan dan gaya asal.

Lanjutan texture_alignment · orientation · face_limit · seed · texture_seed · pbr · auto_size
texture_alignment lalai original_image

Tetapan keutamaan penjajaran tekstur untuk model 3D, menggunakan original_image melainkan nilai lain dibekalkan.

orientation lalai default

Orientasi model, pada mulanya ditetapkan kepada `default`. Pilih `align_image` untuk memutarkan model secara automatik agar sejajar dengan imej asal.

Had bilangan muka output, dipilih secara adaptif melainkan anda membekalkan had khusus.

Seed integer yang mengawal penjanaan geometri; menggunakannya semula menghasilkan model yang sama. Nilai rawak dipilih jika tidak dinyatakan.

Seed penjanaan tekstur, dibekalkan sebagai integer atau dipilih secara rawak jika tidak dinyatakan. Nilai seed yang sama menghasilkan semula tekstur; untuk mengubah tekstur model, ubah texture_seed sambil mengekalkan seed model.

POST /run/tripo3d/tripo/v2.5/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/tripo/v2.5/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 Tripo3D · Image to 3D

Menjana model 3D daripada satu `image_url`. `texture` boleh ditetapkan kepada no, standard atau HD, dengan output PBR pilihan. Pratetap `style` seperti clay, steampunk, gold atau ancient bronze boleh mengubah gaya hasil. Kawalan lain termasuk `face_limit`, `quad` (memaksa FBX), `auto_size`, `texture_alignment` dan `orientation` untuk menjajarkan model dengan imej.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
seedpilihan
Jenisinteger | null
Seed integer yang mengawal penjanaan geometri; menggunakannya semula menghasilkan model yang sama. Nilai rawak dipilih jika tidak dinyatakan.
face_limitpilihan
Jenisinteger | null
Had bilangan muka output, dipilih secara adaptif melainkan anda membekalkan had khusus.
pbrpilihan
Jenisboolean | null
Lalaifalse
Suis PBR: False menghasilkan model tanpa PBR, manakala True mengatasi tetapan tekstur dan menganggapnya sebagai True. PBR didayakan secara lalai.
texturepilihan
Jenisenum
Lalaistandard
nostandardHD
Tetapan tekstur untuk model: 'standard' ialah lalai, 'no' melumpuhkan tekstur, dan 'HD' menghasilkan tekstur definisi tinggi.
texture_seedpilihan
Jenisinteger | null
Seed penjanaan tekstur, dibekalkan sebagai integer atau dipilih secara rawak jika tidak dinyatakan. Nilai seed yang sama menghasilkan semula tekstur; untuk mengubah tekstur model, ubah texture_seed sambil mengekalkan seed model.
auto_sizepilihan
Jenisboolean | null
Lalaifalse
Suis pensaizaan dunia sebenar, dilumpuhkan secara lalai (False), yang melaraskan dimensi model secara automatik menggunakan meter.
stylepilihan
Jenisenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Tetapan gaya; biarkan tidak dinyatakan untuk mengekalkan penampilan dan gaya asal.
quadpilihan
Jenisboolean | null
Lalaifalse
Mod quad memaksa output FBX apabila didayakan. Dengan quad=True dan face_limit tidak dinyatakan, face_limit lalai ialah 10000.
texture_alignmentpilihan
Jenisenum
Lalaioriginal_image
original_imagegeometry
Tetapan keutamaan penjajaran tekstur untuk model 3D, menggunakan original_image melainkan nilai lain dibekalkan.
orientationpilihan
Jenisenum
Lalaidefault
defaultalign_image
Orientasi model, pada mulanya ditetapkan kepada `default`. Pilih `align_image` untuk memutarkan model secara automatik agar sejajar dengan imej asal.
image_urldiperlukan image
Jenisurl · image
URL imej yang digunakan untuk menjana model.
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/tripo/v2.5/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": {
    "task_id": "string",
    "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
    },
    "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
    }
  },
  "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
task_id
stringPengecam tugas untuk menjana model 3D.
model_mesh
object {url, content_type, file_name, file_size} | nullOutput model.
base_model
object {url, content_type, file_name, file_size} | nullOutput model asas.
pbr_model
object {url, content_type, file_name, file_size} | nullOutput model PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullImej yang menunjukkan pratonton model.

Lebih banyak model: Imej ke 3D

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