Vai al contenuto

Sam 3 1 · Image RLE

Integra

ID del modello 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"

Questa richiesta: ≈0,01 $ 10 crediti API · ≈ 1,07 ₽ Esegui in questa pagina

Ottieni la chiave API
Meta Modifica immagini #segmentation#mask#real-time

Segmentazione di immagini SAM 3.1 con maschere restituite tramite codifica run-length

Meta · Dati (JSON)

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

predefinito wheel

Istruzione testuale che guida la segmentazione.

•obbligatorio image_url
Trascina un file oppure

URL dell'immagine per la segmentazione.

Avanzate output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format predefinito png

Formato del file dell'immagine risultante.

predefinito 3

Limite massimo delle maschere restituite quando `return_multiple_masks` è abilitato.

predefinito []

Raccolta di prompt basati su punti.

predefinito []

Prompt a riquadro il cui object_id determina il raggruppamento: gli ID corrispondenti associano i riquadri a un oggetto, mentre gli ID vuoti rappresentano oggetti separati. È possibile fornire più riquadri, ciascuno con coordinate (x_min, y_min, x_max, y_max).

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Sam 3 1 · Image RLE

Esegue la segmentazione SAM 3.1 su un'immagine da un `prompt` testuale, punti o riquadri e restituisce le maschere come dati RLE anziché file immagine. Supporta più maschere (`max_masks` da 1 a 32), punteggi di confidenza e riquadri delimitanti su richiesta.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlobbligatorio image
Tipourl · image
URL dell'immagine per la segmentazione.
promptfacoltativo
Tipostring
Predefinitowheel
Istruzione testuale che guida la segmentazione.
point_promptsfacoltativo
Tipoobject[]
Predefinito[]
Raccolta di prompt basati su punti.
point_prompts[].xfacoltativo
Tipointeger | null
Posizione del prompt lungo l'asse X.
point_prompts[].yfacoltativo
Tipointeger | null
Posizione del prompt lungo l'asse Y.
point_prompts[].labelfacoltativo
Tipoenum
01
Etichetta primo piano/sfondo: 1 indica il primo piano; 0 indica lo sfondo.
point_prompts[].object_idfacoltativo
Tipointeger | null
Identificatore facoltativo che raggruppa i prompt che perfezionano un singolo oggetto. Se viene fornito anche testo come prompt, questo identificatore determina quale oggetto rilevato viene perfezionato da quei punti.
point_prompts[].frame_indexfacoltativo
Tipointeger | null
Indice che identifica il fotogramma per l'interazione.
box_promptsfacoltativo
Tipoobject[]
Predefinito[]
Prompt a riquadro il cui object_id determina il raggruppamento: gli ID corrispondenti associano i riquadri a un oggetto, mentre gli ID vuoti rappresentano oggetti separati. È possibile fornire più riquadri, ciascuno con coordinate (x_min, y_min, x_max, y_max).
box_prompts[].x_minfacoltativo
Tipointeger | null
Coordinata x minima del riquadro.
box_prompts[].y_minfacoltativo
Tipointeger | null
Coordinata y minima del riquadro.
box_prompts[].x_maxfacoltativo
Tipointeger | null
Coordinata X massima del riquadro.
box_prompts[].y_maxfacoltativo
Tipointeger | null
Coordinata Y massima del riquadro.
box_prompts[].object_idfacoltativo
Tipointeger | null
Identificatore facoltativo che raggruppa i riquadri che perfezionano un singolo oggetto.
box_prompts[].frame_indexfacoltativo
Tipointeger | null
Indice che identifica il fotogramma per l'interazione.
apply_maskfacoltativo
Tipoboolean
Predefinitotrue
Controlla se alla maschera viene applicata l'immagine.
output_formatfacoltativo
Tipoenum
Predefinitopng
jpegpngwebp
Formato del file dell'immagine risultante.
return_multiple_masksfacoltativo
Tipoboolean
Predefinitofalse
Opzione per restituire più maschere: abilitarla usa `max_masks` per determinare quante maschere generate caricare e includere nella risposta.
max_masksfacoltativo
Tipointeger
Predefinito3
1 – 32
Limite massimo delle maschere restituite quando `return_multiple_masks` è abilitato.
include_scoresfacoltativo
Tipoboolean
Predefinitofalse
Controlla l'inclusione dei punteggi di confidenza per le maschere.
include_boxesfacoltativo
Tipoboolean
Predefinitofalse
Controlla l'inclusione di un riquadro di delimitazione per ogni maschera, se disponibile.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
rle
string | array of stringMaschera rappresentata tramite codifica run-length.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArchivio ZIP delle sovrapposizioni dei riquadri per ogni fotogramma.
metadata
array of object {index, score, box} | nullMetadati per ogni maschera, inclusi quando la risposta contiene più RLE.
scores
array of number | nullPunteggio di confidenza per ogni maschera, fornito quando richiesto.
boxes
array of array of number | nullRiquadri normalizzati per ogni maschera, espressi come [cx, cy, w, h], se richiesti.

Altri modelli: Modifica immagini

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/sam-3-1/image-rle.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt