Pereiti prie turinio

Sam 3 · 3D Objects

Integruoti

Modelio 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"

Ši užklausa: ≈0,02 $ 20 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Meta · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

numatytoji car

Tekstas, naudojamas automatiniam segmentavimui, kai kaukių nėra, pvz., 'chair' arba 'lamp'.

•privaloma image_url
Įmeskite failą arba

Vaizdo URL 3D rekonstrukcijai.

Išplėstiniai mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Įmeskite failą arba

Pasirinktinis kiekvieno objekto kaukių URL sąrašas. Nepateikus kaukių, automatinis segmentavimas naudoja raginį, point_prompts arba box_prompts, jei jie pateikti; jei nepateiktos nei kaukės, nei segmentavimo raginiai, naudojamas visas vaizdas.

Pasirinktinis URL, skirtas 3D rekonstrukcijos gylio įvertinimui pagerinti pateikiant išorinius taškų žemėlapio arba gylio duomenis NPY arba NPZ formatu.

Aptikimo pasikliautinumo riba; jei nenurodyta, naudojama numatytoji modelio reikšmė. Reikšmės nuo 0.1 iki 1.0; mažesnės reikšmės sumažina tikslumą, bet padidina aptikimų skaičių.

Atkuriamam atsitiktiniam generavimui naudojama pradžia.

numatytoji []

Taškais pagrįsti raginiai, naudojami automatiniam segmentavimui, kai kaukių nėra.

numatytoji []

Langelio raginiai, per automatinį segmentavimą sukuriantys atskiras objektų kaukes 3D rekonstrukcijai; naudojami tik nepateikus kaukių. Galima pateikti kelis langelius.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Sam 3 · 3D Objects

Nuotraukoje esančius objektus paverčia 3D ištekliais. Objektus pasirinkite naudodami `mask_urls`, tekstinį `prompt`, `point_prompts` arba `box_prompts`; keli stačiakampiai sukuria atskirus objektus. `detection_threshold` priima reikšmes nuo 0.1 iki 1, o `export_textured_glb` įrašo tekstūrą ir UV koordinates. Išvestyje pateikiami GLB, Gaussian splat failai, atskiri kelių objektų scenų failai, metaduomenys ir ZIP paketas.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Vaizdo URL 3D rekonstrukcijai.
mask_urlsneprivalomas
Tipasurl[] · image
Pasirinktinis kiekvieno objekto kaukių URL sąrašas. Nepateikus kaukių, automatinis segmentavimas naudoja raginį, point_prompts arba box_prompts, jei jie pateikti; jei nepateiktos nei kaukės, nei segmentavimo raginiai, naudojamas visas vaizdas.
promptneprivalomas
Tipasstring | null
Numatytoji reikšmėcar
Tekstas, naudojamas automatiniam segmentavimui, kai kaukių nėra, pvz., 'chair' arba 'lamp'.
point_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Taškais pagrįsti raginiai, naudojami automatiniam segmentavimui, kai kaukių nėra.
point_prompts[].xneprivalomas
Tipasinteger | null
Raginio padėtis X ašyje.
point_prompts[].yneprivalomas
Tipasinteger | null
Raginio padėtis Y ašyje.
point_prompts[].labelneprivalomas
Tipasenum
01
Priekinio plano / fono etiketė: 1 nurodo priekinį planą, 0 – foną.
point_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančius raginimus. Jei kaip raginys taip pat pateikiamas tekstas, šis identifikatorius nurodo, kurį aptiktą objektą šie taškai tikslina.
box_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Langelio raginiai, per automatinį segmentavimą sukuriantys atskiras objektų kaukes 3D rekonstrukcijai; naudojami tik nepateikus kaukių. Galima pateikti kelis langelius.
box_prompts[].x_minneprivalomas
Tipasinteger | null
Mažiausia langelio x koordinatė.
box_prompts[].y_minneprivalomas
Tipasinteger | null
Mažiausia langelio y koordinatė.
box_prompts[].x_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės X koordinatė.
box_prompts[].y_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės Y koordinatė.
box_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančias dėžutes.
seedneprivalomas
Tipasinteger | null
Atkuriamam atsitiktiniam generavimui naudojama pradžia.
pointmap_urlneprivalomas
Tipasstring | null
Pasirinktinis URL, skirtas 3D rekonstrukcijos gylio įvertinimui pagerinti pateikiant išorinius taškų žemėlapio arba gylio duomenis NPY arba NPZ formatu.
detection_thresholdneprivalomas
Tipasnumber | null
0,1 – 1
Aptikimo pasikliautinumo riba; jei nenurodyta, naudojama numatytoji modelio reikšmė. Reikšmės nuo 0.1 iki 1.0; mažesnės reikšmės sumažina tikslumą, bet padidina aptikimų skaičių.
export_textured_glbneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
GLB eksporto parinktis: ją įjungus viršūnių spalvos pakeičiamos iškepta tekstūra ir UV koordinatėmis.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
gaussian_splat
object {url, content_type, file_name, file_size}Bendra scenos splata rezultatams su keliais objektais arba viena splata kitu atveju; pateikiama kaip Gaussian splat failas .ply formatu.
model_glb
object {url, content_type, file_name, file_size}3D išvestis, išsaugota kaip GLB: keli objektai surenkami į vieną sceną, o kituose rezultatuose yra vienas tinklas.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Kiekvieno objekto metaduomenys, įskaitant pasukimą, poslinkį ir mastelį.
individual_splats
array of object {url, content_type, file_name, file_size} | nullAtskiri Gaussian splat failai kiekvienam objektui, galimi tik scenose su keliais objektais.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullAtskiri GLB tinklo failai kiekvienam objektui, galimi tik scenose su keliais objektais.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP archyvas su visais artefaktais ir metaduomenimis.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sam-3/3d-objects.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt