Gå til indhold

Sam 3 · 3D Objects

Integrer

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"

Denne anmodning: ≈0,02 $ 20 API-kreditter Kør den på denne side

Hent API-nøgle
Meta Billede til 3D #3d#object

Genskaber 3D-objekter fra et billede, valgt med tekst-, punkt- eller boks-prompts eller masker, med splat-output

Meta · 3D

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

standard car

Tekst, der bruges til automatisk segmentering, hvis masker mangler, f.eks. 'chair' eller 'lamp'.

•påkrævet image_url
Slip en fil, eller

Billede-URL til 3D-rekonstruktion.

Avanceret mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Slip en fil, eller

Valgfri liste over maske-URL'er pr. objekt. Uden masker bruger automatisk segmentering prompt, point_prompts eller box_prompts, hvis de er angivet; hvis hverken masker eller segmenteringsprompts er angivet, bruges hele billedet.

Valgfri URL til forbedring af dybdeestimering i 3D-rekonstruktion ved at levere eksterne pointmap- eller dybdedata som NPY eller NPZ.

Grænse for detektionskonfidens, der overlades til modellens standardværdi, hvis den udelades. Værdierne går fra 0.1 til 1.0, hvor lavere værdier giver lavere præcision til gengæld for flere detektioner.

Seed til reproducerbar tilfældig generering.

standard []

Punktbaserede prompts, der bruges til automatisk segmentering, hvis masker mangler.

standard []

Boksprompts, der giver individuelle objektmasker til 3D-rekonstruktion via automatisk segmentering, og som kun bruges, hvis der ikke er angivet masker. Der kan indsendes flere bokse.

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"

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Sam 3 · 3D Objects

Omdanner objekter i et foto til 3D-assets. Vælg objekter med `mask_urls`, en tekstlig `prompt`, `point_prompts` eller `box_prompts`; flere bokse giver separate objekter. `detection_threshold` accepterer 0.1 til 1, og `export_textured_glb` indlejrer tekstur og UV'er. Output omfatter en GLB, Gaussian-splat-filer, filer pr. objekt for scener med flere objekter, metadata og en zip-pakke.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
image_urlpåkrævet image
Typeurl · image
Billede-URL til 3D-rekonstruktion.
mask_urlsvalgfri
Typeurl[] · image
Valgfri liste over maske-URL'er pr. objekt. Uden masker bruger automatisk segmentering prompt, point_prompts eller box_prompts, hvis de er angivet; hvis hverken masker eller segmenteringsprompts er angivet, bruges hele billedet.
promptvalgfri
Typestring | null
Standardcar
Tekst, der bruges til automatisk segmentering, hvis masker mangler, f.eks. 'chair' eller 'lamp'.
point_promptsvalgfri
Typeobject[]
Standard[]
Punktbaserede prompts, der bruges til automatisk segmentering, hvis masker mangler.
point_prompts[].xvalgfri
Typeinteger | null
Promptens position langs X-aksen.
point_prompts[].yvalgfri
Typeinteger | null
Promptens position langs Y-aksen.
point_prompts[].labelvalgfri
Typeenum
01
Forgrunds-/baggrundsetiket: 1 angiver forgrund; 0 angiver baggrund.
point_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer prompts, som forfiner ét objekt. Hvis tekst også angives som prompt, bestemmer denne identifikator, hvilket registreret objekt punkterne forfiner.
box_promptsvalgfri
Typeobject[]
Standard[]
Boksprompts, der giver individuelle objektmasker til 3D-rekonstruktion via automatisk segmentering, og som kun bruges, hvis der ikke er angivet masker. Der kan indsendes flere bokse.
box_prompts[].x_minvalgfri
Typeinteger | null
Minimums-x-koordinat for boksen.
box_prompts[].y_minvalgfri
Typeinteger | null
Minimums-y-koordinat for boksen.
box_prompts[].x_maxvalgfri
Typeinteger | null
Maksimal X-koordinat for boksen.
box_prompts[].y_maxvalgfri
Typeinteger | null
Maksimal Y-koordinat for boksen.
box_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer bokse, som forfiner ét objekt.
seedvalgfri
Typeinteger | null
Seed til reproducerbar tilfældig generering.
pointmap_urlvalgfri
Typestring | null
Valgfri URL til forbedring af dybdeestimering i 3D-rekonstruktion ved at levere eksterne pointmap- eller dybdedata som NPY eller NPZ.
detection_thresholdvalgfri
Typenumber | null
0,1 – 1
Grænse for detektionskonfidens, der overlades til modellens standardværdi, hvis den udelades. Værdierne går fra 0.1 til 1.0, hvor lavere værdier giver lavere præcision til gengæld for flere detektioner.
export_textured_glbvalgfri
Typeboolean
Standardfalse
Valg af GLB-eksport: Når denne indstilling aktiveres, erstattes vertexfarver med en bagt tekstur og UV'er.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
gaussian_splat
object {url, content_type, file_name, file_size}Samlet scene-splat for resultater med flere objekter eller en enkelt splat ellers; leveres som en Gaussian-splatfil i .ply-format.
model_glb
object {url, content_type, file_name, file_size}3D-output gemt som GLB: Flere objekter samles i én scene, mens andre resultater indeholder ét mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata for hvert objekt, inklusive rotation, translation og skala.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSeparate Gaussian-splatfiler for hvert objekt, kun tilgængelige i scener med flere objekter.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSeparate GLB-meshfiler for hvert objekt, kun tilgængelige i scener med flere objekter.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med alle artefakter samt metadata.

Flere modeller: Billede til 3D

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/sam-3/3d-objects.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt