Njuolgga sisdollui

Sam 3 · 3D Objects

Integrere

Modealla-id 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"

Dát ohcamuš: ≈0,02 $ 20 API-kreditta Vuodje dán siiddu alde

Oza API-čoavdaga
Meta Govas 3D #3d#object

Ráhkada 3D-objekttaid govvagovas, válljejuvvon teaksta-, čáhken- dahje kássapromptaiguin dahje maskkuiguin, splat-outputain

Meta · 3D

Dát lea du vuosttaš bohtos

Daga jearaldaga vuolábealde ja vuodje dan iežat API-čoavddain. Boađusat kopierejuvvojit min vurkemii, bisuhuvvojit álo dahje 7 beaivvi nuvttá.

Ráhkat jearaldaga

Kontrollat ráhkaduvvojit modealla skeama vuođul. Koda ja haddi ođasmahttojuvvojit go rievddadat daid.

standárda car

Teaksta automáhtalaš segmenteremii go maskkat eai leat, nugo 'chair' dahje 'lamp'.

•gáibiduvvo image_url
Luoitte fiilla, dahje

Gova URL 3D-ođasmahttimii.

Viiddiduvvon mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Luoitte fiilla, dahje

Vejolaš objeaktaid maska-URL-listu. Jus maskkat eai leat, automáhtalaš segmenteren geavaha bivdda, point_prompts dahje box_prompts jus dat leat addon; jus iige maskkat iige segmenterenbivdagat leat addon, geavahuvvo olles govva.

Vejolaš URL, mii buorida 3D-ođasmahttima čikŋaárvvoštallama eksternalaš pointmap- dahje čikŋadáhtáin NPY- dahje NPZ-formáhtas.

Gávnnusduođaštusčuozahus, mii báhcá modealla standárdii jus ii leat addon. Árvvut leat 0.1 rájes 1.0 rádjái; unnit árvvut lonuhit dárkilvuođa eanet gávnnusiid ovddas.

Sieda geardduhahtti sluččadan ráhkadeapmái.

standárda []

Čuokkisbivdagat automáhtalaš segmenteremii go maskkat eai leat.

standárda []

Box-bivdagat, mat ráhkadit sierra objeaktamaskkaid 3D-ođasmahttimii automáhtalaš segmenteremiin; geavahuvvojit dušše go maskkat eai leat addon. Máŋga boxa sáhttá sáddet.

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

Geavat dán ohcamuša

Du key báhcá dán fierpmádatlogan: dat sáddejuvvo dušše Doitong API:ii ja vurkejuvvo (localStorage) dušše jos válljet Remember. Viečča API-keya

Dát lea Sam 3 · 3D Objects birra

Rievdá govvagova objekttaid 3D-assetsin. Vállje objekttaid `mask_urls`, teaksta-`prompt`, `point_prompts` dahje `box_prompts` bokte; máŋga kássa addet sierra objekttaid. `detection_threshold` dohkkeha 0.1 gitta 1 rádjái, ja `export_textured_glb` čáhkká tekstuvrra ja UV:t. Outputain leat GLB, Gaussian-splat-fiillat, objektaid sierra fiillat máŋggaobjekta-sceneain, metadata ja zip-páhka.

Parametterat

Sádde kanonala nama dahje iežas nama, ii goappašiid. Kanonala namat

NammaŠládja StandárdaDohkkehuvvon Govvádus
image_urlgáibiduvvo image
Šládjaurl · image
Gova URL 3D-ođasmahttimii.
mask_urlseaktodáhtolaš
Šládjaurl[] · image
Vejolaš objeaktaid maska-URL-listu. Jus maskkat eai leat, automáhtalaš segmenteren geavaha bivdda, point_prompts dahje box_prompts jus dat leat addon; jus iige maskkat iige segmenterenbivdagat leat addon, geavahuvvo olles govva.
prompteaktodáhtolaš
Šládjastring | null
Standárdacar
Teaksta automáhtalaš segmenteremii go maskkat eai leat, nugo 'chair' dahje 'lamp'.
point_promptseaktodáhtolaš
Šládjaobject[]
Standárda[]
Čuokkisbivdagat automáhtalaš segmenteremii go maskkat eai leat.
point_prompts[].xeaktodáhtolaš
Šládjainteger | null
Bivdda sajádat X-aksis.
point_prompts[].yeaktodáhtolaš
Šládjainteger | null
Bivdda sajádat Y-aksis.
point_prompts[].labeleaktodáhtolaš
Šládjaenum
01
Ovdal/duogáš-láiggi: 1 čájeha ovdalguovllu; 0 čájeha duogáža.
point_prompts[].object_ideaktodáhtolaš
Šládjainteger | null
Eaktodáhtolaš identifikahtor mii joavkasta bivddaid ovtta ášši dárkilastimii. Jos teaksta maid addojuvvo bivdan, mearrida dát identifikahtor makkár gávnnahuvvon ášši čuoggát dárkilastet.
box_promptseaktodáhtolaš
Šládjaobject[]
Standárda[]
Box-bivdagat, mat ráhkadit sierra objeaktamaskkaid 3D-ođasmahttimii automáhtalaš segmenteremiin; geavahuvvojit dušše go maskkat eai leat addon. Máŋga boxa sáhttá sáddet.
box_prompts[].x_mineaktodáhtolaš
Šládjainteger | null
Boxa unnimus x-koordináhta.
box_prompts[].y_mineaktodáhtolaš
Šládjainteger | null
Boxa unnimus y-koordináhta.
box_prompts[].x_maxeaktodáhtolaš
Šládjainteger | null
Láhtte bajimus X-koordináhta.
box_prompts[].y_maxeaktodáhtolaš
Šládjainteger | null
Láhtte bajimus Y-koordináhta.
box_prompts[].object_ideaktodáhtolaš
Šládjainteger | null
Eaktodáhtolaš identifikahtor mii joavkasta láhttega ovtta ášši dárkilastimii.
seedeaktodáhtolaš
Šládjainteger | null
Sieda geardduhahtti sluččadan ráhkadeapmái.
pointmap_urleaktodáhtolaš
Šládjastring | null
Vejolaš URL, mii buorida 3D-ođasmahttima čikŋaárvvoštallama eksternalaš pointmap- dahje čikŋadáhtáin NPY- dahje NPZ-formáhtas.
detection_thresholdeaktodáhtolaš
Šládjanumber | null
0,1 – 1
Gávnnusduođaštusčuozahus, mii báhcá modealla standárdii jus ii leat addon. Árvvut leat 0.1 rájes 1.0 rádjái; unnit árvvut lonuhit dárkilvuođa eanet gávnnusiid ovddas.
export_textured_glbeaktodáhtolaš
Šládjaboolean
Standárdafalse
GLB-eksportaválljen: dán molssaeavttu doaibma lonuha vertex-fárttaid bieaktit ráhkaduvvon tekstuvrii ja UV:ide.
gáibiduvvo Kanonala namma, maid sáhttá geavahit

Fiilaparametterat váldet almmolaš https:// URL:a, data: URI:a gitta 10 MB, dahje uploada file_url:a. Fiillat

Boađus

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"
  }
}
Du fiillat, du válljenJuohke outputs[].url lea kopia min vurkemis: bisuhuvvo álo (mákso GB-mánu mielde) dahje 7 beaivvi nuvttá, du konto­o heiveheami dahje ?storage= mielde.
Seammá hápmi juohke modeallastype, url, content_type, width, height ja duration, govvii, videoii ja jienai seammá ládje. output lea modealla iežas boađusobjekta.
Outputa giettit
gaussian_splat
object {url, content_type, file_name, file_size}Ovttastahtton scene-splat boađussiid várás main leat máŋga objeavtta, muđui okta splat; addojuvvo Gaussian-splat-fiilan .ply-formáhtas.
model_glb
object {url, content_type, file_name, file_size}3D-boađus vurkejuvvon GLB:na: máŋga objeavtta čadnojuvvojit ovtta láhtus, eará boađusain lea okta mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadáhta juohke objeavtta várás, masa gullet rotášuvdna, translášuvdna ja skála.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSierra Gaussian-splat-fiillat juohke objeavtta várás, dušše sceneain main leat máŋga objeavtta.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSierra GLB-mesh-fiillat juohke objeavtta várás, dušše sceneain main leat máŋga objeavtta.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiiva buot artefáktaiguin ja metadáhtain.

Eanet modeallat: Govas 3D

AI-agenttaide: dán siidu Markdowna lea dáppe https://doitong.com/se/developers/models/sam-3/3d-objects.md. Buot modeallat ja ráđit: https://doitong.com/developers/llms.txt