Peke ki ngā ihirangi

Sam 3 · 3D Objects

Whakauru

id tauira 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"

Tēnei tono: ≈$ 0.02 20 whiwhinga API Whakahaerehia ki tēnei whārangi

Tikina he kī API
Meta · 3D

Kei konei tō hua tuatahi

Hangaia he tono ki raro nei, ka whakahaere mā tō kī API. Ka tāruatia ngā putanga ki tō mātou rokiroki, ka puritia mō ake tonu atu, mō rānei 7 rā mō te kore utu.

Hangaia he tono

Ka hangaia ngā mana whakahaere mai i te aronuinga o te tauira. Ka whakahoungia te waehere me te utu ina whakarerekē koe.

taunoa car

Kuputuhi mō te wehewehenga aunoa ina kore he kanohi huna, pērā i te 'chair' me te 'lamp'.

•e hiahiatia ana image_url
Whakataka he kōnae,

URL atahanga mō te hanga anō 3D.

Arā atu mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Whakataka he kōnae,

Rārangi URL kanohi huna kōwhiringa mō ia mea. Ki te kore he kanohi huna, ka whakamahi te wehewehenga aunoa i te tohutohu, point_prompts, box_prompts rānei mēnā ka tukuna; ki te kore ngā kanohi huna me ngā tohutohu wehewehenga, ka whakamahia te atahanga katoa.

URL kōwhiringa hei whakapai ake i te whakatau hōhonutanga mō te hanga anō 3D, mā te tuku raraunga pointmap, hōhonutanga rānei o waho hei NPY, NPZ rānei.

Te paepae māia rapunga, ka waiho ki te taunoa o te tauira ina kore e tukuna. Ko te awhe 0.1 ki te 1.0; mā ngā uara iti ka nui ake ngā rapunga, ka heke te tōtika.

Te kākano e whakamahia ana mō te whakaputa matapōkere tukurua.

taunoa []

Ngā tohutohu ā-ira mō te wehewehenga aunoa ina kore he kanohi huna.

taunoa []

Ngā tohutohu pouaka ka whakaputa kanohi huna mō ia mea mō te hanga anō 3D mā te wehewehenga aunoa; ka whakamahia ina kore he kanohi huna. Ka taea te tuku pouaka maha.

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

Whakahaerehia tēnei tono

Ka noho tō kī ki tēnei pūtirotiro: ka tukuna ki te Doitong API anake, ā, ka tiakina ki te localStorage anake ina tohua e koe te Mahara. Tikina he kī API

Mō Sam 3 · 3D Objects

Ka huri i ngā ahanoa kei roto i tētahi whakaahua hei rawa 3D. Kōwhiria ngā ahanoa mā `mask_urls`, tētahi `prompt` kuputuhi, `point_prompts` rānei `box_prompts`; mā ngā pouaka maha e wehe ai ngā ahanoa. Ka whakaae `detection_threshold` ki te 0.1 ki te 1, ā, mā `export_textured_glb` e tāmau te kakano me ngā UV. Ko ngā putanga he GLB, ngā kōnae Gaussian splat, ngā kōnae mō ia ahanoa i ngā āhuatanga maha, ngā raraunga whaitua me tētahi paihere zip.

Ngā tawhā

Tukuna te ingoa tōmua, te ingoa taketake rānei, kaua e rua. Ngā ingoa tōmua

IngoaMomo TaunoaE whakaaetia ana Whakamārama
image_urle hiahiatia ana image
Momourl · image
URL atahanga mō te hanga anō 3D.
mask_urlskōwhiringa
Momourl[] · image
Rārangi URL kanohi huna kōwhiringa mō ia mea. Ki te kore he kanohi huna, ka whakamahi te wehewehenga aunoa i te tohutohu, point_prompts, box_prompts rānei mēnā ka tukuna; ki te kore ngā kanohi huna me ngā tohutohu wehewehenga, ka whakamahia te atahanga katoa.
promptkōwhiringa
Momostring | null
Taunoacar
Kuputuhi mō te wehewehenga aunoa ina kore he kanohi huna, pērā i te 'chair' me te 'lamp'.
point_promptskōwhiringa
Momoobject[]
Taunoa[]
Ngā tohutohu ā-ira mō te wehewehenga aunoa ina kore he kanohi huna.
point_prompts[].xkōwhiringa
Momointeger | null
Tūranga o te tohutohu i te tuaka X.
point_prompts[].ykōwhiringa
Momointeger | null
Tūranga o te tohutohu i te tuaka Y.
point_prompts[].labelkōwhiringa
Momoenum
01
Tapanga papamua/papamuri: ko te 1 te papamua; ko te 0 te papamuri.
point_prompts[].object_idkōwhiringa
Momointeger | null
Pūtautuhi kōwhiringa hei whakarōpū i ngā tohutohu e whakamahine ana i te mea kotahi. Mēnā ka tukuna hoki te kuputuhi hei tohutohu, mā tēnei pūtautuhi e whakatau ko tēhea mea kua kitea e whakamahinetia ana e aua ira.
box_promptskōwhiringa
Momoobject[]
Taunoa[]
Ngā tohutohu pouaka ka whakaputa kanohi huna mō ia mea mō te hanga anō 3D mā te wehewehenga aunoa; ka whakamahia ina kore he kanohi huna. Ka taea te tuku pouaka maha.
box_prompts[].x_minkōwhiringa
Momointeger | null
Te taunga x iti rawa mō te pouaka.
box_prompts[].y_minkōwhiringa
Momointeger | null
Te taunga y iti rawa mō te pouaka.
box_prompts[].x_maxkōwhiringa
Momointeger | null
Taunga X mōrahi mō te pouaka.
box_prompts[].y_maxkōwhiringa
Momointeger | null
Taunga Y mōrahi mō te pouaka.
box_prompts[].object_idkōwhiringa
Momointeger | null
Pūtautuhi kōwhiringa hei whakarōpū i ngā pouaka e whakamahine ana i te mea kotahi.
seedkōwhiringa
Momointeger | null
Te kākano e whakamahia ana mō te whakaputa matapōkere tukurua.
pointmap_urlkōwhiringa
Momostring | null
URL kōwhiringa hei whakapai ake i te whakatau hōhonutanga mō te hanga anō 3D, mā te tuku raraunga pointmap, hōhonutanga rānei o waho hei NPY, NPZ rānei.
detection_thresholdkōwhiringa
Momonumber | null
0.1 – 1
Te paepae māia rapunga, ka waiho ki te taunoa o te tauira ina kore e tukuna. Ko te awhe 0.1 ki te 1.0; mā ngā uara iti ka nui ake ngā rapunga, ka heke te tōtika.
export_textured_glbkōwhiringa
Momoboolean
Taunoafalse
Kōwhiringa kaweake GLB: mā te whakahohe ka whakakapi ngā tae pito ki tētahi kakano tunua me ngā UV.
e hiahiatia ana Ingoa tōmua, e whakaaetia ana hoki

Mō ngā tawhā kōnae, whakamahia he URL tūmatanui https://, he URI data: tae atu ki te 10 MB, he file_url rānei o tētahi tukuake. Ngā kōnae

Putanga

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"
  }
}
Ō kōnae, māu e whiriwhiriKo ia url o outputs[] he tārua kei tō mātou rokiroki: ka puritia mō ake tonu atu (ka utua ia GB-marama) mō rānei 7 rā mō te kore utu, e ai ki ngā tautuhinga o tō pūkete, ki te ?storage= rānei.
He ōrite te hanga ki ia tauiratype, url, content_type, width, height me duration, mō ngā pikitia, ataata me te oro. Ko output te ahanoa hua ake o te tauira.
Ngā āpure o te putanga
gaussian_splat
object {url, content_type, file_name, file_size}He splat tirohanga hanumi mō ngā putanga maha ngā mea, he splat kotahi rānei; ka tukuna hei kōnae Gaussian splat .ply.
model_glb
object {url, content_type, file_name, file_size}Putanga 3D kua tiakina hei GLB: ka whakahuihui ngā mea maha ki te tirohanga kotahi, ā, kotahi te mata o ērā atu putanga.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Ngā raraunga mō ia mea, tae atu ki te hurihanga, te nekehanga me te tauine.
individual_splats
array of object {url, content_type, file_name, file_size} | nullNgā kōnae Gaussian splat motuhake mō ia mea, ka wātea i ngā tirohanga maha ngā mea anake.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullNgā kōnae mata GLB motuhake mō ia mea, ka wātea i ngā tirohanga maha ngā mea anake.
artifacts_zip
object {url, content_type, file_name, file_size} | nullHe pūranga ZIP o ngā rawa katoa me ngā raraunga.

Ētahi atu tauira: Atahanga ki te 3D

Mō ngā āpiha AI: kei te wātea tēnei whārangi hei Markdown ki https://doitong.com/mi/developers/models/sam-3/3d-objects.md. Ngā tauira me ngā aratohu katoa: https://doitong.com/developers/llms.txt