Hoppa till innehåll

Sam 3 · 3D Objects

Integrera

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

Den här begäran: ≈0,02 $ 20 API-krediter Kör den på den här sidan

Hämta API-nyckel
Meta · 3D

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

standard car

Text som används för automatisk segmentering när masker saknas, till exempel 'chair' eller 'lamp'.

•obligatoriskt image_url
Släpp en fil eller

Bild-URL för 3D-rekonstruktion.

Avancerat mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Släpp en fil eller

Valfri lista med mask-URL:er per objekt. Utan masker använder automatisk segmentering prompt, point_prompts eller box_prompts om de har angetts; om varken masker eller segmenteringsprompter anges används hela bilden.

Valfri URL för förbättrad djupestimering i 3D-rekonstruktion genom externa punktkarta- eller djupdata som NPY eller NPZ.

Gränsvärde för detektionskonfidens, lämnas till modellens standardvärde om det utelämnas. Värdena ligger mellan 0.1 och 1.0, där lägre värden innebär en avvägning mot precisionen till förmån för fler detektioner.

Seed som används för reproducerbar slumpgenerering.

standard []

Punktbaserade prompter som används för automatisk segmentering när masker saknas.

standard []

Boxprompter som ger individuella objektmasker för 3D-rekonstruktion genom automatisk segmentering, används endast om inga masker anges. Flera boxar kan skickas in.

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Sam 3 · 3D Objects

Gör objekt i ett foto till 3D-tillgångar. Välj objekt med `mask_urls`, en textbaserad `prompt`, `point_prompts` eller `box_prompts`; flera boxar ger separata objekt. `detection_threshold` accepterar 0.1 till 1, och `export_textured_glb` bakar in textur och UV-koordinater. Utdata innehåller en GLB-fil, Gaussian-splat-filer, filer per objekt för scener med flera objekt, metadata och ett zip-paket.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
image_urlobligatoriskt image
Typurl · image
Bild-URL för 3D-rekonstruktion.
mask_urlsvalfritt
Typurl[] · image
Valfri lista med mask-URL:er per objekt. Utan masker använder automatisk segmentering prompt, point_prompts eller box_prompts om de har angetts; om varken masker eller segmenteringsprompter anges används hela bilden.
promptvalfritt
Typstring | null
Standardcar
Text som används för automatisk segmentering när masker saknas, till exempel 'chair' eller 'lamp'.
point_promptsvalfritt
Typobject[]
Standard[]
Punktbaserade prompter som används för automatisk segmentering när masker saknas.
point_prompts[].xvalfritt
Typinteger | null
Promptens position längs X-axeln.
point_prompts[].yvalfritt
Typinteger | null
Promptens position längs Y-axeln.
point_prompts[].labelvalfritt
Typenum
01
Etikett för förgrund/bakgrund: 1 anger förgrund; 0 anger bakgrund.
point_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar prompter som förfinar ett enda objekt. Om text också anges som prompt avgör denna identifierare vilket upptäckt objekt punkterna förfinar.
box_promptsvalfritt
Typobject[]
Standard[]
Boxprompter som ger individuella objektmasker för 3D-rekonstruktion genom automatisk segmentering, används endast om inga masker anges. Flera boxar kan skickas in.
box_prompts[].x_minvalfritt
Typinteger | null
Minsta x-koordinat för rutan.
box_prompts[].y_minvalfritt
Typinteger | null
Minsta y-koordinat för rutan.
box_prompts[].x_maxvalfritt
Typinteger | null
Maximal X-koordinat för boxen.
box_prompts[].y_maxvalfritt
Typinteger | null
Maximal Y-koordinat för boxen.
box_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar boxar som förfinar ett enda objekt.
seedvalfritt
Typinteger | null
Seed som används för reproducerbar slumpgenerering.
pointmap_urlvalfritt
Typstring | null
Valfri URL för förbättrad djupestimering i 3D-rekonstruktion genom externa punktkarta- eller djupdata som NPY eller NPZ.
detection_thresholdvalfritt
Typnumber | null
0,1 – 1
Gränsvärde för detektionskonfidens, lämnas till modellens standardvärde om det utelämnas. Värdena ligger mellan 0.1 och 1.0, där lägre värden innebär en avvägning mot precisionen till förmån för fler detektioner.
export_textured_glbvalfritt
Typboolean
Standardfalse
Val för GLB-export: när detta aktiveras ersätts vertexfärger med en bakad textur och UV-koordinater.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
gaussian_splat
object {url, content_type, file_name, file_size}Kombinerad scen-splat för resultat med flera objekt, eller en enda splat i övriga fall; tillhandahålls som en Gaussian-splatfil i formatet .ply.
model_glb
object {url, content_type, file_name, file_size}3D-utdata sparad som GLB: flera objekt sammanfogas till en scen, medan övriga resultat innehåller en mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata för varje objekt, inklusive rotation, translation och skalning.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSeparata Gaussian-splatfiler för varje objekt, tillgängliga endast i scener med flera objekt.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSeparata GLB-meshfiler för varje objekt, tillgängliga endast i scener med flera objekt.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med alla artefakter samt metadata.

Fler modeller: Bild till 3D

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/sam-3/3d-objects.md. Alla modeller och guider: https://doitong.com/developers/llms.txt