Langkau ke kandungan

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 pada halaman ini

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

Membina semula objek 3D daripada imej, dipilih melalui teks, titik atau gesaan kotak atau topeng, dengan output splat

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

lalai car

Teks yang digunakan untuk pembahagian automatik jika topeng tiada, seperti 'chair' atau 'lamp'.

•diperlukan image_url
Lepaskan fail, atau

URL imej untuk pembinaan semula 3D.

Lanjutan mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Lepaskan fail, atau

Senarai URL topeng pilihan bagi setiap objek. Tanpa topeng, pembahagian automatik menggunakan prompt, point_prompts atau box_prompts jika dibekalkan; jika tiada topeng atau prompt pembahagian, seluruh imej digunakan.

URL pilihan untuk menambah baik anggaran kedalaman dalam pembinaan semula 3D dengan membekalkan data pointmap atau kedalaman luaran sebagai NPY atau NPZ.

Had keyakinan pengesanan, menggunakan lalai model jika tidak disertakan. Nilai berjulat dari 0.1 hingga 1.0; nilai lebih kecil mengorbankan ketepatan demi peningkatan bilangan pengesanan.

Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.

lalai []

Prompt berasaskan titik yang digunakan untuk pembahagian automatik jika topeng tiada.

lalai []

Prompt kotak yang menghasilkan topeng objek individu untuk pembinaan semula 3D melalui pembahagian automatik, digunakan hanya jika tiada topeng dibekalkan. Berbilang kotak boleh dihantar.

POST /run/sam-3/3d-objects?wait=20 sebut 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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Sam 3 · 3D Objects

Menukarkan objek dalam foto kepada aset 3D. Pilih objek dengan `mask_urls`, `prompt` teks, `point_prompts` atau `box_prompts`; berbilang kotak menghasilkan objek berasingan. `detection_threshold` menerima 0.1 hingga 1, manakala `export_textured_glb` membakar tekstur dan UV. Output merangkumi GLB, fail Gaussian splat, fail setiap objek untuk adegan berbilang objek, metadata dan himpunan zip.

Parameter

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

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej untuk pembinaan semula 3D.
mask_urlspilihan
Jenisurl[] · image
Senarai URL topeng pilihan bagi setiap objek. Tanpa topeng, pembahagian automatik menggunakan prompt, point_prompts atau box_prompts jika dibekalkan; jika tiada topeng atau prompt pembahagian, seluruh imej digunakan.
promptpilihan
Jenisstring | null
Lalaicar
Teks yang digunakan untuk pembahagian automatik jika topeng tiada, seperti 'chair' atau 'lamp'.
point_promptspilihan
Jenisobject[]
Lalai[]
Prompt berasaskan titik yang digunakan untuk pembahagian automatik jika topeng tiada.
point_prompts[].xpilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi X.
point_prompts[].ypilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi Y.
point_prompts[].labelpilihan
Jenisenum
01
Label latar depan/latar belakang: 1 menunjukkan latar depan; 0 menunjukkan latar belakang.
point_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan prompt untuk memperhalus satu objek. Jika teks juga diberikan sebagai prompt, pengecam ini menentukan objek yang dikesan untuk diperhalus oleh titik tersebut.
box_promptspilihan
Jenisobject[]
Lalai[]
Prompt kotak yang menghasilkan topeng objek individu untuk pembinaan semula 3D melalui pembahagian automatik, digunakan hanya jika tiada topeng dibekalkan. Berbilang kotak boleh dihantar.
box_prompts[].x_minpilihan
Jenisinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minpilihan
Jenisinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxpilihan
Jenisinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxpilihan
Jenisinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan kotak untuk memperhalus satu objek.
seedpilihan
Jenisinteger | null
Seed yang digunakan untuk penjanaan rawak yang boleh dihasilkan semula.
pointmap_urlpilihan
Jenisstring | null
URL pilihan untuk menambah baik anggaran kedalaman dalam pembinaan semula 3D dengan membekalkan data pointmap atau kedalaman luaran sebagai NPY atau NPZ.
detection_thresholdpilihan
Jenisnumber | null
0.1 – 1
Had keyakinan pengesanan, menggunakan lalai model jika tidak disertakan. Nilai berjulat dari 0.1 hingga 1.0; nilai lebih kecil mengorbankan ketepatan demi peningkatan bilangan pengesanan.
export_textured_glbpilihan
Jenisboolean
Lalaifalse
Pilihan eksport GLB: mendayakan pilihan ini menggantikan warna bucu dengan tekstur terpanggang dan UV.
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": "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"
  }
}
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
gaussian_splat
object {url, content_type, file_name, file_size}Splat adegan gabungan untuk hasil dengan berbilang objek, atau satu splat jika tidak; dibekalkan sebagai fail Gaussian splat dalam format .ply.
model_glb
object {url, content_type, file_name, file_size}Output 3D yang disimpan sebagai GLB: berbilang objek dipasang menjadi satu adegan, manakala hasil lain mengandungi satu mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata bagi setiap objek, termasuk putaran, terjemahan dan skala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullFail Gaussian splat berasingan bagi setiap objek, hanya tersedia dalam adegan dengan berbilang objek.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullFail mesh GLB berasingan bagi setiap objek, hanya tersedia dalam adegan dengan berbilang objek.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArkib ZIP semua artifak berserta metadata.

Lebih banyak model: Imej ke 3D

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