Ruka hadi kwenye maudhui

Sam 3 · 3D Objects

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: ≈$ 0.02 salio za API 20 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Meta Picha hadi 3D #3d#object

Hujenga vitu vya 3D kutoka kwenye picha, vilivyochaguliwa kwa vidokezo au maski za maandishi, pointi au visanduku, pamoja na matokeo ya splat

Meta · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

chaguomsingi car

Maandishi yanayotumika kwa segmentation ya kiotomatiki ikiwa maski hazipo, kama vile 'chair' au 'lamp'.

•inahitajika image_url
Dondosha faili, au

URL ya picha kwa uundaji upya wa 3D.

Ya kina mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Dondosha faili, au

Orodha ya hiari ya URL za maski kwa kila kitu. Bila maski, segmentation ya kiotomatiki hutumia kidokezo, point_prompts au box_prompts zikipeanwa; ikiwa maski wala vidokezo vya segmentation havijatolewa, picha nzima hutumiwa.

URL ya hiari ya kuboresha ukadiriaji wa kina katika uundaji upya wa 3D kwa kutoa pointmap au data ya kina ya nje kama NPY au NPZ.

Kikomo cha kujiamini cha utambuzi, kinachoachwa kwenye thamani chaguomsingi ya modeli kisipotolewa. Thamani ziko kati ya 0.1 na 1.0, huku thamani ndogo zikibadilisha usahihi kwa kuongeza idadi ya utambuzi.

Seed inayotumika kwa uzalishaji wa nasibu unaoweza kurudiwa.

chaguomsingi []

Vidokezo vinavyotegemea nukta vinavyotumika kwa segmentation ya kiotomatiki ikiwa maski hazipo.

chaguomsingi []

Vidokezo vya visanduku vinavyotoa maski za vitu binafsi kwa uundaji upya wa 3D kupitia segmentation ya kiotomatiki, vinavyotumika tu maski zisipotolewa. Visanduku vingi vinaweza kutumwa.

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

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Sam 3 · 3D Objects

Hubadilisha vitu kwenye picha kuwa mali za 3D. Chagua vitu kwa `mask_urls`, `prompt` ya maandishi, `point_prompts` au `box_prompts`; visanduku vingi hutoa vitu tofauti. `detection_threshold` inakubali 0.1 hadi 1, na `export_textured_glb` huunganisha tekstura na UV. Hutoa GLB, faili za Gaussian splat, faili kwa kila kitu katika mandhari yenye vitu vingi, metadata na kifurushi cha zip.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
URL ya picha kwa uundaji upya wa 3D.
mask_urlssi lazima
Ainaurl[] · image
Orodha ya hiari ya URL za maski kwa kila kitu. Bila maski, segmentation ya kiotomatiki hutumia kidokezo, point_prompts au box_prompts zikipeanwa; ikiwa maski wala vidokezo vya segmentation havijatolewa, picha nzima hutumiwa.
promptsi lazima
Ainastring | null
Chaguomsingicar
Maandishi yanayotumika kwa segmentation ya kiotomatiki ikiwa maski hazipo, kama vile 'chair' au 'lamp'.
point_promptssi lazima
Ainaobject[]
Chaguomsingi[]
Vidokezo vinavyotegemea nukta vinavyotumika kwa segmentation ya kiotomatiki ikiwa maski hazipo.
point_prompts[].xsi lazima
Ainainteger | null
Nafasi ya kidokezo kwenye mhimili wa X.
point_prompts[].ysi lazima
Ainainteger | null
Nafasi ya kidokezo kwenye mhimili wa Y.
point_prompts[].labelsi lazima
Ainaenum
01
Lebo ya mandhari ya mbele/mandharinyuma: 1 huonyesha mandhari ya mbele; 0 huonyesha mandharinyuma.
point_prompts[].object_idsi lazima
Ainainteger | null
Kitambulisho cha hiari kinachopanga vidokezo vinavyoboresha kitu kimoja. Ikiwa maandishi pia yametolewa kama kidokezo, kitambulisho hiki huamua ni kitu gani kilichogunduliwa ambacho pointi hizo huboresha.
box_promptssi lazima
Ainaobject[]
Chaguomsingi[]
Vidokezo vya visanduku vinavyotoa maski za vitu binafsi kwa uundaji upya wa 3D kupitia segmentation ya kiotomatiki, vinavyotumika tu maski zisipotolewa. Visanduku vingi vinaweza kutumwa.
box_prompts[].x_minsi lazima
Ainainteger | null
Koordinati ya chini ya x ya kisanduku.
box_prompts[].y_minsi lazima
Ainainteger | null
Koordinati ya chini ya y ya kisanduku.
box_prompts[].x_maxsi lazima
Ainainteger | null
Kiwianishi cha juu zaidi cha X cha kisanduku.
box_prompts[].y_maxsi lazima
Ainainteger | null
Kiwianishi cha juu zaidi cha Y cha kisanduku.
box_prompts[].object_idsi lazima
Ainainteger | null
Kitambulisho cha hiari kinachopanga visanduku vinavyoboresha kitu kimoja.
seedsi lazima
Ainainteger | null
Seed inayotumika kwa uzalishaji wa nasibu unaoweza kurudiwa.
pointmap_urlsi lazima
Ainastring | null
URL ya hiari ya kuboresha ukadiriaji wa kina katika uundaji upya wa 3D kwa kutoa pointmap au data ya kina ya nje kama NPY au NPZ.
detection_thresholdsi lazima
Ainanumber | null
0.1 – 1
Kikomo cha kujiamini cha utambuzi, kinachoachwa kwenye thamani chaguomsingi ya modeli kisipotolewa. Thamani ziko kati ya 0.1 na 1.0, huku thamani ndogo zikibadilisha usahihi kwa kuongeza idadi ya utambuzi.
export_textured_glbsi lazima
Ainaboolean
Chaguomsingifalse
Chaguo la usafirishaji wa GLB: kuwezesha chaguo hili hubadilisha rangi za vertex kuwa texture iliyookwa na UVs.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
gaussian_splat
object {url, content_type, file_name, file_size}Splat ya tukio lililounganishwa kwa matokeo yenye vitu vingi, au splat moja vinginevyo; hutolewa kama faili la Gaussian splat katika muundo wa .ply.
model_glb
object {url, content_type, file_name, file_size}Tokeo la 3D lililohifadhiwa kama GLB: vitu vingi hukusanywa katika tukio moja, huku matokeo mengine yakiwa na mesh moja.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata ya kila kitu, ikijumuisha mzunguko, tafsiri na skeli.
individual_splats
array of object {url, content_type, file_name, file_size} | nullFaili tofauti za Gaussian splat kwa kila kitu, zinazopatikana tu katika matukio yenye vitu vingi.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullFaili tofauti za mesh za GLB kwa kila kitu, zinazopatikana tu katika matukio yenye vitu vingi.
artifacts_zip
object {url, content_type, file_name, file_size} | nullKumbukumbu ya ZIP ya viunzi vyote pamoja na metadata.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/sam-3/3d-objects.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt