Gå til innhold

Sam 3 · 3D Objects

Integrer

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"

Denne forespørselen: ≈0,02 $ 20 API-kreditter Kjør den på denne siden

Hent API-nøkkel
Meta Bilde til 3D #3d#object

Gjenoppbygger 3D-objekter fra et bilde, valgt med tekst-, punkt- eller boksledetekster eller masker, med splat-utdata

Meta · 3D

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

standard car

Tekst som brukes til automatisk segmentering hvis masker mangler, for eksempel 'chair' eller 'lamp'.

•obligatorisk image_url
Slipp en fil, eller

Bilde-URL for 3D-rekonstruksjon.

Avansert mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Slipp en fil, eller

Valgfri maskeliste med URL-er per objekt. Uten masker bruker automatisk segmentering prompt, point_prompts eller box_prompts hvis de er oppgitt; hvis verken masker eller segmenteringsprompter er oppgitt, brukes hele bildet.

Valgfri URL for forbedret dybdeestimering i 3D-rekonstruksjon ved å levere eksterne punktkart- eller dybdedata som NPY eller NPZ.

Grenseverdi for deteksjonskonfidens, satt til modellens standardverdi hvis den utelates. Verdiene går fra 0.1 til 1.0, der lavere verdier gir lavere presisjon, men flere deteksjoner.

Seed brukt for reproduserbar tilfeldig generering.

standard []

Punktbaserte prompter som brukes til automatisk segmentering hvis masker mangler.

standard []

Boksprompter som gir individuelle objektmasker for 3D-rekonstruksjon gjennom automatisk segmentering, og brukes bare hvis ingen masker er oppgitt. Flere bokser kan sendes inn.

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"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Sam 3 · 3D Objects

Gjør objekter i et bilde om til 3D-ressurser. Velg objekter med `mask_urls`, en tekstlig `prompt`, `point_prompts` eller `box_prompts`; flere bokser gir separate objekter. `detection_threshold` godtar 0.1 til 1, og `export_textured_glb` baker inn tekstur og UV-er. Utdata er en GLB-fil, Gaussian-splat-filer, filer per objekt for scener med flere objekter, metadata og en zip-pakke.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
image_urlobligatorisk image
Typeurl · image
Bilde-URL for 3D-rekonstruksjon.
mask_urlsvalgfritt
Typeurl[] · image
Valgfri maskeliste med URL-er per objekt. Uten masker bruker automatisk segmentering prompt, point_prompts eller box_prompts hvis de er oppgitt; hvis verken masker eller segmenteringsprompter er oppgitt, brukes hele bildet.
promptvalgfritt
Typestring | null
Standardcar
Tekst som brukes til automatisk segmentering hvis masker mangler, for eksempel 'chair' eller 'lamp'.
point_promptsvalgfritt
Typeobject[]
Standard[]
Punktbaserte prompter som brukes til automatisk segmentering hvis masker mangler.
point_prompts[].xvalgfritt
Typeinteger | null
Promptens posisjon langs X-aksen.
point_prompts[].yvalgfritt
Typeinteger | null
Promptens posisjon langs Y-aksen.
point_prompts[].labelvalgfritt
Typeenum
01
Forgrunns-/bakgrunnsetikett: 1 angir forgrunn; 0 angir bakgrunn.
point_prompts[].object_idvalgfritt
Typeinteger | null
Valgfri identifikator som grupperer prompter som forbedrer ett enkelt objekt. Hvis tekst også oppgis som en prompt, bestemmer denne identifikatoren hvilket registrerte objekt punktene forbedrer.
box_promptsvalgfritt
Typeobject[]
Standard[]
Boksprompter som gir individuelle objektmasker for 3D-rekonstruksjon gjennom automatisk segmentering, og brukes bare hvis ingen masker er oppgitt. Flere bokser kan sendes inn.
box_prompts[].x_minvalgfritt
Typeinteger | null
Minste x-koordinat for boksen.
box_prompts[].y_minvalgfritt
Typeinteger | null
Minste y-koordinat for boksen.
box_prompts[].x_maxvalgfritt
Typeinteger | null
Maksimal X-koordinat for boksen.
box_prompts[].y_maxvalgfritt
Typeinteger | null
Maksimal Y-koordinat for boksen.
box_prompts[].object_idvalgfritt
Typeinteger | null
Valgfri identifikator som grupperer bokser som forbedrer ett enkelt objekt.
seedvalgfritt
Typeinteger | null
Seed brukt for reproduserbar tilfeldig generering.
pointmap_urlvalgfritt
Typestring | null
Valgfri URL for forbedret dybdeestimering i 3D-rekonstruksjon ved å levere eksterne punktkart- eller dybdedata som NPY eller NPZ.
detection_thresholdvalgfritt
Typenumber | null
0,1 – 1
Grenseverdi for deteksjonskonfidens, satt til modellens standardverdi hvis den utelates. Verdiene går fra 0.1 til 1.0, der lavere verdier gir lavere presisjon, men flere deteksjoner.
export_textured_glbvalgfritt
Typeboolean
Standardfalse
GLB-eksportalternativ: Når dette aktiveres, erstattes vertex-farger med en bakt tekstur og UV-er.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
gaussian_splat
object {url, content_type, file_name, file_size}Kombinert scene-splat for resultater med flere objekter, eller ett enkelt splat ellers; leveres som en Gaussian-splatfil i .ply-format.
model_glb
object {url, content_type, file_name, file_size}3D-utdata lagret som GLB: Flere objekter settes sammen i én scene, mens andre resultater inneholder én mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata for hvert objekt, inkludert rotasjon, translasjon og skala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSeparate Gaussian-splatfiler for hvert objekt, bare tilgjengelig i scener med flere objekter.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSeparate GLB-meshfiler for hvert objekt, bare tilgjengelig i scener med flere objekter.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med alle artefakter samt metadata.

Flere modeller: Bilde til 3D

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/sam-3/3d-objects.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt