Pereiti prie turinio

Sam 3 1 · Image

Integruoti

Modelio 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"

Ši užklausa: ≈0,01 $ 10 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Meta Vaizdo redagavimas #segmentation#mask#real-time

SAM 3.1 vaizdų segmentavimas pagal tekstinius, taško arba langelio raginį, grąžinantis kaukės vaizdus

Meta · Vaizdas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

numatytoji wheel

Segmentavimą valdanti tekstinė instrukcija.

•privaloma image_url
Įmeskite failą arba

Segmentuojamo vaizdo URL.

Išplėstiniai output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format numatytoji png

Galutinio vaizdo failo formatas.

numatytoji 3

Grąžinamų kaukių didžiausias skaičius, kai įjungta `return_multiple_masks`.

numatytoji []

Taškiniais raginiais pagrįstų raginimų rinkinys.

numatytoji []

Dėžutės raginiai, kurių object_id nustato grupavimą: sutampantys ID susieja dėžutes su vienu objektu, o tušti ID reiškia atskirus objektus. Galima pateikti kelias dėžutes, kiekvienai naudojant koordinates (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/image?wait=20 kaina → 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"

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Sam 3 1 · Image

Segmentuoja vieną vaizdą naudodamas SAM 3.1 ir tekstinį `prompt`, `point_prompts` arba `box_prompts`. Kelis stačiakampius galima sugrupuoti vienam objektui naudojant object_id. `return_multiple_masks` grąžina iki `max_masks` kaukių (1–32), pasirinktinai su balais ir ribojančiaisiais stačiakampiais. Išvesties formatas yra jpeg, png arba webp.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Segmentuojamo vaizdo URL.
promptneprivalomas
Tipasstring
Numatytoji reikšmėwheel
Segmentavimą valdanti tekstinė instrukcija.
point_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Taškiniais raginiais pagrįstų raginimų rinkinys.
point_prompts[].xneprivalomas
Tipasinteger | null
Raginio padėtis X ašyje.
point_prompts[].yneprivalomas
Tipasinteger | null
Raginio padėtis Y ašyje.
point_prompts[].labelneprivalomas
Tipasenum
01
Priekinio plano / fono etiketė: 1 nurodo priekinį planą, 0 – foną.
point_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančius raginimus. Jei kaip raginys taip pat pateikiamas tekstas, šis identifikatorius nurodo, kurį aptiktą objektą šie taškai tikslina.
point_prompts[].frame_indexneprivalomas
Tipasinteger | null
Sąveikai skirtą kadrą identifikuojantis indeksas.
box_promptsneprivalomas
Tipasobject[]
Numatytoji reikšmė[]
Dėžutės raginiai, kurių object_id nustato grupavimą: sutampantys ID susieja dėžutes su vienu objektu, o tušti ID reiškia atskirus objektus. Galima pateikti kelias dėžutes, kiekvienai naudojant koordinates (x_min, y_min, x_max, y_max).
box_prompts[].x_minneprivalomas
Tipasinteger | null
Mažiausia langelio x koordinatė.
box_prompts[].y_minneprivalomas
Tipasinteger | null
Mažiausia langelio y koordinatė.
box_prompts[].x_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės X koordinatė.
box_prompts[].y_maxneprivalomas
Tipasinteger | null
Didžiausia dėžutės Y koordinatė.
box_prompts[].object_idneprivalomas
Tipasinteger | null
Pasirinktinis identifikatorius, grupuojantis vieną objektą tikslinančias dėžutes.
box_prompts[].frame_indexneprivalomas
Tipasinteger | null
Sąveikai skirtą kadrą identifikuojantis indeksas.
apply_maskneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Nurodo, ar vaizdui taikoma kaukė.
output_formatneprivalomas
Tipasenum
Numatytoji reikšmėpng
jpegpngwebp
Galutinio vaizdo failo formatas.
return_multiple_masksneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Kelių kaukių grąžinimo parinktis: ją įjungus, naudojant `max_masks` nustatoma, kiek sugeneruotų kaukių įkelti ir įtraukti į atsaką.
max_masksneprivalomas
Tipasinteger
Numatytoji reikšmė3
1 – 32
Grąžinamų kaukių didžiausias skaičius, kai įjungta `return_multiple_masks`.
include_scoresneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Nurodo, ar įtraukti kaukių pasikliautinumo balus.
include_boxesneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Nurodo, ar įtraukti kiekvienos kaukės ribojantį langelį, jei jis pasiekiamas.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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ūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
image
object {url, content_type, file_name, file_size, width, height} | nullPeržiūra, kurioje rodoma pagrindinė segmentavimo kaukė.
masks
array of object {url, content_type, file_name, file_size, width, height}Vaizdai, kuriuose yra segmentavimo kaukės.
metadata
array of object {index, score, box} | nullKiekvienos kaukės metaduomenys, įskaitant jos balą ir langelį.
scores
array of number | nullKiekvienos kaukės pasikliautinumo balas, pateikiamas paprašius.
boxes
array of array of number | nullNormalizuoti kiekvienos kaukės langeliai, išreikšti kaip [cx, cy, w, h], jei paprašyta.

Daugiau modelių: Vaizdo redagavimas

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sam-3-1/image.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt