Naar inhoud springen

Sam 3 · 3D Objects

Integreren

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

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

API-sleutel ophalen
Meta Afbeelding naar 3D #3d#object

Reconstrueert 3D-objecten uit een afbeelding, geselecteerd met tekst-, punt- of box-prompts of maskers, met splat-uitvoer

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.

standaard car

Tekst die wordt gebruikt voor automatische segmentatie wanneer maskers ontbreken, zoals 'chair' of 'lamp'.

•verplicht image_url
Sleep een bestand hierheen of

Afbeeldings-URL voor 3D-reconstructie.

Geavanceerd mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Sleep een bestand hierheen of

Optionele lijst met masker-URL's per object. Zonder maskers gebruikt automatische segmentatie prompt, point_prompts of box_prompts indien opgegeven; als noch maskers noch segmentatieprompts zijn opgegeven, wordt de volledige afbeelding gebruikt.

Optionele URL voor betere diepteschatting bij 3D-reconstructie door externe pointmap- of dieptegegevens als NPY of NPZ aan te leveren.

Drempel voor detectievertrouwen, waarvoor bij weglating de standaardwaarde van het model wordt gebruikt. Waarden lopen van 0.1 tot 1.0; lagere waarden leveren precisie in voor een groter aantal detecties.

Seed voor reproduceerbare willekeurige generatie.

standaard []

Point-prompts voor automatische segmentatie wanneer maskers ontbreken.

standaard []

Box-prompts die afzonderlijke objectmaskers opleveren voor 3D-reconstructie via automatische segmentatie; alleen gebruikt wanneer geen maskers zijn opgegeven. Er kunnen meerdere kaders worden aangeleverd.

POST /run/sam-3/3d-objects?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-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"

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 Objects

Zet objecten in een foto om in 3D-assets. Kies objecten met `mask_urls`, een tekstuele `prompt`, `point_prompts` of `box_prompts`; meerdere boxen leveren afzonderlijke objecten op. `detection_threshold` accepteert 0.1 tot 1 en `export_textured_glb` bakt textuur en UV's in. De uitvoer bevat een GLB, Gaussian-splatbestanden, bestanden per object voor scènes met meerdere objecten, metadata en een zip-bundel.

Parameters

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

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
Afbeeldings-URL voor 3D-reconstructie.
mask_urlsoptioneel
Typeurl[] · image
Optionele lijst met masker-URL's per object. Zonder maskers gebruikt automatische segmentatie prompt, point_prompts of box_prompts indien opgegeven; als noch maskers noch segmentatieprompts zijn opgegeven, wordt de volledige afbeelding gebruikt.
promptoptioneel
Typestring | null
Standaardcar
Tekst die wordt gebruikt voor automatische segmentatie wanneer maskers ontbreken, zoals 'chair' of 'lamp'.
point_promptsoptioneel
Typeobject[]
Standaard[]
Point-prompts voor automatische segmentatie wanneer maskers ontbreken.
point_prompts[].xoptioneel
Typeinteger | null
Promptpositie langs de X-as.
point_prompts[].yoptioneel
Typeinteger | null
Promptpositie langs de Y-as.
point_prompts[].labeloptioneel
Typeenum
01
Label voor voorgrond/achtergrond: 1 geeft voorgrond aan; 0 geeft achtergrond aan.
point_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier die prompts groepeert die één object verfijnen. Als ook tekst als prompt wordt opgegeven, bepaalt deze identifier welk gedetecteerd object die punten verfijnen.
box_promptsoptioneel
Typeobject[]
Standaard[]
Box-prompts die afzonderlijke objectmaskers opleveren voor 3D-reconstructie via automatische segmentatie; alleen gebruikt wanneer geen maskers zijn opgegeven. Er kunnen meerdere kaders worden aangeleverd.
box_prompts[].x_minoptioneel
Typeinteger | null
Minimale x-coördinaat van het vak.
box_prompts[].y_minoptioneel
Typeinteger | null
Minimale y-coördinaat van het vak.
box_prompts[].x_maxoptioneel
Typeinteger | null
Maximale X-coördinaat voor de box.
box_prompts[].y_maxoptioneel
Typeinteger | null
Maximale Y-coördinaat voor de box.
box_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier voor het groeperen van boxen die één object verfijnen.
seedoptioneel
Typeinteger | null
Seed voor reproduceerbare willekeurige generatie.
pointmap_urloptioneel
Typestring | null
Optionele URL voor betere diepteschatting bij 3D-reconstructie door externe pointmap- of dieptegegevens als NPY of NPZ aan te leveren.
detection_thresholdoptioneel
Typenumber | null
0,1 – 1
Drempel voor detectievertrouwen, waarvoor bij weglating de standaardwaarde van het model wordt gebruikt. Waarden lopen van 0.1 tot 1.0; lagere waarden leveren precisie in voor een groter aantal detecties.
export_textured_glboptioneel
Typeboolean
Standaardfalse
Keuze voor GLB-export: door deze optie in te schakelen worden vertexkleuren vervangen door een gebakken texture en UV's.
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-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"
  }
}
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
gaussian_splat
object {url, content_type, file_name, file_size}Gecombineerde scene-splat voor resultaten met meerdere objecten, of anders één splat; aangeleverd als Gaussian-splatbestand in .ply-indeling.
model_glb
object {url, content_type, file_name, file_size}3D-uitvoer opgeslagen als GLB: meerdere objecten worden samengevoegd tot één scène, terwijl andere resultaten één mesh bevatten.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata voor elk object, inclusief rotatie, translatie en schaal.
individual_splats
array of object {url, content_type, file_name, file_size} | nullAfzonderlijke Gaussian-splatbestanden voor elk object, alleen beschikbaar in scènes met meerdere objecten.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullAfzonderlijke GLB-meshbestanden voor elk object, alleen beschikbaar in scènes met meerdere objecten.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-archief met alle artefacten en metadata.

Meer modellen: Afbeelding naar 3D

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