Siirry sisältöön

Sam 3 · 3D Objects

Integroi

Mallin tunniste 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"

Tämä pyyntö: ≈0,02 $ 20 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Meta Kuvasta 3D:ksi #3d#object

Rekonstruoi kuvasta 3D-objekteja, jotka valitaan teksti-, piste- tai laatikkokehotteilla tai maskeilla, ja tuottaa splat-tulosteen

Meta · 3D

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

oletus car

Automaattisessa segmentoinnissa käytettävä teksti, jos maskeja ei ole, kuten 'chair' tai 'lamp'.

•pakollinen image_url
Pudota tiedosto tai

3D-rekonstruktion lähdekuvan URL-osoite.

Lisäasetukset mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Pudota tiedosto tai

Valinnainen luettelo objektikohtaisten maskien URL-osoitteista. Ilman maskeja automaattinen segmentointi käyttää parametreja kehote, point_prompts tai box_prompts, jos ne on annettu. Jos maskeja tai segmentointikehotteita ei ole annettu, käytetään koko kuvaa.

Valinnainen URL-osoite syvyysarvioinnin parantamiseen 3D-rekonstruktiossa toimittamalla ulkoisia pointmap- tai syvyystietoja NPY- tai NPZ-muodossa.

Tunnistuksen luottamuskynnys, joka jätetään mallin oletusarvoon, jos se jätetään pois. Arvot ovat välillä 0.1–1.0; pienemmät arvot vaihtavat tarkkuutta suurempaan tunnistusmäärään.

Toistettavaan satunnaisgenerointiin käytetty siemen.

oletus []

Pisteisiin perustuvat kehotteet automaattiseen segmentointiin, jos maskeja ei ole.

oletus []

Laatikkokehotteet, jotka tuottavat yksittäiset kohdemaskit 3D-rekonstruktiota varten automaattisella segmentoinnilla; niitä käytetään vain, jos maskeja ei toimiteta. Lähetettävissä on useita laatikoita.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Sam 3 · 3D Objects

Muuntaa kuvan objektit 3D-resursseiksi. Valitse objektit parametrilla `mask_urls`, tekstillä `prompt`, parametreilla `point_prompts` tai `box_prompts`; useat laatikot tuottavat erilliset objektit. `detection_threshold` hyväksyy arvot 0.1–1, ja `export_textured_glb` upottaa tekstuurin ja UV-koordinaatit. Tulosteisiin kuuluvat GLB, Gaussian splat -tiedostot, objektikohtaiset tiedostot usean objektin kohtauksissa, metatiedot ja zip-paketti.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
3D-rekonstruktion lähdekuvan URL-osoite.
mask_urlsvalinnainen
Tyyppiurl[] · image
Valinnainen luettelo objektikohtaisten maskien URL-osoitteista. Ilman maskeja automaattinen segmentointi käyttää parametreja kehote, point_prompts tai box_prompts, jos ne on annettu. Jos maskeja tai segmentointikehotteita ei ole annettu, käytetään koko kuvaa.
promptvalinnainen
Tyyppistring | null
Oletuscar
Automaattisessa segmentoinnissa käytettävä teksti, jos maskeja ei ole, kuten 'chair' tai 'lamp'.
point_promptsvalinnainen
Tyyppiobject[]
Oletus[]
Pisteisiin perustuvat kehotteet automaattiseen segmentointiin, jos maskeja ei ole.
point_prompts[].xvalinnainen
Tyyppiinteger | null
Kehotteen sijainti X-akselilla.
point_prompts[].yvalinnainen
Tyyppiinteger | null
Kehotteen sijainti Y-akselilla.
point_prompts[].labelvalinnainen
Tyyppienum
01
Etuala-/taustatunniste: 1 tarkoittaa etualaa ja 0 taustaa.
point_prompts[].object_idvalinnainen
Tyyppiinteger | null
Valinnainen tunniste, joka ryhmittelee yhtä objektia tarkentavat kehotteet. Jos kehote toimitetaan myös tekstinä, tämä tunniste määrittää, minkä havaitun objektin pisteitä tarkennetaan.
box_promptsvalinnainen
Tyyppiobject[]
Oletus[]
Laatikkokehotteet, jotka tuottavat yksittäiset kohdemaskit 3D-rekonstruktiota varten automaattisella segmentoinnilla; niitä käytetään vain, jos maskeja ei toimiteta. Lähetettävissä on useita laatikoita.
box_prompts[].x_minvalinnainen
Tyyppiinteger | null
Laatikon x-koordinaatin vähimmäisarvo.
box_prompts[].y_minvalinnainen
Tyyppiinteger | null
Laatikon y-koordinaatin vähimmäisarvo.
box_prompts[].x_maxvalinnainen
Tyyppiinteger | null
Laatikon suurin X-koordinaatti.
box_prompts[].y_maxvalinnainen
Tyyppiinteger | null
Laatikon suurin Y-koordinaatti.
box_prompts[].object_idvalinnainen
Tyyppiinteger | null
Valinnainen tunniste yhtä objektia tarkentavien laatikoiden ryhmittelyyn.
seedvalinnainen
Tyyppiinteger | null
Toistettavaan satunnaisgenerointiin käytetty siemen.
pointmap_urlvalinnainen
Tyyppistring | null
Valinnainen URL-osoite syvyysarvioinnin parantamiseen 3D-rekonstruktiossa toimittamalla ulkoisia pointmap- tai syvyystietoja NPY- tai NPZ-muodossa.
detection_thresholdvalinnainen
Tyyppinumber | null
0,1 – 1
Tunnistuksen luottamuskynnys, joka jätetään mallin oletusarvoon, jos se jätetään pois. Arvot ovat välillä 0.1–1.0; pienemmät arvot vaihtavat tarkkuutta suurempaan tunnistusmäärään.
export_textured_glbvalinnainen
Tyyppiboolean
Oletusfalse
GLB-vientiasetus: tämän vaihtoehdon käyttöönotto korvaa kärkipisteiden värit leivotulla tekstuurilla ja UV-koordinaateilla.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
gaussian_splat
object {url, content_type, file_name, file_size}Useita kohteita sisältävien tulosten yhdistetty splat tai muuten yksittäinen splat; toimitetaan Gaussian splat -tiedostona .ply-muodossa.
model_glb
object {url, content_type, file_name, file_size}GLB-muotoon tallennettu 3D-tuloste: useat kohteet kootaan yhdeksi näkymäksi, kun taas muut tulokset sisältävät yhden verkon.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Kunkin kohteen metatiedot, mukaan lukien kierto, siirto ja skaalaus.
individual_splats
array of object {url, content_type, file_name, file_size} | nullErilliset Gaussian splat -tiedostot kullekin kohteelle, saatavilla vain useita kohteita sisältävissä näkymissä.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullErilliset GLB-verkkotiedostot kullekin kohteelle, saatavilla vain useita kohteita sisältävissä näkymissä.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-arkisto kaikista artefakteista ja metatiedoista.

Lisää malleja: Kuvasta 3D:ksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/sam-3/3d-objects.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt