Zum Inhalt springen

Sam 3 · 3D Objects

Integrieren

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"

Diese Anfrage: ≈0,02 $ 20 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Meta Bild zu 3D #3d#object

Rekonstruiert anhand von Text-, Punkt- oder Box-Prompts beziehungsweise Masken 3D-Objekte aus einem Bild und gibt Splat-Daten aus

Meta · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

Standard car

Für die automatische Segmentierung verwendeter Text, wenn keine Masken vorhanden sind, etwa 'chair' oder 'lamp'.

•erforderlich image_url
Datei ablegen oder

Bild-URL für die 3D-Rekonstruktion.

Erweitert mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Datei ablegen oder

Optionale Liste von Masken-URLs pro Objekt. Ohne Masken verwendet die automatische Segmentierung prompt, point_prompts oder box_prompts, sofern angegeben; wenn weder Masken noch Segmentierungs-Prompts angegeben sind, wird das gesamte Bild verwendet.

Optionale URL zur Verbesserung der Tiefenschätzung bei der 3D-Rekonstruktion durch externe Punktkarten- oder Tiefendaten im NPY- oder NPZ-Format.

Konfidenzgrenzwert für die Erkennung; ohne Angabe wird der Standard des Modells verwendet. Werte reichen von 0.1 bis 1.0, wobei niedrigere Werte zugunsten einer höheren Anzahl von Erkennungen weniger Präzision bieten.

Seed für reproduzierbare Zufallsgenerierung.

Standard []

Punktbasierte Prompts für die automatische Segmentierung, wenn keine Masken vorhanden sind.

Standard []

Box-Prompts, die durch automatische Segmentierung individuelle Objektmasken für die 3D-Rekonstruktion erzeugen; nur verwendet, wenn keine Masken angegeben sind. Es können mehrere Boxen übermittelt werden.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Sam 3 · 3D Objects

Wandelt Objekte in einem Foto in 3D-Assets um. Wählen Sie Objekte mit `mask_urls`, einem Text-`prompt`, `point_prompts` oder `box_prompts` aus; mehrere Boxen erzeugen separate Objekte. `detection_threshold` akzeptiert 0.1 bis 1, und `export_textured_glb` übernimmt Texturen und UVs. Die Ausgabe umfasst einen GLB, Gaussian-Splat-Dateien, Dateien pro Objekt bei Multi-Objekt-Szenen, Metadaten und ein ZIP-Paket.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlerforderlich image
Typurl · image
Bild-URL für die 3D-Rekonstruktion.
mask_urlsoptional
Typurl[] · image
Optionale Liste von Masken-URLs pro Objekt. Ohne Masken verwendet die automatische Segmentierung prompt, point_prompts oder box_prompts, sofern angegeben; wenn weder Masken noch Segmentierungs-Prompts angegeben sind, wird das gesamte Bild verwendet.
promptoptional
Typstring | null
Standardcar
Für die automatische Segmentierung verwendeter Text, wenn keine Masken vorhanden sind, etwa 'chair' oder 'lamp'.
point_promptsoptional
Typobject[]
Standard[]
Punktbasierte Prompts für die automatische Segmentierung, wenn keine Masken vorhanden sind.
point_prompts[].xoptional
Typinteger | null
Prompt-Position auf der X-Achse.
point_prompts[].yoptional
Typinteger | null
Prompt-Position auf der Y-Achse.
point_prompts[].labeloptional
Typenum
01
Vordergrund-/Hintergrundbezeichnung: 1 bedeutet Vordergrund, 0 Hintergrund.
point_prompts[].object_idoptional
Typinteger | null
Optionaler Bezeichner zur Gruppierung von Prompts, die ein einzelnes Objekt verfeinern. Wenn zusätzlich Text als Prompt angegeben wird, bestimmt dieser Bezeichner, welches erkannte Objekt durch diese Punkte verfeinert wird.
box_promptsoptional
Typobject[]
Standard[]
Box-Prompts, die durch automatische Segmentierung individuelle Objektmasken für die 3D-Rekonstruktion erzeugen; nur verwendet, wenn keine Masken angegeben sind. Es können mehrere Boxen übermittelt werden.
box_prompts[].x_minoptional
Typinteger | null
Minimaler x-Koordinatenwert der Box.
box_prompts[].y_minoptional
Typinteger | null
Minimaler y-Koordinatenwert der Box.
box_prompts[].x_maxoptional
Typinteger | null
Maximale X-Koordinate der Box.
box_prompts[].y_maxoptional
Typinteger | null
Maximale Y-Koordinate der Box.
box_prompts[].object_idoptional
Typinteger | null
Optionaler Bezeichner zur Gruppierung von Boxen, die ein einzelnes Objekt verfeinern.
seedoptional
Typinteger | null
Seed für reproduzierbare Zufallsgenerierung.
pointmap_urloptional
Typstring | null
Optionale URL zur Verbesserung der Tiefenschätzung bei der 3D-Rekonstruktion durch externe Punktkarten- oder Tiefendaten im NPY- oder NPZ-Format.
detection_thresholdoptional
Typnumber | null
0,1 – 1
Konfidenzgrenzwert für die Erkennung; ohne Angabe wird der Standard des Modells verwendet. Werte reichen von 0.1 bis 1.0, wobei niedrigere Werte zugunsten einer höheren Anzahl von Erkennungen weniger Präzision bieten.
export_textured_glboptional
Typboolean
Standardfalse
Auswahl für den GLB-Export: Wenn diese Option aktiviert ist, werden Vertexfarben durch eine gebackene Textur und UVs ersetzt.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
gaussian_splat
object {url, content_type, file_name, file_size}Kombinierter Szenen-Splat für Ergebnisse mit mehreren Objekten oder andernfalls ein einzelner Splat; als Gaussian-Splat-Datei im .ply-Format bereitgestellt.
model_glb
object {url, content_type, file_name, file_size}Als GLB gespeicherte 3D-Ausgabe: Mehrere Objekte werden zu einer Szene zusammengefügt, während andere Ergebnisse ein einzelnes Mesh enthalten.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadaten für jedes Objekt, einschließlich Rotation, Translation und Skalierung.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSeparate Gaussian-Splat-Dateien für jedes Objekt, nur in Szenen mit mehreren Objekten verfügbar.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSeparate GLB-Mesh-Dateien für jedes Objekt, nur in Szenen mit mehreren Objekten verfügbar.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-Archiv aller Artefakte einschließlich Metadaten.

Weitere Modelle: Bild zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/sam-3/3d-objects.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt