Peke ki ngā ihirangi

Segment Anything Model 3

Whakauru

id tauira sam-3/image
# 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/image?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.005 5 whiwhinga API Whakahaerehia ki tēnei whārangi

Tikina he kī API
Meta Whakatika Atahanga #segmentation#mask#real-time

Wehewehea ai te whakaahua mā te akiaki kuputuhi, ira, pouaka rānei, ka whakahoki whakaahua kopare, me ngā kaute me ngā pouaka kōwhiri

Meta · Atahanga

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 wheel

Tohutohu kuputuhi hei ārahi i te wehewehe.

•e hiahiatia ana image_url
Whakataka he kōnae,

URL e tohu ana ki te atahanga hei wehewehe.

Arā atu text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] He tāuru tuku iho kua puritia mō te hototahi whakamuri; whakamahia te 'prompt' hei whakakapi.

output_format taunoa png

Te hōputu kōnae mō te atahanga ka puta.

taunoa 3

Te rohe whakarunga mō ngā kanohi ka whakahokia ina whakakāhia `return_multiple_masks`.

taunoa []

Kohinga tohutohu ā-ira.

taunoa []

Ngā tohutohu pouaka, mā te object_id e whakatau te whakarōpū: mā ngā ID ōrite e hono ngā pouaka ki te mea kotahi, ā, ko ngā ID wātea he mea motuhake. Ka taea te tuku pouaka maha, me ngā taunga (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 utu → $ 0.005
# 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/image?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ō Segment Anything Model 3

Ka wehewehe i tētahi whakaahua ki SAM 3 mā te `prompt` kuputuhi, `point_prompts` rānei `box_prompts`. Ina whakakāhia `return_multiple_masks`, ka whakahoki atu ki te `max_masks` kopare (1 ki te 32). Ka taea te whakauru i ngā kaute māia me ngā pouaka rohe kōwhiri. Ko te hōputu putanga he jpeg, png, webp rānei.

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 e tohu ana ki te atahanga hei wehewehe.
promptkōwhiringa
Momostring
Taunoawheel
Tohutohu kuputuhi hei ārahi i te wehewehe.
text_promptkōwhiringa
Momostring | null
[DEPRECATED] He tāuru tuku iho kua puritia mō te hototahi whakamuri; whakamahia te 'prompt' hei whakakapi.
point_promptskōwhiringa
Momoobject[]
Taunoa[]
Kohinga tohutohu ā-ira.
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.
point_prompts[].frame_indexkōwhiringa
Momointeger | null
Taupū e tautuhi ana i te anga mō te taunekeneke.
box_promptskōwhiringa
Momoobject[]
Taunoa[]
Ngā tohutohu pouaka, mā te object_id e whakatau te whakarōpū: mā ngā ID ōrite e hono ngā pouaka ki te mea kotahi, ā, ko ngā ID wātea he mea motuhake. Ka taea te tuku pouaka maha, me ngā taunga (x_min, y_min, x_max, y_max).
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.
box_prompts[].frame_indexkōwhiringa
Momointeger | null
Taupū e tautuhi ana i te anga mō te taunekeneke.
apply_maskkōwhiringa
Momoboolean
Taunoatrue
Ka whakahaere mēnā ka whakamahia te kanohi ki te atahanga.
output_formatkōwhiringa
Momoenum
Taunoapng
jpegpngwebp
Te hōputu kōnae mō te atahanga ka puta.
return_multiple_maskskōwhiringa
Momoboolean
Taunoafalse
Kōwhiringa whakahoki kanohi maha: mā te whakakā ka whakamahi i `max_masks` hei whakatau i te maha o ngā kanohi ka whakaputaina, ka tuku ki te whakautu.
max_maskskōwhiringa
Momointeger
Taunoa3
1 – 32
Te rohe whakarunga mō ngā kanohi ka whakahokia ina whakakāhia `return_multiple_masks`.
include_scoreskōwhiringa
Momoboolean
Taunoafalse
Ka whakahaere mēnā ka whakaurua ngā kaute māia mō ngā kanohi.
include_boxeskōwhiringa
Momoboolean
Taunoafalse
Ka whakahaere mēnā ka whakaurua he pouaka here mō ia kanohi, mēnā e wātea ana.
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/image",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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,
      "width": 1024,
      "height": 768
    },
    "masks": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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
image
object {url, content_type, file_name, file_size, width, height} | nullArokite e whakaatu ana i te kanohi wehewehe matua.
masks
array of object {url, content_type, file_name, file_size, width, height}Ngā atahanga kei roto ngā kanohi wehewehe.
metadata
array of object {index, score, box} | nullNgā raraunga mō ia kanohi huna, tae atu ki tōna kaute me te pouaka.
scores
array of number | nullTe kaute māia mō ia kanohi huna, ka tukuna ina tonoa.
boxes
array of array of number | nullNgā pouaka kua whakaritea mō ia kanohi huna, hei [cx, cy, w, h], ina tonoa.

Ētahi atu tauira: Whakatika Atahanga

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