Gå til innhold

Segment Anything Model 3

Integrer

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Denne forespørselen: ≈0,005 $ 5 API-kreditter · ≈ 0,53 ₽ Kjør den på denne siden

Hent API-nøkkel
Meta Bilderedigering #segmentation#mask#real-time

Bildeinndeling styrt av tekst-, punkt- eller boksledetekst som returnerer maskebilder, med valgfrie skårer og bokser

Meta · Bilde

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

standard wheel

Tekstinstruksjon som styrer segmenteringen.

•obligatorisk image_url
Slipp en fil, eller

URL til bildet som skal segmenteres.

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

[DEPRECATED] Eldre inndata beholdt for bakoverkompatibilitet; bruk 'prompt' i stedet.

output_format standard png

Filformat for det resulterende bildet.

standard 3

Øvre grense for returnerte masker når `return_multiple_masks` er aktivert.

standard []

Samling av punktbaserte prompter.

standard []

Boksprompter der object_id bestemmer grupperingen: samsvarende ID-er knytter bokser til ett objekt, mens tomme ID-er representerer separate objekter. Flere bokser kan oppgis, hver med koordinatene (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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Segment Anything Model 3

Segmenterer et bilde med SAM 3 fra en tekstlig `prompt`, `point_prompts` eller `box_prompts`. Når `return_multiple_masks` er aktivert, returneres opptil `max_masks` masker (1 til 32). Valgfrie konfidensskårer og avgrensningsbokser kan inkluderes. Utdataformatet er jpeg, png eller webp.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
image_urlobligatorisk image
Typeurl · image
URL til bildet som skal segmenteres.
promptvalgfritt
Typestring
Standardwheel
Tekstinstruksjon som styrer segmenteringen.
text_promptvalgfritt
Typestring | null
[DEPRECATED] Eldre inndata beholdt for bakoverkompatibilitet; bruk 'prompt' i stedet.
point_promptsvalgfritt
Typeobject[]
Standard[]
Samling av punktbaserte prompter.
point_prompts[].xvalgfritt
Typeinteger | null
Promptens posisjon langs X-aksen.
point_prompts[].yvalgfritt
Typeinteger | null
Promptens posisjon langs Y-aksen.
point_prompts[].labelvalgfritt
Typeenum
01
Forgrunns-/bakgrunnsetikett: 1 angir forgrunn; 0 angir bakgrunn.
point_prompts[].object_idvalgfritt
Typeinteger | null
Valgfri identifikator som grupperer prompter som forbedrer ett enkelt objekt. Hvis tekst også oppgis som en prompt, bestemmer denne identifikatoren hvilket registrerte objekt punktene forbedrer.
point_prompts[].frame_indexvalgfritt
Typeinteger | null
Indeks som identifiserer bildet for interaksjon.
box_promptsvalgfritt
Typeobject[]
Standard[]
Boksprompter der object_id bestemmer grupperingen: samsvarende ID-er knytter bokser til ett objekt, mens tomme ID-er representerer separate objekter. Flere bokser kan oppgis, hver med koordinatene (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalgfritt
Typeinteger | null
Minste x-koordinat for boksen.
box_prompts[].y_minvalgfritt
Typeinteger | null
Minste y-koordinat for boksen.
box_prompts[].x_maxvalgfritt
Typeinteger | null
Maksimal X-koordinat for boksen.
box_prompts[].y_maxvalgfritt
Typeinteger | null
Maksimal Y-koordinat for boksen.
box_prompts[].object_idvalgfritt
Typeinteger | null
Valgfri identifikator som grupperer bokser som forbedrer ett enkelt objekt.
box_prompts[].frame_indexvalgfritt
Typeinteger | null
Indeks som identifiserer bildet for interaksjon.
apply_maskvalgfritt
Typeboolean
Standardtrue
Kontrollerer om masken brukes på bildet.
output_formatvalgfritt
Typeenum
Standardpng
jpegpngwebp
Filformat for det resulterende bildet.
return_multiple_masksvalgfritt
Typeboolean
Standardfalse
Alternativ for retur av flere masker: aktivering bruker `max_masks` til å bestemme hvor mange genererte masker som skal lastes opp og inkluderes i svaret.
max_masksvalgfritt
Typeinteger
Standard3
1 – 32
Øvre grense for returnerte masker når `return_multiple_masks` er aktivert.
include_scoresvalgfritt
Typeboolean
Standardfalse
Kontrollerer om konfidensskårer for masker inkluderes.
include_boxesvalgfritt
Typeboolean
Standardfalse
Kontrollerer om en avgrensningsboks inkluderes for hver maske, hvis tilgjengelig.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
image
object {url, content_type, file_name, file_size, width, height} | nullForhåndsvisning som viser den primære segmenteringsmasken.
masks
array of object {url, content_type, file_name, file_size, width, height}Bilder som inneholder segmenteringsmasker.
metadata
array of object {index, score, box} | nullMetadata for hver maske, inkludert poengsummen og boksen.
scores
array of number | nullKonfidenspoengsum for hver maske, oppgitt når det etterspørres.
boxes
array of array of number | nullNormaliserte bokser for hver maske, uttrykt som [cx, cy, w, h], hvis etterspurt.

Flere modeller: Bilderedigering

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/sam-3/image.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt