Hoppa till innehåll

Sam 3 · 3D Align

Integrera

Modell-id sam-3/3d-align
# 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-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

# 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.

•obligatoriskt image_url
Släpp en fil eller

Källbildens URL för djupestimering med MoGe.

•obligatoriskt

Mesh-URL för justering, med stöd för en SAM-3D Body-fil i formatet .ply eller .glb.

Avancerat body_mask_url · object_mesh_url · focal_length
Släpp en fil eller

URL till bild med människomask; om den utelämnas används hela bilden.

Valfri mesh-URL för ett SAM-3D Object i formatet .glb, som används för att bygga en kombinerad scen.

Överskrivning av brännvidd från SAM-3D Body-metadata; MoGe-estimering används om inget värde anges.

POST /run/sam-3/3d-align?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-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

# 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 Align

Placerar ett mänskligt kroppsnät (.ply eller .glb) i originalfotots koordinatrymd med djupskattning från `image_url`. Valfria indata är en människomask, ett brännviddsvärde och ett objektnät (.glb) som ger en kombinerad scenfil. Utdata innehåller justerade nät i PLY och GLB, justeringsmetadata och en överlagringsvisualisering.

Parametrar

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

NamnTyp StandardTillåtna Beskrivning
image_urlobligatoriskt image
Typurl · image
Källbildens URL för djupestimering med MoGe.
body_mesh_urlobligatoriskt
Typstring
Mesh-URL för justering, med stöd för en SAM-3D Body-fil i formatet .ply eller .glb.
body_mask_urlvalfritt
Typurl · image
URL till bild med människomask; om den utelämnas används hela bilden.
object_mesh_urlvalfritt
Typstring | null
Valfri mesh-URL för ett SAM-3D Object i formatet .glb, som används för att bygga en kombinerad scen.
focal_lengthvalfritt
Typnumber | null
Överskrivning av brännvidd från SAM-3D Body-metadata; MoGe-estimering används om inget värde anges.
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-align",
  "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",
    "body_mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "body_mesh_ply": {
      "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
    },
    "visualization": {
      "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": {
      "person_id": 1,
      "scale_factor": 1.0,
      "translation": [
        1.0
      ],
      "focal_length": 1.0,
      "target_points_count": 1,
      "cropped_vertices_count": 1
    },
    "scene_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
    }
  },
  "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
body_mesh_ply
object {url, content_type, file_name, file_size}PLY-fil som innehåller den justerade kroppsmeshen.
model_glb
object {url, content_type, file_name, file_size}GLB-fil som innehåller den justerade kroppsmeshen för 3D-förhandsvisning.
visualization
object {url, content_type, file_name, file_size}Visualisering av indatabilden med den justerade meshen överlagrad.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Justeringsdetaljer, till exempel skalning och translation.
scene_glb
object {url, content_type, file_name, file_size} | nullGLB-utdata som endast är tillgänglig när object_mesh_url anges; den innehåller både kropps- och objektmeshen tillsammans i en scen.

Fler modeller: 3D

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