Saltar al cuntegna

Sam 3 · 3D Objects

Integrar

ID dal 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa dumonda: ≈$0,02 20 credits API · ≈ ₽2,11 Lantschar sin questa pagina

Obtegna ina clav API
Meta · 3D

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

standard car

Text per la segmentaziun automatica, sch'i mancan mascas, sco 'chair' u 'lamp'.

•obligatori image_url
Trametta in datoteca u

URL da la maletg per la reconstrucziun 3D.

Avanzà mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Trametta in datoteca u

Glista opziunala d'URLs da mascas per mintga object. Senza mascas utilisescha la segmentaziun automatica prompt, point_prompts u box_prompts, sch'els vegnan furnids; sche ni mascas ni prompts da segmentaziun vegnan furnids, vegn duvrada l'entira maletg.

URL opziunal per meglierar la stimaziun da la profunditad en la reconstrucziun 3D cun furnir datas externas pointmap u da profunditad sco NPY u NPZ.

Limita da confidenza per la detecziun, che resta sin il standard dal model sch'ella vegn omessa. Las valurs tanschan da 0.1 fin 1.0; valurs pli pitschnas barattan la precisiun per in dumber pli grond da detecziuns.

Seed utilisà per ina generaziun casuala reproducibla.

standard []

Prompts basads sin puncts per la segmentaziun automatica, sch'i mancan mascas.

standard []

Box prompts che produceschan mascas d'objects singuls per la reconstrucziun 3D tras segmentaziun automatica; vegnan utilisads mo sche naginas mascas na vegnan furnidas. Pliras boxes pon vegnir inoltradas.

POST /run/sam-3/3d-objects?wait=20 calculaziun → $0,02
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Sam 3 · 3D Objects

Transformescha objects d'ina fotografia en assets 3D. Elegi objects cun `mask_urls`, in `prompt` da text, `point_prompts` u `box_prompts`; pliras boxas dattan objects separads. `detection_threshold` accepta 0.1 fin 1, e `export_textured_glb` integra texturas ed UVs. Ils outputs cuntegnan in GLB, datotecas Gaussian splat, datotecas per object per scenas cun plirs objects, metadatas ed in pachet zip.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
image_urlobligatori image
Tipurl · image
URL da la maletg per la reconstrucziun 3D.
mask_urlsopziunal
Tipurl[] · image
Glista opziunala d'URLs da mascas per mintga object. Senza mascas utilisescha la segmentaziun automatica prompt, point_prompts u box_prompts, sch'els vegnan furnids; sche ni mascas ni prompts da segmentaziun vegnan furnids, vegn duvrada l'entira maletg.
promptopziunal
Tipstring | null
Standardcar
Text per la segmentaziun automatica, sch'i mancan mascas, sco 'chair' u 'lamp'.
point_promptsopziunal
Tipobject[]
Standard[]
Prompts basads sin puncts per la segmentaziun automatica, sch'i mancan mascas.
point_prompts[].xopziunal
Tipinteger | null
Posiziun dal prompt sin l'axa X.
point_prompts[].yopziunal
Tipinteger | null
Posiziun dal prompt sin l'axa Y.
point_prompts[].labelopziunal
Tipenum
01
Label dal primplan/fund: 1 inditgescha il primplan; 0 inditgescha il fund.
point_prompts[].object_idopziunal
Tipinteger | null
Identifitgader opziunal che gruppescha prompts che megliereschan in singul object. Sche text vegn er furnì sco prompt, determinescha quest identifitgader tge object detectà che quels puncts megliereschan.
box_promptsopziunal
Tipobject[]
Standard[]
Box prompts che produceschan mascas d'objects singuls per la reconstrucziun 3D tras segmentaziun automatica; vegnan utilisads mo sche naginas mascas na vegnan furnidas. Pliras boxes pon vegnir inoltradas.
box_prompts[].x_minopziunal
Tipinteger | null
Coordonada x minimala per la box.
box_prompts[].y_minopziunal
Tipinteger | null
Coordonada y minimala per la box.
box_prompts[].x_maxopziunal
Tipinteger | null
Coordinata X maximala dal box.
box_prompts[].y_maxopziunal
Tipinteger | null
Coordinata Y maximala dal box.
box_prompts[].object_idopziunal
Tipinteger | null
Identifitgader opziunal che gruppescha boxes che megliereschan in singul object.
seedopziunal
Tipinteger | null
Seed utilisà per ina generaziun casuala reproducibla.
pointmap_urlopziunal
Tipstring | null
URL opziunal per meglierar la stimaziun da la profunditad en la reconstrucziun 3D cun furnir datas externas pointmap u da profunditad sco NPY u NPZ.
detection_thresholdopziunal
Tipnumber | null
0,1 – 1
Limita da confidenza per la detecziun, che resta sin il standard dal model sch'ella vegn omessa. Las valurs tanschan da 0.1 fin 1.0; valurs pli pitschnas barattan la precisiun per in dumber pli grond da detecziuns.
export_textured_glbopziunal
Tipboolean
Standardfalse
Selecziun d'export GLB: activar questa opziun remplazza las colurs dals vertizs cun ina textur baked e UVs.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
gaussian_splat
object {url, content_type, file_name, file_size}Splat da la scena cumbinada per resultats cun plirs objects, u in singul splat en ils auters cas; furnì sco datoteca Gaussian splat en il format .ply.
model_glb
object {url, content_type, file_name, file_size}Output 3D memorisà sco GLB: plirs objects vegnan assemblads en ina scena, entant che ils auters resultats cuntegnan ina singula mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadatas per mintga object, inclusiv rotaziun, translaziun e scala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullDatotecas Gaussian splat separadas per mintga object, disponiblas mo en scenas cun plirs objects.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullDatotecas mesh GLB separadas per mintga object, disponiblas mo en scenas cun plirs objects.
artifacts_zip
object {url, content_type, file_name, file_size} | nullArchiv ZIP da tut ils artifacts e las metadatas.

Dapli models: Maletg a 3D

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/sam-3/3d-objects.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt