Gå til indhold

Segment Anything Model 3

Integrer

Model-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 anmodning: ≈0,005 $ 5 API-kreditter · ≈ 0,53 ₽ Kør den på denne side

Hent API-nøgle
Meta Billedredigering #segmentation#mask#real-time

Billedsegmentering med tekst-, punkt- eller boks-prompt, der returnerer maskebilleder med valgfri score og bokse

Meta · Billede

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

standard wheel

Tekstinstruktion, der styrer segmenteringen.

•påkrævet image_url
Slip en fil, eller

URL til billedet til segmentering.

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

[DEPRECATED] Ældre input, der bevares af hensyn til bagudkompatibilitet; brug 'prompt' i stedet.

output_format standard png

Filformat for det resulterende billede.

standard 3

Øvre grænse for returnerede masker, når `return_multiple_masks` er aktiveret.

standard []

Samling af punktbaserede prompts.

standard []

Boks-prompts, hvis object_id bestemmer grupperingen: matchende ID'er knytter bokse til ét objekt, mens tomme ID'er repræsenterer separate objekter. Flere bokse kan angives, hver med koordinaterne (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"

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Segment Anything Model 3

Segmenterer et billede med SAM 3 ud fra en tekstlig `prompt`, `point_prompts` eller `box_prompts`. Når `return_multiple_masks` er aktiveret, returneres op til `max_masks` masker (1 til 32). Valgfrie konfidensscorer og afgrænsningsbokse kan inkluderes. Outputformatet er jpeg, png eller webp.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
image_urlpåkrævet image
Typeurl · image
URL til billedet til segmentering.
promptvalgfri
Typestring
Standardwheel
Tekstinstruktion, der styrer segmenteringen.
text_promptvalgfri
Typestring | null
[DEPRECATED] Ældre input, der bevares af hensyn til bagudkompatibilitet; brug 'prompt' i stedet.
point_promptsvalgfri
Typeobject[]
Standard[]
Samling af punktbaserede prompts.
point_prompts[].xvalgfri
Typeinteger | null
Promptens position langs X-aksen.
point_prompts[].yvalgfri
Typeinteger | null
Promptens position langs Y-aksen.
point_prompts[].labelvalgfri
Typeenum
01
Forgrunds-/baggrundsetiket: 1 angiver forgrund; 0 angiver baggrund.
point_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer prompts, som forfiner ét objekt. Hvis tekst også angives som prompt, bestemmer denne identifikator, hvilket registreret objekt punkterne forfiner.
point_prompts[].frame_indexvalgfri
Typeinteger | null
Indeks, der identificerer framen til interaktion.
box_promptsvalgfri
Typeobject[]
Standard[]
Boks-prompts, hvis object_id bestemmer grupperingen: matchende ID'er knytter bokse til ét objekt, mens tomme ID'er repræsenterer separate objekter. Flere bokse kan angives, hver med koordinaterne (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalgfri
Typeinteger | null
Minimums-x-koordinat for boksen.
box_prompts[].y_minvalgfri
Typeinteger | null
Minimums-y-koordinat for boksen.
box_prompts[].x_maxvalgfri
Typeinteger | null
Maksimal X-koordinat for boksen.
box_prompts[].y_maxvalgfri
Typeinteger | null
Maksimal Y-koordinat for boksen.
box_prompts[].object_idvalgfri
Typeinteger | null
Valgfri identifikator, der grupperer bokse, som forfiner ét objekt.
box_prompts[].frame_indexvalgfri
Typeinteger | null
Indeks, der identificerer framen til interaktion.
apply_maskvalgfri
Typeboolean
Standardtrue
Styrer, om masken anvendes på billedet.
output_formatvalgfri
Typeenum
Standardpng
jpegpngwebp
Filformat for det resulterende billede.
return_multiple_masksvalgfri
Typeboolean
Standardfalse
Indstilling for returnering af flere masker: når den aktiveres, bestemmer `max_masks`, hvor mange genererede masker der uploades og medtages i svaret.
max_masksvalgfri
Typeinteger
Standard3
1 – 32
Øvre grænse for returnerede masker, når `return_multiple_masks` er aktiveret.
include_scoresvalgfri
Typeboolean
Standardfalse
Styrer, om konfidensscorer for masker medtages.
include_boxesvalgfri
Typeboolean
Standardfalse
Styrer, om der medtages en afgrænsningsboks for hver maske, hvis den er tilgængelig.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
image
object {url, content_type, file_name, file_size, width, height} | nullForhåndsvisning, der viser den primære segmenteringsmaske.
masks
array of object {url, content_type, file_name, file_size, width, height}Billeder, der indeholder segmenteringsmasker.
metadata
array of object {index, score, box} | nullMetadata for hver maske, inklusive dens score og boks.
scores
array of number | nullKonfidensscore for hver maske, angivet når det anmodes.
boxes
array of array of number | nullNormaliserede bokse for hver maske, udtrykt som [cx, cy, w, h], hvis det anmodes.

Flere modeller: Billedredigering

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/sam-3/image.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt