Naar inhoud springen

Segment Anything Model 3

Integreren

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request: ≈$ 0,005 5 API-tegoed Op deze pagina uitvoeren

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

Afbeeldingssegmentatie met tekst-, punt- of box-prompts die maskers retourneert, optioneel met scores en boxen

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 text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Verouderde invoer voor achterwaartse compatibiliteit; gebruik 'prompt' in plaats daarvan.

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/image?wait=20 prijsopgave → $ 0,005
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/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 Segment Anything Model 3

Segmenteert een afbeelding met SAM 3 vanuit een tekstuele `prompt`, `point_prompts` of `box_prompts`. Met `return_multiple_masks` ingeschakeld worden maximaal `max_masks` maskers geretourneerd (1 tot 32). Optioneel kunnen betrouwbaarheidsscores en begrenzingsboxen worden opgenomen. Het uitvoerformaat 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.
text_promptoptioneel
Typestring | null
[DEPRECATED] Verouderde invoer voor achterwaartse compatibiliteit; gebruik 'prompt' in plaats daarvan.
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/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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/image.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt