Lompat ke konten

Sam 3 · 3D Objects

Integrasikan

ID model sam-3/3d-objects
# 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/sam-3/3d-objects?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"

Permintaan ini: ≈$0,02 20 kredit API Jalankan di halaman ini

Dapatkan kunci API
Meta Gambar ke 3D #3d#object

Merekonstruksi objek 3D dari gambar yang dipilih melalui prompt teks, titik, kotak, atau mask, dengan output splat

Meta · 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.

bawaan car

Teks yang digunakan untuk segmentasi otomatis jika mask tidak ada, seperti 'chair' atau 'lamp'.

•wajib image_url
Jatuhkan file, atau

URL gambar untuk rekonstruksi 3D.

Lanjutan mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Jatuhkan file, atau

Daftar URL mask per objek opsional. Tanpa mask, segmentasi otomatis menggunakan prompt, point_prompts, atau box_prompts jika diberikan; jika mask maupun prompt segmentasi tidak diberikan, seluruh gambar digunakan.

URL opsional untuk meningkatkan estimasi kedalaman dalam rekonstruksi 3D dengan menyediakan data pointmap atau kedalaman eksternal sebagai NPY atau NPZ.

Batas skor keyakinan deteksi, menggunakan bawaan model jika dihilangkan. Nilainya berkisar dari 0.1 hingga 1.0; nilai yang lebih kecil menukar presisi dengan peningkatan jumlah deteksi.

Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.

bawaan []

Prompt berbasis titik yang digunakan untuk segmentasi otomatis jika mask tidak ada.

bawaan []

Prompt kotak yang menghasilkan mask objek individual untuk rekonstruksi 3D melalui segmentasi otomatis, hanya digunakan jika tidak ada mask. Beberapa kotak dapat dikirimkan.

POST /run/sam-3/3d-objects?wait=20 estimasi harga → $0,02
# 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/sam-3/3d-objects?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

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 Sam 3 · 3D Objects

Mengubah objek dalam foto menjadi aset 3D. Pilih objek dengan `mask_urls`, `prompt` teks, `point_prompts`, atau `box_prompts`; beberapa kotak menghasilkan objek terpisah. `detection_threshold` menerima 0.1 hingga 1, dan `export_textured_glb` menyertakan tekstur serta UV. Output mencakup GLB, file Gaussian splat, file per objek untuk adegan multiobjek, metadata, dan bundel zip.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar untuk rekonstruksi 3D.
mask_urlsopsional
Tipeurl[] · image
Daftar URL mask per objek opsional. Tanpa mask, segmentasi otomatis menggunakan prompt, point_prompts, atau box_prompts jika diberikan; jika mask maupun prompt segmentasi tidak diberikan, seluruh gambar digunakan.
promptopsional
Tipestring | null
Bawaancar
Teks yang digunakan untuk segmentasi otomatis jika mask tidak ada, seperti 'chair' atau 'lamp'.
point_promptsopsional
Tipeobject[]
Bawaan[]
Prompt berbasis titik yang digunakan untuk segmentasi otomatis jika mask tidak ada.
point_prompts[].xopsional
Tipeinteger | null
Posisi prompt pada sumbu X.
point_prompts[].yopsional
Tipeinteger | null
Posisi prompt pada sumbu Y.
point_prompts[].labelopsional
Tipeenum
01
Label foreground/background: 1 menunjukkan foreground; 0 menunjukkan background.
point_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan prompt untuk menyempurnakan satu objek. Jika teks juga diberikan sebagai prompt, pengenal ini menentukan objek terdeteksi mana yang disempurnakan oleh titik tersebut.
box_promptsopsional
Tipeobject[]
Bawaan[]
Prompt kotak yang menghasilkan mask objek individual untuk rekonstruksi 3D melalui segmentasi otomatis, hanya digunakan jika tidak ada mask. Beberapa kotak dapat dikirimkan.
box_prompts[].x_minopsional
Tipeinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minopsional
Tipeinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxopsional
Tipeinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxopsional
Tipeinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan kotak untuk menyempurnakan satu objek.
seedopsional
Tipeinteger | null
Seed yang digunakan untuk pembuatan acak yang dapat direproduksi.
pointmap_urlopsional
Tipestring | null
URL opsional untuk meningkatkan estimasi kedalaman dalam rekonstruksi 3D dengan menyediakan data pointmap atau kedalaman eksternal sebagai NPY atau NPZ.
detection_thresholdopsional
Tipenumber | null
0,1 – 1
Batas skor keyakinan deteksi, menggunakan bawaan model jika dihilangkan. Nilainya berkisar dari 0.1 hingga 1.0; nilai yang lebih kecil menukar presisi dengan peningkatan jumlah deteksi.
export_textured_glbopsional
Tipeboolean
Bawaanfalse
Pilihan ekspor GLB: mengaktifkan opsi ini mengganti warna vertex dengan tekstur dan UV yang telah di-bake.
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": "sam-3/3d-objects",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "gaussian_splat": {
      "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_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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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
gaussian_splat
object {url, content_type, file_name, file_size}Splat scene gabungan untuk hasil dengan beberapa objek, atau satu splat jika tidak ada; diberikan sebagai file Gaussian splat dalam format .ply.
model_glb
object {url, content_type, file_name, file_size}Output 3D yang disimpan sebagai GLB: beberapa objek dirakit menjadi satu scene, sedangkan hasil lainnya berisi satu mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata untuk setiap objek, termasuk rotasi, translasi, dan skala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullFile Gaussian splat terpisah untuk setiap objek, hanya tersedia dalam scene dengan beberapa objek.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullFile mesh GLB terpisah untuk setiap objek, hanya tersedia dalam scene dengan beberapa objek.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArsip ZIP yang berisi semua artefak beserta metadata.

Model lainnya: Gambar ke 3D

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