Мазмұнға өту

Segment Anything Model 3

Интеграциялау

Модель идентификаторы 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: ≈0,005 $ 5 API кредиті · ≈ 0,53 ₽ Осы бетте іске қосу

API кілтін алу
Meta Кескінді өңдеу #segmentation#mask#real-time

Мәтін, нүкте немесе жақтау сұрауы бойынша кескінді сегменттеп, маска суреттерін, қосымша бағалар мен жақтауларды қайтарады

Meta · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

әдепкі wheel

Сегментацияны бағыттайтын мәтіндік нұсқау.

•міндетті image_url
Файлды тастаңыз немесе

Сегментацияға арналған кескінге сілтейтін URL мекенжайы.

Қосымша text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Кері үйлесімділік үшін сақталған ескі кіріс; оның орнына 'prompt' қолданыңыз.

output_format әдепкі png

Нәтижедегі кескіннің файл пішімі.

әдепкі 3

`return_multiple_masks` қосылғанда қайтарылатын маскалардың жоғарғы шегі.

әдепкі []

Нүктелерге негізделген нұсқаулар топтамасы.

әдепкі []

object_id топтастыруды анықтайтын қорап нұсқаулары: бірдей идентификаторлар қораптарды бір нысанға біріктіреді, ал бос идентификаторлар бөлек нысандарды білдіреді. Әрқайсысы (x_min, y_min, x_max, y_max) координаттарын пайдаланатын бірнеше қорап беруге болады.

POST /run/sam-3/image?wait=20 бағасы → 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?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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Segment Anything Model 3 туралы

SAM 3 көмегімен суретті мәтіндік `prompt`, `point_prompts` немесе `box_prompts` арқылы сегменттейді. `return_multiple_masks` қосылса, `max_masks` санына дейін маска қайтарады (1–32). Қосымша сенімділік бағалары мен шектеуші жақтауларды қосуға болады. Шығыс пішімі jpeg, png немесе webp.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
Сегментацияға арналған кескінге сілтейтін URL мекенжайы.
promptміндетті емес
Түріstring
Әдепкіwheel
Сегментацияны бағыттайтын мәтіндік нұсқау.
text_promptміндетті емес
Түріstring | null
[DEPRECATED] Кері үйлесімділік үшін сақталған ескі кіріс; оның орнына 'prompt' қолданыңыз.
point_promptsміндетті емес
Түріobject[]
Әдепкі[]
Нүктелерге негізделген нұсқаулар топтамасы.
point_prompts[].xміндетті емес
Түріinteger | null
X осі бойындағы нұсқау орны.
point_prompts[].yміндетті емес
Түріinteger | null
Y осі бойындағы нұсқау орны.
point_prompts[].labelміндетті емес
Түріenum
01
Алдыңғы фон/фон жапсырмасы: 1 — алдыңғы фон, 0 — фон.
point_prompts[].object_idміндетті емес
Түріinteger | null
Бір нысанды нақтылайтын нұсқауларды топтастыратын қосымша идентификатор. Егер мәтін де нұсқау ретінде берілсе, бұл идентификатор нүктелер нақтылайтын анықталған нысанды көрсетеді.
point_prompts[].frame_indexміндетті емес
Түріinteger | null
Өзара әрекетке арналған кадрды анықтайтын индекс.
box_promptsміндетті емес
Түріobject[]
Әдепкі[]
object_id топтастыруды анықтайтын қорап нұсқаулары: бірдей идентификаторлар қораптарды бір нысанға біріктіреді, ал бос идентификаторлар бөлек нысандарды білдіреді. Әрқайсысы (x_min, y_min, x_max, y_max) координаттарын пайдаланатын бірнеше қорап беруге болады.
box_prompts[].x_minміндетті емес
Түріinteger | null
Төртбұрыштың ең кіші x координатасы.
box_prompts[].y_minміндетті емес
Түріinteger | null
Төртбұрыштың ең кіші y координатасы.
box_prompts[].x_maxміндетті емес
Түріinteger | null
Қораптың ең үлкен X координатасы.
box_prompts[].y_maxміндетті емес
Түріinteger | null
Қораптың ең үлкен Y координатасы.
box_prompts[].object_idміндетті емес
Түріinteger | null
Бір нысанды нақтылайтын қораптарды топтастыратын қосымша идентификатор.
box_prompts[].frame_indexміндетті емес
Түріinteger | null
Өзара әрекетке арналған кадрды анықтайтын индекс.
apply_maskміндетті емес
Түріboolean
Әдепкіtrue
Кескінге маска қолданылатынын басқарады.
output_formatміндетті емес
Түріenum
Әдепкіpng
jpegpngwebp
Нәтижедегі кескіннің файл пішімі.
return_multiple_masksміндетті емес
Түріboolean
Әдепкіfalse
Бірнеше масканы қайтару параметрі: қосылғанда, жүктеліп, жауапқа енгізілетін генерацияланған маскалар санын анықтау үшін `max_masks` қолданылады.
max_masksміндетті емес
Түріinteger
Әдепкі3
1 – 32
`return_multiple_masks` қосылғанда қайтарылатын маскалардың жоғарғы шегі.
include_scoresміндетті емес
Түріboolean
Әдепкіfalse
Маскалар үшін сенімділік бағаларын қосуды басқарады.
include_boxesміндетті емес
Түріboolean
Әдепкіfalse
Қолжетімді болса, әр маска үшін шектеуші қорапты қосуды басқарады.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
image
object {url, content_type, file_name, file_size, width, height} | nullНегізгі сегментация маскасын көрсететін алдын ала көрініс.
masks
array of object {url, content_type, file_name, file_size, width, height}Сегментация маскалары бар кескіндер.
metadata
array of object {index, score, box} | nullӘр маскаға арналған метадеректер, оның ішінде score және box.
scores
array of number | nullСұралған кезде берілетін әр масканың сенімділік score мәні.
boxes
array of array of number | nullСұралған жағдайда [cx, cy, w, h] түрінде берілетін әр маскаға арналған нормаланған box мәндері.

Қосымша модельдер: Кескінді өңдеу

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/sam-3/image.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt