Naar inhoud springen

Sam 3 1 · Image

Integreren

Model-ID sam-3-1/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-1/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"

Deze request: ≈$ 0,01 10 API-tegoed · ≈ ₽ 1,05 Op deze pagina uitvoeren

API-sleutel ophalen
Meta Afbeelding bewerken #segmentation#mask#real-time

SAM 3.1-beeldsegmentatie op basis van tekst-, punt- of box-prompts, met maskeringsafbeeldingen als uitvoer

Meta · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

standaard wheel

Tekstinstructie die segmentatie aanstuurt.

•verplicht image_url
Sleep een bestand hierheen of

URL naar de afbeelding voor segmentatie.

Geavanceerd output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format standaard png

Bestandsindeling van de resulterende afbeelding.

standaard 3

Bovengrens voor geretourneerde maskers wanneer `return_multiple_masks` is ingeschakeld.

standaard []

Verzameling prompts op basis van punten.

standaard []

Box-prompts waarvan object_id de groepering bepaalt: overeenkomende ID's koppelen boxen aan één object, terwijl lege ID's afzonderlijke objecten aangeven. Er kunnen meerdere boxen worden opgegeven, elk met coördinaten (x_min, y_min, x_max, y_max).

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Sam 3 1 · Image

Segmenteert één afbeelding met SAM 3.1 met behulp van een tekstuele `prompt`, `point_prompts` of `box_prompts`. Meerdere boxen kunnen per object worden gegroepeerd met object_id. `return_multiple_masks` retourneert maximaal `max_masks` maskers (1 tot 32), met optionele scores en begrenzingsvakken. De uitvoerindeling is jpeg, png of webp.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
URL naar de afbeelding voor segmentatie.
promptoptioneel
Typestring
Standaardwheel
Tekstinstructie die segmentatie aanstuurt.
point_promptsoptioneel
Typeobject[]
Standaard[]
Verzameling prompts op basis van punten.
point_prompts[].xoptioneel
Typeinteger | null
Promptpositie langs de X-as.
point_prompts[].yoptioneel
Typeinteger | null
Promptpositie langs de Y-as.
point_prompts[].labeloptioneel
Typeenum
01
Label voor voorgrond/achtergrond: 1 geeft voorgrond aan; 0 geeft achtergrond aan.
point_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier die prompts groepeert die één object verfijnen. Als ook tekst als prompt wordt opgegeven, bepaalt deze identifier welk gedetecteerd object die punten verfijnen.
point_prompts[].frame_indexoptioneel
Typeinteger | null
Index die het frame voor interactie identificeert.
box_promptsoptioneel
Typeobject[]
Standaard[]
Box-prompts waarvan object_id de groepering bepaalt: overeenkomende ID's koppelen boxen aan één object, terwijl lege ID's afzonderlijke objecten aangeven. Er kunnen meerdere boxen worden opgegeven, elk met coördinaten (x_min, y_min, x_max, y_max).
box_prompts[].x_minoptioneel
Typeinteger | null
Minimale x-coördinaat van het vak.
box_prompts[].y_minoptioneel
Typeinteger | null
Minimale y-coördinaat van het vak.
box_prompts[].x_maxoptioneel
Typeinteger | null
Maximale X-coördinaat voor de box.
box_prompts[].y_maxoptioneel
Typeinteger | null
Maximale Y-coördinaat voor de box.
box_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier voor het groeperen van boxen die één object verfijnen.
box_prompts[].frame_indexoptioneel
Typeinteger | null
Index die het frame voor interactie identificeert.
apply_maskoptioneel
Typeboolean
Standaardtrue
Bepaalt of het masker op de afbeelding wordt toegepast.
output_formatoptioneel
Typeenum
Standaardpng
jpegpngwebp
Bestandsindeling van de resulterende afbeelding.
return_multiple_masksoptioneel
Typeboolean
Standaardfalse
Optie voor meerdere maskers: inschakelen gebruikt `max_masks` om te bepalen hoeveel gegenereerde maskers worden geüpload en in de respons opgenomen.
max_masksoptioneel
Typeinteger
Standaard3
1 – 32
Bovengrens voor geretourneerde maskers wanneer `return_multiple_masks` is ingeschakeld.
include_scoresoptioneel
Typeboolean
Standaardfalse
Bepaalt of betrouwbaarheidsscores voor maskers worden opgenomen.
include_boxesoptioneel
Typeboolean
Standaardfalse
Bepaalt of voor elk masker, indien beschikbaar, een bounding box wordt opgenomen.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/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": 10,
    "usd": "0.01",
    "charged": 10,
    "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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
image
object {url, content_type, file_name, file_size, width, height} | nullVoorbeeldweergave met het primaire segmentatiemasker.
masks
array of object {url, content_type, file_name, file_size, width, height}Afbeeldingen met segmentatiemaskers.
metadata
array of object {index, score, box} | nullMetadata voor elk masker, inclusief de score en het kader.
scores
array of number | nullBetrouwbaarheidsscore voor elk masker, indien aangevraagd.
boxes
array of array of number | nullGenormaliseerde kaders voor elk masker, uitgedrukt als [cx, cy, w, h], indien aangevraagd.

Meer modellen: Afbeelding bewerken

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/sam-3-1/image.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt