Pāriet uz saturu

Sam 3 1 · Image

Integrēt

Modeļa id sam-3-1/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-1/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"

Šis pieprasījums: ≈0,01 $ 10 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Meta Attēlu rediģēšana #segmentation#mask#real-time

SAM 3.1 attēlu segmentēšana pēc teksta, punkta vai lodziņa promptiem, atgriežot masku attēlus

Meta · Attēls

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

noklusējums wheel

Segmentēšanu vadoša teksta instrukcija.

•obligāts image_url
Nometiet failu vai

Attēla segmentēšanai paredzētais URL.

Papildu output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format noklusējums png

Iegūtā attēla faila formāts.

noklusējums 3

Atgriežamo masku maksimālais skaits, ja ir iespējots `return_multiple_masks`.

noklusējums []

Punktos balstītu uzvedņu kolekcija.

noklusējums []

Kastes uzvednes, kuru object_id nosaka grupēšanu: atbilstoši ID saista kastes ar vienu objektu, bet tukši ID apzīmē atsevišķus objektus. Var norādīt vairākas kastes, katrai izmantojot koordinātas (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/image?wait=20 cena → 0,01 $
# 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-1/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"

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Sam 3 1 · Image

Segmentē vienu attēlu ar SAM 3.1, izmantojot teksta `prompt`, `point_prompts` vai `box_prompts`. Vairākus lodziņus var grupēt vienā objektā ar object_id. `return_multiple_masks` atgriež līdz `max_masks` maskām (1 līdz 32) ar neobligātiem rezultātu rādītājiem un ierobežojošajiem lodziņiem. Izvades formāts ir jpeg, png vai webp.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlobligāts image
Tipsurl · image
Attēla segmentēšanai paredzētais URL.
promptneobligāts
Tipsstring
Noklusējumswheel
Segmentēšanu vadoša teksta instrukcija.
point_promptsneobligāts
Tipsobject[]
Noklusējums[]
Punktos balstītu uzvedņu kolekcija.
point_prompts[].xneobligāts
Tipsinteger | null
Uzvednes pozīcija gar X asi.
point_prompts[].yneobligāts
Tipsinteger | null
Uzvednes pozīcija gar Y asi.
point_prompts[].labelneobligāts
Tipsenum
01
Priekšplāna/fona etiķete: 1 norāda priekšplānu, 0 — fonu.
point_prompts[].object_idneobligāts
Tipsinteger | null
Neobligāts identifikators, kas grupē vienu objektu precizējošās uzvednes. Ja kā uzvedne tiek norādīts arī teksts, šis identifikators nosaka, kuru atklāto objektu šie punkti precizē.
point_prompts[].frame_indexneobligāts
Tipsinteger | null
Mijiedarbības kadru identificējošais indekss.
box_promptsneobligāts
Tipsobject[]
Noklusējums[]
Kastes uzvednes, kuru object_id nosaka grupēšanu: atbilstoši ID saista kastes ar vienu objektu, bet tukši ID apzīmē atsevišķus objektus. Var norādīt vairākas kastes, katrai izmantojot koordinātas (x_min, y_min, x_max, y_max).
box_prompts[].x_minneobligāts
Tipsinteger | null
Taisnstūra minimālā x koordināta.
box_prompts[].y_minneobligāts
Tipsinteger | null
Taisnstūra minimālā y koordināta.
box_prompts[].x_maxneobligāts
Tipsinteger | null
Kastes maksimālā X koordināta.
box_prompts[].y_maxneobligāts
Tipsinteger | null
Kastes maksimālā Y koordināta.
box_prompts[].object_idneobligāts
Tipsinteger | null
Neobligāts identifikators, kas grupē vienu objektu precizējošās kastes.
box_prompts[].frame_indexneobligāts
Tipsinteger | null
Mijiedarbības kadru identificējošais indekss.
apply_maskneobligāts
Tipsboolean
Noklusējumstrue
Kontrolē, vai attēlam tiek lietota maska.
output_formatneobligāts
Tipsenum
Noklusējumspng
jpegpngwebp
Iegūtā attēla faila formāts.
return_multiple_masksneobligāts
Tipsboolean
Noklusējumsfalse
Vairāku masku atgriešanas opcija: iespējošana izmanto `max_masks`, lai noteiktu augšupielādējamo un atbildē iekļaujamo ģenerēto masku skaitu.
max_masksneobligāts
Tipsinteger
Noklusējums3
1 – 32
Atgriežamo masku maksimālais skaits, ja ir iespējots `return_multiple_masks`.
include_scoresneobligāts
Tipsboolean
Noklusējumsfalse
Kontrolē ticamības vērtību iekļaušanu maskām.
include_boxesneobligāts
Tipsboolean
Noklusējumsfalse
Kontrolē ierobežojošā rāmja iekļaušanu katrai maskai, ja tas ir pieejams.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/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": 10,
    "usd": "0.01",
    "charged": 10,
    "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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
image
object {url, content_type, file_name, file_size, width, height} | nullPriekšskatījums ar primāro segmentēšanas masku.
masks
array of object {url, content_type, file_name, file_size, width, height}Attēli, kas satur segmentēšanas maskas.
metadata
array of object {index, score, box} | nullMetadati par katru masku, tostarp tās vērtējums un rāmis.
scores
array of number | nullKatras maskas ticamības vērtējums, kas tiek sniegts pēc pieprasījuma.
boxes
array of array of number | nullNormalizēti rāmji katrai maskai formātā [cx, cy, w, h], ja pieprasīts.

Vairāk modeļu: Attēlu rediģēšana

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/sam-3-1/image.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt