Lompat ke konten

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"

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

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

Gambar-ke-3D (v2.5) dengan prasetel gaya, tekstur HD, output quad, dan opsi penyelarasan

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 yang digunakan untuk membuat model.

texture bawaan standard

Pengaturan tekstur untuk model: 'standard' adalah bawaan, 'no' menonaktifkan tekstur, dan 'HD' menghasilkan tekstur definisi tinggi.

Pengaturan gaya; biarkan tidak ditentukan untuk mempertahankan tampilan dan gaya asli.

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

Pengaturan prioritas penyelarasan tekstur untuk model 3D, menggunakan original_image kecuali nilai lain diberikan.

orientation bawaan default

Orientasi model, yang awalnya diatur ke `default`. Pilih `align_image` untuk memutar model secara otomatis agar selaras dengan gambar asli.

Batas jumlah sisi output, dipilih secara adaptif kecuali Anda memberikan batas eksplisit.

Seed bilangan bulat yang mengontrol pembuatan geometri; menggunakannya kembali akan menghasilkan model yang identik. Nilai acak dipilih jika dihilangkan.

Seed pembuatan tekstur, diberikan sebagai bilangan bulat atau dipilih secara acak jika dihilangkan. Nilai seed yang identik menghasilkan tekstur yang sama; untuk mengubah tekstur model, ubah texture_seed sambil mempertahankan seed model.

POST /run/tripo3d/tripo/v2.5/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/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

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 Tripo3D · Image to 3D

Menghasilkan model 3D dari satu `image_url`. `texture` dapat berupa no, standard, atau HD, dengan output PBR opsional. Prasetel `style` seperti clay, steampunk, gold, atau ancient bronze dapat mengubah gaya hasil. Kontrol lainnya mencakup `face_limit`, `quad` (memaksa FBX), `auto_size`, `texture_alignment`, dan `orientation` untuk menyelaraskan model dengan gambar.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
seedopsional
Tipeinteger | null
Seed bilangan bulat yang mengontrol pembuatan geometri; menggunakannya kembali akan menghasilkan model yang identik. Nilai acak dipilih jika dihilangkan.
face_limitopsional
Tipeinteger | null
Batas jumlah sisi output, dipilih secara adaptif kecuali Anda memberikan batas eksplisit.
pbropsional
Tipeboolean | null
Bawaanfalse
Sakelar PBR: False menghasilkan model tanpa PBR, sedangkan True mengesampingkan pengaturan tekstur dan memperlakukannya sebagai True. PBR diaktifkan secara bawaan.
textureopsional
Tipeenum
Bawaanstandard
nostandardHD
Pengaturan tekstur untuk model: 'standard' adalah bawaan, 'no' menonaktifkan tekstur, dan 'HD' menghasilkan tekstur definisi tinggi.
texture_seedopsional
Tipeinteger | null
Seed pembuatan tekstur, diberikan sebagai bilangan bulat atau dipilih secara acak jika dihilangkan. Nilai seed yang identik menghasilkan tekstur yang sama; untuk mengubah tekstur model, ubah texture_seed sambil mempertahankan seed model.
auto_sizeopsional
Tipeboolean | null
Bawaanfalse
Sakelar ukuran dunia nyata, dinonaktifkan secara bawaan (False), yang secara otomatis menyesuaikan dimensi model menggunakan meter.
styleopsional
Tipeenum
person:person2cartoonobject:clayobject:steampunkanimal:venomobject:barbieobject:christmasgoldancient_bronze
Pengaturan gaya; biarkan tidak ditentukan untuk mempertahankan tampilan dan gaya asli.
quadopsional
Tipeboolean | null
Bawaanfalse
Mode quad memaksa output FBX saat diaktifkan. Dengan quad=True dan face_limit yang tidak ditentukan, face_limit bernilai bawaan 10000.
texture_alignmentopsional
Tipeenum
Bawaanoriginal_image
original_imagegeometry
Pengaturan prioritas penyelarasan tekstur untuk model 3D, menggunakan original_image kecuali nilai lain diberikan.
orientationopsional
Tipeenum
Bawaandefault
defaultalign_image
Orientasi model, yang awalnya diatur ke `default`. Pilih `align_image` untuk memutar model secara otomatis agar selaras dengan gambar asli.
image_urlwajib image
Tipeurl · image
URL gambar yang digunakan untuk membuat model.
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/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"
  }
}
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
task_id
stringPengenal tugas untuk membuat 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 dasar.
pbr_model
object {url, content_type, file_name, file_size} | nullOutput model PBR.
rendered_image
object {url, content_type, file_name, file_size} | nullGambar yang menampilkan pratinjau model.

Model lainnya: Gambar ke 3D

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