Мазмұнға өту

Sam 3 1 · Video

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

Модель идентификаторы sam-3-1/video
# 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/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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,19 $ 190 API кредиті · ≈ 20,04 ₽ файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
Meta Бейнеден бейнеге #segmentation#mask#real-time

128-ге дейінгі объектіні бақылайтын, нәтижесі mp4 немесе webm болатын SAM 3.1 бейне сегментациясы

Meta · Бейне

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

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

Сұрау жасау

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

әдепкі

Үтірмен бөлінген сипаттамалар арқылы бірнеше бақыланатын нысанды қолдайтын сегментация нұсқауы, мысалы, 'person, cloth'.

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

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

Қосымша video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type әдепкі X264 (.mp4)

Нәтижелік бейне түрі.

әдепкі 0.5

Анықтау сенімділігінің шегі: мәнді азайту дәлдікті төмендетіп, анықталған нысандар санын арттырады; ауқымы 0.0–1.0.

әдепкі 16

Бейненің ішінде бақыланатын нысандар санының жоғарғы шегі.

әдепкі []

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

әдепкі []

(x_min, y_min, x_max, y_max) координаталар кортеждері ретінде берілген box нұсқаулары.

POST /run/sam-3-1/video?wait=20 бағасы → 0,19 $
# 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/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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 кілтін алу

Sam 3 1 · Video туралы

Үтірмен бөлінген мәтіндік `prompt`, нүктелер немесе қораптар арқылы бейнедегі нысандарды SAM 3.1 көмегімен сегменттеп, бақылайды. `max_num_objects` бақыланатын нысандар санын 1-ден 128-ге дейін орнатады (әдепкісі 16). `detection_threshold` мәні 0.1-ден 1-ге дейін. Шығыс — X264 (.mp4) немесе VP9 (.webm).

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
video_urlміндетті video
Түріurl · video
Сегментацияға арналған бейне URL мекенжайы.
promptміндетті емес
Түріstring
Әдепкі
Үтірмен бөлінген сипаттамалар арқылы бірнеше бақыланатын нысанды қолдайтын сегментация нұсқауы, мысалы, 'person, cloth'.
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
Бір нысанды нақтылайтын нұсқауларды топтастыратын қосымша идентификатор. Егер мәтін де нұсқау ретінде берілсе, бұл идентификатор нүктелер нақтылайтын анықталған нысанды көрсетеді.
box_promptsміндетті емес
Түріobject[]
Әдепкі[]
(x_min, y_min, x_max, y_max) координаталар кортеждері ретінде берілген box нұсқаулары.
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
Бір нысанды нақтылайтын қораптарды топтастыратын қосымша идентификатор.
apply_maskміндетті емес
Түріboolean
Әдепкіtrue
Бейненің маскалануын қолдану керек пе.
video_output_typeміндетті емес
Түріenum
ӘдепкіX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Нәтижелік бейне түрі.
detection_thresholdміндетті емес
Түріnumber
Әдепкі0.5
0,1 – 1
Анықтау сенімділігінің шегі: мәнді азайту дәлдікті төмендетіп, анықталған нысандар санын арттырады; ауқымы 0.0–1.0.
max_num_objectsміндетті емес
Түріinteger
Әдепкі16
1 – 128
Бейненің ішінде бақыланатын нысандар санының жоғарғы шегі.
міндетті Канондық атау, бұл да қабылданады

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

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video",
  "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": 190,
    "usd": "0.19",
    "charged": 190,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "boundingbox_frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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 — модельдің өз нәтижелер нысаны.
Шығыс өрістері
video
object {url, content_type, file_name, file_size}Сегментация нәтижесінде жасалған бейне.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullӘр кадрға арналған bounding box қабаттары бар ZIP архиві.

Қосымша модельдер: Бейнеден бейнеге

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