Hoppa till innehåll

Segment Anything Model 3

Integrera

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

Den här begäran: ≈0,005 $ 5 API-krediter Kör den på den här sidan

Hämta API-nyckel
Meta Bildredigering #segmentation#mask#real-time

Bildsegmentering med text-, punkt- eller boxprompt som returnerar maskbilder, med valfria poäng och boxar

Meta · Bild

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

standard wheel

Textinstruktion som styr segmenteringen.

•obligatoriskt image_url
Släpp en fil eller

URL till bilden för segmentering.

Avancerat text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Äldre indata som behålls för bakåtkompatibilitet; använd 'prompt' i stället.

output_format standard png

Filformat för den resulterande bilden.

standard 3

Övre gräns för returnerade masker när `return_multiple_masks` är aktiverat.

standard []

Samling punktbaserade prompter.

standard []

Boxprompter vars object_id avgör grupperingen: matchande ID:n kopplar boxar till ett objekt, medan tomma ID:n representerar separata objekt. Flera boxar kan anges, var och en med koordinaterna (x_min, y_min, x_max, y_max).

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

Kör den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Segment Anything Model 3

Segmenterar en bild med SAM 3 från en textbaserad `prompt`, `point_prompts` eller `box_prompts`. När `return_multiple_masks` är aktiverad returneras upp till `max_masks` masker (1 till 32). Valfria konfidenspoäng och begränsningsboxar kan inkluderas. Utdataformatet är jpeg, png eller webp.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
image_urlobligatoriskt image
Typurl · image
URL till bilden för segmentering.
promptvalfritt
Typstring
Standardwheel
Textinstruktion som styr segmenteringen.
text_promptvalfritt
Typstring | null
[DEPRECATED] Äldre indata som behålls för bakåtkompatibilitet; använd 'prompt' i stället.
point_promptsvalfritt
Typobject[]
Standard[]
Samling punktbaserade prompter.
point_prompts[].xvalfritt
Typinteger | null
Promptens position längs X-axeln.
point_prompts[].yvalfritt
Typinteger | null
Promptens position längs Y-axeln.
point_prompts[].labelvalfritt
Typenum
01
Etikett för förgrund/bakgrund: 1 anger förgrund; 0 anger bakgrund.
point_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar prompter som förfinar ett enda objekt. Om text också anges som prompt avgör denna identifierare vilket upptäckt objekt punkterna förfinar.
point_prompts[].frame_indexvalfritt
Typinteger | null
Index som identifierar bildrutan för interaktion.
box_promptsvalfritt
Typobject[]
Standard[]
Boxprompter vars object_id avgör grupperingen: matchande ID:n kopplar boxar till ett objekt, medan tomma ID:n representerar separata objekt. Flera boxar kan anges, var och en med koordinaterna (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalfritt
Typinteger | null
Minsta x-koordinat för rutan.
box_prompts[].y_minvalfritt
Typinteger | null
Minsta y-koordinat för rutan.
box_prompts[].x_maxvalfritt
Typinteger | null
Maximal X-koordinat för boxen.
box_prompts[].y_maxvalfritt
Typinteger | null
Maximal Y-koordinat för boxen.
box_prompts[].object_idvalfritt
Typinteger | null
Valfri identifierare som grupperar boxar som förfinar ett enda objekt.
box_prompts[].frame_indexvalfritt
Typinteger | null
Index som identifierar bildrutan för interaktion.
apply_maskvalfritt
Typboolean
Standardtrue
Styr om masken tillämpas på bilden.
output_formatvalfritt
Typenum
Standardpng
jpegpngwebp
Filformat för den resulterande bilden.
return_multiple_masksvalfritt
Typboolean
Standardfalse
Alternativ för att returnera flera masker: när det aktiveras används `max_masks` för att avgöra hur många genererade masker som ska laddas upp och inkluderas i svaret.
max_masksvalfritt
Typinteger
Standard3
1 – 32
Övre gräns för returnerade masker när `return_multiple_masks` är aktiverat.
include_scoresvalfritt
Typboolean
Standardfalse
Styr om konfidenspoäng för masker inkluderas.
include_boxesvalfritt
Typboolean
Standardfalse
Styr om en begränsningsruta för varje mask inkluderas, om tillgänglig.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
image
object {url, content_type, file_name, file_size, width, height} | nullFörhandsvisning som visar den primära segmenteringsmasken.
masks
array of object {url, content_type, file_name, file_size, width, height}Bilder som innehåller segmenteringsmasker.
metadata
array of object {index, score, box} | nullMetadata för varje mask, inklusive dess poäng och ruta.
scores
array of number | nullKonfidenspoäng för varje mask, anges när den efterfrågas.
boxes
array of array of number | nullNormaliserade rutor för varje mask, uttryckta som [cx, cy, w, h], om de efterfrågas.

Fler modeller: Bildredigering

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/sam-3/image.md. Alla modeller och guider: https://doitong.com/developers/llms.txt