Sleppa yfir í efni

Sam 3 · 3D Objects

Tengja

Auðkenni líkans 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"

Þessi beiðni: ≈0,02 $ 20 API-inneignir Keyra á þessari síðu

Fá API-lykil
Meta Mynd í 3D #3d#object

Endurgerir 3D-hluti úr mynd, valda með texta-, punkta- eða kassafyrirmælum eða möskvum, með splat-úttaki

Meta · 3D

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

sjálfgefið car

Texti fyrir sjálfvirka hlutgreiningu þegar grímur vantar, til dæmis 'chair' eða 'lamp'.

•áskilið image_url
Slepptu skrá eða

Slóð að mynd fyrir 3D-endurgerð.

Ítarlegt mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Slepptu skrá eða

Valfrjáls listi yfir slóðir að grímum fyrir hvern hlut. Án gríma notar sjálfvirk hlutgreining kvaðningu, point_prompts eða box_prompts ef þau eru gefin upp; ef hvorki grímur né hlutgreiningarkvaðningar eru gefnar upp er öll myndin notuð.

Valfrjáls slóð til að bæta dýptaráætlun í 3D-endurgerð með ytri pointmap- eða dýptargögnum á NPY- eða NPZ-sniði.

Mörk á öryggisskori greiningar, sjálfgefið gildi líkansins ef því er sleppt. Gildi eru á bilinu 0.1 til 1.0; lægri gildi gefa minni nákvæmni en fleiri greiningar.

Fræ notað fyrir endurtekningarhæfa slembna efnisgerð.

sjálfgefið []

Punktamiðaðar kvaðningar fyrir sjálfvirka hlutgreiningu þegar grímur vantar.

sjálfgefið []

Rammakvaðningar sem skila stökum hlutagrímum fyrir 3D-endurgerð með sjálfvirkri hlutgreiningu; aðeins notaðar ef grímur eru ekki gefnar upp. Hægt er að senda marga ramma.

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

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Sam 3 · 3D Objects

Umbreytir hlutum á mynd í 3D-eignir. Veldu hluti með `mask_urls`, texta-`prompt`, `point_prompts` eða `box_prompts`; margir kassar gefa aðskilda hluti. `detection_threshold` tekur við gildum frá 0.1 til 1 og `export_textured_glb` bakar áferð og UV-hnit inn. Úttakið inniheldur GLB-skrá, Gaussian-splat-skrár, skrár fyrir hvern hlut í senum með mörgum hlutum, lýsigögn og zip-pakka.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
image_urláskilið image
Gerðurl · image
Slóð að mynd fyrir 3D-endurgerð.
mask_urlsvalfrjálst
Gerðurl[] · image
Valfrjáls listi yfir slóðir að grímum fyrir hvern hlut. Án gríma notar sjálfvirk hlutgreining kvaðningu, point_prompts eða box_prompts ef þau eru gefin upp; ef hvorki grímur né hlutgreiningarkvaðningar eru gefnar upp er öll myndin notuð.
promptvalfrjálst
Gerðstring | null
Sjálfgefiðcar
Texti fyrir sjálfvirka hlutgreiningu þegar grímur vantar, til dæmis 'chair' eða 'lamp'.
point_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Punktamiðaðar kvaðningar fyrir sjálfvirka hlutgreiningu þegar grímur vantar.
point_prompts[].xvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir X-ásnum.
point_prompts[].yvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir Y-ásnum.
point_prompts[].labelvalfrjálst
Gerðenum
01
Merkimiði fyrir forgrunn eða bakgrunn: 1 táknar forgrunn; 0 táknar bakgrunn.
point_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kvaðningar sem betrumbæta einn hlut. Ef texti er einnig gefinn upp sem kvaðning ákvarðar þetta auðkenni hvaða greindi hlutur punktarnir betrumbæta.
box_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Rammakvaðningar sem skila stökum hlutagrímum fyrir 3D-endurgerð með sjálfvirkri hlutgreiningu; aðeins notaðar ef grímur eru ekki gefnar upp. Hægt er að senda marga ramma.
box_prompts[].x_minvalfrjálst
Gerðinteger | null
Lágmark x-hnits fyrir reitinn.
box_prompts[].y_minvalfrjálst
Gerðinteger | null
Lágmark y-hnits fyrir reitinn.
box_prompts[].x_maxvalfrjálst
Gerðinteger | null
Hámark X-hnits kassans.
box_prompts[].y_maxvalfrjálst
Gerðinteger | null
Hámark Y-hnits kassans.
box_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kassa sem betrumbæta einn hlut.
seedvalfrjálst
Gerðinteger | null
Fræ notað fyrir endurtekningarhæfa slembna efnisgerð.
pointmap_urlvalfrjálst
Gerðstring | null
Valfrjáls slóð til að bæta dýptaráætlun í 3D-endurgerð með ytri pointmap- eða dýptargögnum á NPY- eða NPZ-sniði.
detection_thresholdvalfrjálst
Gerðnumber | null
0,1 – 1
Mörk á öryggisskori greiningar, sjálfgefið gildi líkansins ef því er sleppt. Gildi eru á bilinu 0.1 til 1.0; lægri gildi gefa minni nákvæmni en fleiri greiningar.
export_textured_glbvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Val á GLB-útflutningi: þegar þessi valkostur er virkur koma innbökuð áferð og UV-hnit í stað hornpunktslita.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

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"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
gaussian_splat
object {url, content_type, file_name, file_size}Sameinað sviðsskraut fyrir niðurstöður með mörgum hlutum, eða eitt skraut annars; sent sem Gaussian-splætuskrá á .ply-sniði.
model_glb
object {url, content_type, file_name, file_size}3D-úttak vistað sem GLB: mörgum hlutum er raðað saman í eitt svið, en aðrar niðurstöður innihalda eitt net.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Lýsigögn fyrir hvern hlut, þar á meðal snúning, færslu og kvarða.
individual_splats
array of object {url, content_type, file_name, file_size} | nullAðskildar Gaussian-splætuskrár fyrir hvern hlut, aðeins tiltækar í sviðum með mörgum hlutum.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullAðskildar GLB-netskrár fyrir hvern hlut, aðeins tiltækar í sviðum með mörgum hlutum.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP-safn með öllum afurðum og lýsigögnum.

Fleiri líkön: Mynd í 3D

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/sam-3/3d-objects.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt