Aqbeż għall-kontenut

Sam 3 · 3D Objects

Integra

Id tal-mudell 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"

Din it-talba: ≈$0.02 20 krediti tal-API Ħaddmu f’din il-paġna

Ikseb ċavetta API
Meta Immaġni għal 3D #3d#object

Jirrekkonstruċi oġġetti 3D minn immaġni, magħżula permezz ta’ prompts ta’ test, punt jew kaxxa jew maskri, b’output splat

Meta · 3D

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

prestabbilit car

Test użat għas-segmentazzjoni awtomatika meta ma jkunx hemm maskri, bħal 'chair' jew 'lamp'.

•meħtieġ image_url
Waqqa’ fajl, jew

URL tal-immaġni għar-rikostruzzjoni 3D.

Avvanzat mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Waqqa’ fajl, jew

Lista fakultattiva ta' URLs tal-maskri għal kull oġġett. Mingħajr maskri, is-segmentazzjoni awtomatika tuża prompt, point_prompts jew box_prompts jekk jiġu pprovduti; jekk ma jingħatawx la maskri u lanqas prompts tas-segmentazzjoni, tintuża l-immaġni kollha.

URL fakultattiv għat-titjib tal-istima tal-fond fir-rikostruzzjoni 3D billi jipprovdi dejta esterna ta' pointmap jew fond bħala NPY jew NPZ.

Limitu ta' qtugħ tal-kunfidenza tad-detezzjoni, li jitħalla fuq il-prestabbilit tal-mudell jekk jitħalla barra. Il-valuri jvarjaw minn 0.1 sa 1.0; valuri iżgħar jnaqqsu l-preċiżjoni iżda jżidu n-numru ta' detezzjonijiet.

Seed użat għall-ġenerazzjoni każwali riproduċibbli.

prestabbilit []

Prompts ibbażati fuq punti użati għas-segmentazzjoni awtomatika meta ma jkunx hemm maskri.

prestabbilit []

Prompts tal-kaxxi li jipproduċu maskri individwali tal-oġġetti għar-rikostruzzjoni 3D permezz tas-segmentazzjoni awtomatika, użati biss meta ma jiġux ipprovduti maskri. Jistgħu jintbagħtu diversi kaxxi.

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

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Sam 3 · 3D Objects

Jikkonverti l-oġġetti f’ritratt f’assi 3D. Agħżel l-oġġetti b’`mask_urls`, prompt ta’ test `prompt`, `point_prompts` jew `box_prompts`; diversi kaxxi jagħtu oġġetti separati. `detection_threshold` jaċċetta 0.1 sa 1, u `export_textured_glb` jintegra n-nisġa u l-UVs. L-outputs huma GLB, fajls Gaussian splat, fajls għal kull oġġett f’xeni b’diversi oġġetti, metadata u pakkett zip.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni
image_urlmeħtieġ image
Tipurl · image
URL tal-immaġni għar-rikostruzzjoni 3D.
mask_urlsmhux obbligatorju
Tipurl[] · image
Lista fakultattiva ta' URLs tal-maskri għal kull oġġett. Mingħajr maskri, is-segmentazzjoni awtomatika tuża prompt, point_prompts jew box_prompts jekk jiġu pprovduti; jekk ma jingħatawx la maskri u lanqas prompts tas-segmentazzjoni, tintuża l-immaġni kollha.
promptmhux obbligatorju
Tipstring | null
Prestabbilitcar
Test użat għas-segmentazzjoni awtomatika meta ma jkunx hemm maskri, bħal 'chair' jew 'lamp'.
point_promptsmhux obbligatorju
Tipobject[]
Prestabbilit[]
Prompts ibbażati fuq punti użati għas-segmentazzjoni awtomatika meta ma jkunx hemm maskri.
point_prompts[].xmhux obbligatorju
Tipinteger | null
Pożizzjoni tal-prompt fuq l-assi X.
point_prompts[].ymhux obbligatorju
Tipinteger | null
Pożizzjoni tal-prompt fuq l-assi Y.
point_prompts[].labelmhux obbligatorju
Tipenum
01
Tikketta tat-tagħrif ta’ quddiem/l-isfond: 1 tindika t-tagħrif ta’ quddiem; 0 tindika l-isfond.
point_prompts[].object_idmhux obbligatorju
Tipinteger | null
Identifikatur mhux obbligatorju li jiġbor prompts li jirfinaw oġġett wieħed. Jekk test jiġi pprovdut ukoll bħala prompt, dan l-identifikatur jiddetermina liema oġġett misjub jirfinaw dawk il-punti.
box_promptsmhux obbligatorju
Tipobject[]
Prestabbilit[]
Prompts tal-kaxxi li jipproduċu maskri individwali tal-oġġetti għar-rikostruzzjoni 3D permezz tas-segmentazzjoni awtomatika, użati biss meta ma jiġux ipprovduti maskri. Jistgħu jintbagħtu diversi kaxxi.
box_prompts[].x_minmhux obbligatorju
Tipinteger | null
Il-koordinata x minima għall-kaxxa.
box_prompts[].y_minmhux obbligatorju
Tipinteger | null
Il-koordinata y minima għall-kaxxa.
box_prompts[].x_maxmhux obbligatorju
Tipinteger | null
Koordinata X massima għall-kaxxa.
box_prompts[].y_maxmhux obbligatorju
Tipinteger | null
Koordinata Y massima għall-kaxxa.
box_prompts[].object_idmhux obbligatorju
Tipinteger | null
Identifikatur mhux obbligatorju li jiġbor kaxxi li jirfinaw oġġett wieħed.
seedmhux obbligatorju
Tipinteger | null
Seed użat għall-ġenerazzjoni każwali riproduċibbli.
pointmap_urlmhux obbligatorju
Tipstring | null
URL fakultattiv għat-titjib tal-istima tal-fond fir-rikostruzzjoni 3D billi jipprovdi dejta esterna ta' pointmap jew fond bħala NPY jew NPZ.
detection_thresholdmhux obbligatorju
Tipnumber | null
0.1 – 1
Limitu ta' qtugħ tal-kunfidenza tad-detezzjoni, li jitħalla fuq il-prestabbilit tal-mudell jekk jitħalla barra. Il-valuri jvarjaw minn 0.1 sa 1.0; valuri iżgħar jnaqqsu l-preċiżjoni iżda jżidu n-numru ta' detezzjonijiet.
export_textured_glbmhux obbligatorju
Tipboolean
Prestabbilitfalse
Għażla tal-esportazzjoni GLB: l-attivazzjoni tissostitwixxi l-kuluri tal-vertiċi b'tessut maħruq u UVs.
meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
gaussian_splat
object {url, content_type, file_name, file_size}Splat tax-xena magħquda għar-riżultati b'diversi oġġetti, jew splat wieħed inkella; ipprovdut bħala fajl Gaussian splat fil-format .ply.
model_glb
object {url, content_type, file_name, file_size}Output 3D salvat bħala GLB: diversi oġġetti jinġabru f'xena waħda, filwaqt li riżultati oħra jkun fihom malja waħda.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadejta għal kull oġġett, inklużi r-rotazzjoni, it-traslazzjoni u l-iskala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullFajls Gaussian splat separati għal kull oġġett, disponibbli biss f'xeni b'diversi oġġetti.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullFajls GLB tal-malja separati għal kull oġġett, disponibbli biss f'xeni b'diversi oġġetti.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArkivju ZIP tal-artifacts kollha flimkien mal-metadejta.

Aktar mudelli: Immaġni għal 3D

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/sam-3/3d-objects.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt