İçeriğe geç

Sam 3 1 · Video

Entegre et

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

Örnekteki gibi dosyalar: $0,19 190 API kredisi dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

API anahtarı al
Meta Videodan Videoya #segmentation#mask#real-time

128 nesneye kadar izleme yapan, çıktıyı mp4 veya webm olarak veren SAM 3.1 video segmentasyonu

Meta · Video

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

varsayılan

'person, cloth' gibi virgülle ayrılmış açıklamalar üzerinden birden fazla izlenen nesneyi destekleyen segmentasyon istemi.

•gerekli video_url
Dosyayı bırakın veya

Segmentasyon için video URL'si.

Gelişmiş video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type varsayılan X264 (.mp4)

Sonuç videosunun çıktı türü.

varsayılan 0.5

Algılama güven eşiği; değerin düşürülmesi kesinlik pahasına algılama sayısını artırır. Aralık 0.0–1.0'dır.

varsayılan 16

Videoda izlenecek nesne sayısı için üst sınır.

varsayılan []

Nokta tabanlı istemler koleksiyonu.

varsayılan []

Koordinat demetleri (x_min, y_min, x_max, y_max) olarak listelenen kutu istemleri.

POST /run/sam-3-1/video?wait=20 fiyat → $0,19
# 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-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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Sam 3 1 · Video hakkında

SAM 3.1 ile videodaki nesneleri virgülle ayrılmış metin `prompt`, noktalar veya kutular kullanarak segmentlere ayırır ve izler. `max_num_objects`, izlenecek nesne sayısını 1 to 128 arasında belirler (varsayılan 16). `detection_threshold` aralığı 0.1 to 1'dir. Çıktı X264 (.mp4) veya VP9 (.webm) olur.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
video_urlgerekli video
Türurl · video
Segmentasyon için video URL'si.
promptisteğe bağlı
Türstring
Varsayılan
'person, cloth' gibi virgülle ayrılmış açıklamalar üzerinden birden fazla izlenen nesneyi destekleyen segmentasyon istemi.
point_promptsisteğe bağlı
Türobject[]
Varsayılan[]
Nokta tabanlı istemler koleksiyonu.
point_prompts[].xisteğe bağlı
Türinteger | null
İstemin X ekseni üzerindeki konumu.
point_prompts[].yisteğe bağlı
Türinteger | null
İstemin Y ekseni üzerindeki konumu.
point_prompts[].labelisteğe bağlı
Türenum
01
Ön plan/arka plan etiketi: 1 ön planı, 0 arka planı belirtir.
point_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren istemleri gruplandıran isteğe bağlı tanımlayıcı. Metin de istem olarak sağlanırsa bu tanımlayıcı, noktaların hangi algılanan nesneyi iyileştireceğini belirler.
box_promptsisteğe bağlı
Türobject[]
Varsayılan[]
Koordinat demetleri (x_min, y_min, x_max, y_max) olarak listelenen kutu istemleri.
box_prompts[].x_ministeğe bağlı
Türinteger | null
Kutunun minimum x koordinatı.
box_prompts[].y_ministeğe bağlı
Türinteger | null
Kutunun minimum y koordinatı.
box_prompts[].x_maxisteğe bağlı
Türinteger | null
Kutu için maksimum X koordinatı.
box_prompts[].y_maxisteğe bağlı
Türinteger | null
Kutu için maksimum Y koordinatı.
box_prompts[].object_idisteğe bağlı
Türinteger | null
Tek bir nesneyi iyileştiren kutuları gruplandıran isteğe bağlı tanımlayıcı.
apply_maskisteğe bağlı
Türboolean
Varsayılantrue
Videoya maskeleme uygulanıp uygulanmayacağı.
video_output_typeisteğe bağlı
Türenum
VarsayılanX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Sonuç videosunun çıktı türü.
detection_thresholdisteğe bağlı
Türnumber
Varsayılan0.5
0,1 – 1
Algılama güven eşiği; değerin düşürülmesi kesinlik pahasına algılama sayısını artırır. Aralık 0.0–1.0'dır.
max_num_objectsisteğe bağlı
Türinteger
Varsayılan16
1 – 128
Videoda izlenecek nesne sayısı için üst sınır.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
video
object {url, content_type, file_name, file_size}Segmentasyon tarafından üretilen video.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullHer kare için sınırlayıcı kutu bindirmelerinin ZIP arşivi.

Daha fazla model: Videodan Videoya

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/sam-3-1/video.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt