Мазмұнға өту

Sam 3 · Video

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

Модель идентификаторы sam-3/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/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,095 $ 95 API кредиті · ≈ 10,02 ₽ файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

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

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

Meta · Бейне

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

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

Сұрау жасау

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

әдепкі

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

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

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

Қосымша text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

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

video_output_type әдепкі X264 (.mp4)

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

әдепкі 0.5

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

әдепкі []

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

әдепкі []

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

POST /run/sam-3/video?wait=20 бағасы → 0,095 $
# 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/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 · Video туралы

`video_url` арқылы берілген бейнедегі нысандарды анықтап, бақылайды. `prompt` ішінде нысандарды атауларымен көрсетіп, бірнешеуін үтірмен бөліңіз немесе `point_prompts` және `box_prompts` пайдаланыңыз. `detection_threshold` мәні 0.1-ден 1-ге дейін, ал `apply_mask` масканың бейнеге салынуын басқарады. Нәтиже — mp4 немесе webm бейнесі және кадрлар бойынша жақтаулар қабаттамалары бар zip.

Параметрлер

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

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
video_urlміндетті video
Түріurl · video
Сегментацияға арналған бейне URL мекенжайы.
promptміндетті емес
Түріstring
Әдепкі
Үтірмен бөлінген сипаттамалар арқылы бірнеше бақыланатын нысанды қолдайтын сегментация нұсқауы, мысалы, 'person, cloth'.
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
Бір нысанды нақтылайтын нұсқауларды топтастыратын қосымша идентификатор. Егер мәтін де нұсқау ретінде берілсе, бұл идентификатор нүктелер нақтылайтын анықталған нысанды көрсетеді.
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.
міндетті Канондық атау, бұл да қабылданады

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

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 95,
    "usd": "0.095",
    "charged": 95,
    "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/video.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt