Gå til innhold

Sam 3 · Image RLE

Integrer

Modell-ID sam-3/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/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 forespørselen: ≈0,005 $ 5 API-kreditter · ≈ 0,53 ₽ Kjør den på denne siden

Hent API-nøkkel
Meta · Data (JSON)

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-rle?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-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"

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 Sam 3 · Image RLE

Kjører SAM 3-segmentering på et bilde ved hjelp av en tekst-`prompt`, punkter eller bokser, og returnerer masken som run-length encoding-data (RLE). Nyttig når du trenger kompakte maske data for etterbehandling. Støtter `return_multiple_masks` med `max_masks` fra 1 til 32, samt valgfrie skårer og bokser.

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-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": 5,
    "usd": "0.005",
    "charged": 5,
    "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"
  }
}
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
rle
string | array of stringMaske representert med kjøringslengdekoding.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-arkiv med overlegg av avgrensningsbokser for hvert bilde.
metadata
array of object {index, score, box} | nullMetadata for hver maske, inkludert når responsen inneholder flere RLE-er.
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-rle.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt