Gå til indhold

Sam 3 1 · Image RLE

Integrer

Model-id sam-3-1/image-rle
# 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-1/image-rle?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,01 $ 10 API-kreditter · ≈ 1,07 ₽ Kør den på denne side

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

SAM 3.1-billedsegmentering, der leverer masker som run-length encoding

Meta · Data (JSON)

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 output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
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-1/image-rle?wait=20 pris → 0,01 $
# 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-1/image-rle?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 Sam 3 1 · Image RLE

Kører SAM 3.1-segmentering på et billede ud fra en tekstbaseret `prompt`, punkter eller bokse og returnerer maskerne som RLE-data i stedet for billedfiler. Understøtter flere masker (`max_masks` 1 til 32), konfidensscorer og afgrænsningsbokse efter anmodning.

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.
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-1/image-rle",
  "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": {
    "rle": "string",
    "boundingbox_frames_zip": {
      "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
    },
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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
rle
string | array of stringMaske repræsenteret ved hjælp af run-length-kodning.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med overlays af afgrænsningsbokse for hver frame.
metadata
array of object {index, score, box} | nullMetadata for hver maske, inkluderet når svaret indeholder flere RLE'er.
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-1/image-rle.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt