Naar inhoud springen

Sam 3 · 3D Align

Integreren

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

Deze request: ≈$ 0,02 20 API-tegoed Op deze pagina uitvoeren

API-sleutel ophalen
Meta 3D #align#3d

Lijnt een SAM 3D-lichaamsmesh uit met de scène van de bronfoto, eventueel gecombineerd met een objectmesh

Meta · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht image_url
Sleep een bestand hierheen of

Bronafbeeldings-URL voor diepteschatting met MoGe.

•verplicht

Mesh-URL voor uitlijning, met ondersteuning voor een SAM-3D Body-bestand in .ply- of .glb-indeling.

Geavanceerd body_mask_url · object_mesh_url · focal_length
Sleep een bestand hierheen of

URL van de afbeelding met het mensmasker; bij weglating wordt de volledige afbeelding gebruikt.

Optionele mesh-URL voor een SAM-3D Object in .glb-indeling, gebruikt om een gecombineerde scène op te bouwen.

Overschrijving van de brandpuntsafstand uit SAM-3D Body-metadata; als geen waarde wordt opgegeven, wordt de MoGe-schatting gebruikt.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Sam 3 · 3D Align

Plaats een menselijke lichaamsmesh (.ply of .glb) in de coördinatenruimte van de originele foto met diepteschatting uit `image_url`. Optionele invoer bestaat uit een mensmasker, een brandpuntsafstand en een objectmesh (.glb), waarmee een gecombineerd scènebestand wordt gemaakt. De uitvoer bevat uitgelijnde meshes in PLY en GLB, uitlijningsmetadata en een overlayvisualisatie.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
Bronafbeeldings-URL voor diepteschatting met MoGe.
body_mesh_urlverplicht
Typestring
Mesh-URL voor uitlijning, met ondersteuning voor een SAM-3D Body-bestand in .ply- of .glb-indeling.
body_mask_urloptioneel
Typeurl · image
URL van de afbeelding met het mensmasker; bij weglating wordt de volledige afbeelding gebruikt.
object_mesh_urloptioneel
Typestring | null
Optionele mesh-URL voor een SAM-3D Object in .glb-indeling, gebruikt om een gecombineerde scène op te bouwen.
focal_lengthoptioneel
Typenumber | null
Overschrijving van de brandpuntsafstand uit SAM-3D Body-metadata; als geen waarde wordt opgegeven, wordt de MoGe-schatting gebruikt.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
body_mesh_ply
object {url, content_type, file_name, file_size}PLY-bestand met de uitgelijnde body-mesh.
model_glb
object {url, content_type, file_name, file_size}GLB-bestand met de uitgelijnde body-mesh voor 3D-preview.
visualization
object {url, content_type, file_name, file_size}Visualisatie van de invoerafbeelding met de uitgelijnde mesh eroverheen.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Details van de uitlijning, zoals schaal en translatie.
scene_glb
object {url, content_type, file_name, file_size} | nullGLB-uitvoer die alleen beschikbaar is wanneer object_mesh_url is opgegeven; bevat de body- en object-mesh samen in één scène.

Meer modellen: 3D

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/sam-3/3d-align.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt