Preskoči na vsebino

Sam 3 · 3D Objects

Integracija

ID modela 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"

Ta zahteva: ≈0,02 $ 20 API kreditov Zaženi na tej strani

Pridobi ključ API
Meta Slika v 3D #3d#object

Rekonstruira 3D-objekte iz slike, izbrane z besedilnimi, točkovnimi ali pravokotnimi pozivi oziroma maskami, z izhodom splat

Meta · 3D

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

privzeto car

Besedilo za samodejno segmentacijo, kadar maske niso prisotne, na primer 'chair' ali 'lamp'.

•obvezno image_url
Spustite datoteko ali

URL slike za 3D-rekonstrukcijo.

Napredno mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Spustite datoteko ali

Neobvezni seznam URL-jev mask za posamezne objekte. Brez mask samodejna segmentacija uporabi poziv, point_prompts ali box_prompts, če so podani; če niso podane niti maske niti pozivi za segmentacijo, se uporabi celotna slika.

Neobvezni URL za izboljšanje ocenjevanja globine pri 3D-rekonstrukciji z zunanjimi podatki pointmap ali depth v obliki NPY ali NPZ.

Prag zaupanja zaznavanja; če je izpuščen, se uporabi privzeta vrednost modela. Vrednosti segajo od 0.1 do 1.0, pri čemer nižje vrednosti zmanjšajo natančnost in povečajo število zaznav.

Seme za ponovljivo naključno ustvarjanje.

privzeto []

Pozivi na podlagi točk za samodejno segmentacijo, kadar maske niso prisotne.

privzeto []

Pozivi z okvirji, ki z avtomatsko segmentacijo ustvarijo posamezne maske objektov za 3D-rekonstrukcijo; uporabljajo se samo, če maske niso podane. Predložite lahko več okvirjev.

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

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Sam 3 · 3D Objects

Objekte na fotografiji pretvori v 3D-sredstva. Objekte izberite z `mask_urls`, besedilnim `prompt`, `point_prompts` ali `box_prompts`; več pravokotnikov ustvari ločene objekte. `detection_threshold` sprejema vrednosti od 0.1 do 1, `export_textured_glb` pa vgradi teksturo in UV-koordinate. Izhod vključuje GLB, datoteke Gaussian splat, datoteke za posamezne objekte pri scenah z več objekti, metapodatke in paket zip.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
URL slike za 3D-rekonstrukcijo.
mask_urlsneobvezno
Vrstaurl[] · image
Neobvezni seznam URL-jev mask za posamezne objekte. Brez mask samodejna segmentacija uporabi poziv, point_prompts ali box_prompts, če so podani; če niso podane niti maske niti pozivi za segmentacijo, se uporabi celotna slika.
promptneobvezno
Vrstastring | null
Privzetocar
Besedilo za samodejno segmentacijo, kadar maske niso prisotne, na primer 'chair' ali 'lamp'.
point_promptsneobvezno
Vrstaobject[]
Privzeto[]
Pozivi na podlagi točk za samodejno segmentacijo, kadar maske niso prisotne.
point_prompts[].xneobvezno
Vrstainteger | null
Položaj poziva na osi X.
point_prompts[].yneobvezno
Vrstainteger | null
Položaj poziva na osi Y.
point_prompts[].labelneobvezno
Vrstaenum
01
Oznaka ospredja/ozadja: 1 pomeni ospredje, 0 ozadje.
point_prompts[].object_idneobvezno
Vrstainteger | null
Izbirni identifikator za združevanje pozivov, ki izboljšujejo en predmet. Če je kot poziv podano tudi besedilo, ta identifikator določi, kateri zaznani predmet te točke izboljšujejo.
box_promptsneobvezno
Vrstaobject[]
Privzeto[]
Pozivi z okvirji, ki z avtomatsko segmentacijo ustvarijo posamezne maske objektov za 3D-rekonstrukcijo; uporabljajo se samo, če maske niso podane. Predložite lahko več okvirjev.
box_prompts[].x_minneobvezno
Vrstainteger | null
Najmanjša koordinata x polja.
box_prompts[].y_minneobvezno
Vrstainteger | null
Najmanjša koordinata y polja.
box_prompts[].x_maxneobvezno
Vrstainteger | null
Največja koordinata X polja.
box_prompts[].y_maxneobvezno
Vrstainteger | null
Največja koordinata Y polja.
box_prompts[].object_idneobvezno
Vrstainteger | null
Izbirni identifikator za združevanje polj, ki izboljšujejo en predmet.
seedneobvezno
Vrstainteger | null
Seme za ponovljivo naključno ustvarjanje.
pointmap_urlneobvezno
Vrstastring | null
Neobvezni URL za izboljšanje ocenjevanja globine pri 3D-rekonstrukciji z zunanjimi podatki pointmap ali depth v obliki NPY ali NPZ.
detection_thresholdneobvezno
Vrstanumber | null
0,1 – 1
Prag zaupanja zaznavanja; če je izpuščen, se uporabi privzeta vrednost modela. Vrednosti segajo od 0.1 do 1.0, pri čemer nižje vrednosti zmanjšajo natančnost in povečajo število zaznav.
export_textured_glbneobvezno
Vrstaboolean
Privzetofalse
Izvoz GLB: vklop te možnosti nadomesti barve oglišč z vnaprej izračunano teksturo in UV-koordinatami.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
gaussian_splat
object {url, content_type, file_name, file_size}Združeni splat prizora za rezultate z več objekti oziroma en sam splat v drugih primerih; zagotovljen kot datoteka Gaussian splat v obliki .ply.
model_glb
object {url, content_type, file_name, file_size}3D-izhod, shranjen kot GLB: več objektov se sestavi v en prizor, drugi rezultati pa vsebujejo eno mrežo.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metapodatki za vsak objekt, vključno z rotacijo, premikom in merilom.
individual_splats
array of object {url, content_type, file_name, file_size} | nullLočene datoteke Gaussian splat za vsak objekt, na voljo samo v prizorih z več objekti.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullLočene datoteke mrež GLB za vsak objekt, na voljo samo v prizorih z več objekti.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArhiv ZIP z vsemi artefakti in metapodatki.

Več modelov: Slika v 3D

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/sam-3/3d-objects.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt