Lompat ke konten

Sam 3 1 · Video RLE

Integrasikan

ID model sam-3-1/video-rle
# 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-rle?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"

File seperti contoh: $0,19 190 kredit API file Anda diukur sebelum dijalankan Jalankan di halaman ini

Dapatkan kunci API
Meta Video ke Video #segmentation#mask#real-time

Segmentasi video SAM 3.1 dengan mask RLE, pengaturan seed mask, dan mask per objek opsional untuk setiap bingkai

Meta · Video

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

bawaan

Prompt segmentasi yang mendukung beberapa objek yang dilacak melalui deskripsi yang dipisahkan koma, seperti 'person, cloth'.

•wajib video_url
Jatuhkan file, atau

URL video untuk segmentasi.

Lanjutan mask · detection_threshold · frame_index · max_num_objects · apply_mask · boundingbox_zip · return_object_rles · point_prompts · box_prompts
mask_url
Jatuhkan file, atau

URL mask untuk penerapan awal.

bawaan 0.5

Batas skor keyakinan deteksi dengan bawaan 0.5 untuk objek yang ada dan 0.7 untuk objek baru. Dalam rentang 0.0–1.0, nilai yang lebih kecil menukar presisi dengan lebih banyak deteksi; coba 0.2–0.3 saat prompt teks gagal.

bawaan 0

Indeks bingkai untuk interaksi awal saat menyediakan mask_url.

bawaan 16

Batas atas jumlah objek yang dilacak dalam video.

bawaan []

Daftar prompt titik yang menentukan indeks bingkai.

bawaan []

Daftar prompt kotak, dengan frame_index opsional untuk setiap entri.

POST /run/sam-3-1/video-rle?wait=20 estimasi harga → $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-rle?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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Sam 3 1 · Video RLE

Mensegmentasikan video dengan SAM 3.1, menggunakan seed dari `prompt` teks, prompt titik atau kotak, atau `mask_url` yang diterapkan pada `frame_index`. `max_num_objects` memungkinkan 1 hingga 128 objek yang dilacak. Tetapkan `return_object_rles` untuk mendapatkan mask setiap objek yang dilacak pada setiap bingkai dengan id yang stabil. `detection_threshold` berkisar dari 0.01 hingga 1.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
video_urlwajib video
Tipeurl · video
URL video untuk segmentasi.
mask_urlopsional mask
Tipeurl · image
URL mask untuk penerapan awal.
promptopsional
Tipestring
Bawaan
Prompt segmentasi yang mendukung beberapa objek yang dilacak melalui deskripsi yang dipisahkan koma, seperti 'person, cloth'.
point_promptsopsional
Tipeobject[]
Bawaan[]
Daftar prompt titik yang menentukan indeks bingkai.
point_prompts[].xopsional
Tipeinteger | null
Posisi prompt pada sumbu X.
point_prompts[].yopsional
Tipeinteger | null
Posisi prompt pada sumbu Y.
point_prompts[].labelopsional
Tipeenum
01
Label foreground/background: 1 menunjukkan foreground; 0 menunjukkan background.
point_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan prompt untuk menyempurnakan satu objek. Jika teks juga diberikan sebagai prompt, pengenal ini menentukan objek terdeteksi mana yang disempurnakan oleh titik tersebut.
point_prompts[].frame_indexopsional
Tipeinteger | null
Indeks yang mengidentifikasi bingkai untuk interaksi.
box_promptsopsional
Tipeobject[]
Bawaan[]
Daftar prompt kotak, dengan frame_index opsional untuk setiap entri.
box_prompts[].x_minopsional
Tipeinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minopsional
Tipeinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxopsional
Tipeinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxopsional
Tipeinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idopsional
Tipeinteger | null
Pengenal opsional yang mengelompokkan kotak untuk menyempurnakan satu objek.
box_prompts[].frame_indexopsional
Tipeinteger | null
Indeks yang mengidentifikasi bingkai untuk interaksi.
apply_maskopsional
Tipeboolean
Bawaanfalse
Apakah masking diterapkan pada video.
boundingbox_zipopsional
Tipeboolean
Bawaanfalse
Apakah akan mengembalikan arsip ZIP yang berisi overlay kotak pembatas untuk setiap bingkai.
detection_thresholdopsional
Tipenumber
Bawaan0.5
0,01 – 1
Batas skor keyakinan deteksi dengan bawaan 0.5 untuk objek yang ada dan 0.7 untuk objek baru. Dalam rentang 0.0–1.0, nilai yang lebih kecil menukar presisi dengan lebih banyak deteksi; coba 0.2–0.3 saat prompt teks gagal.
frame_indexopsional
Tipeinteger
Bawaan0
Indeks bingkai untuk interaksi awal saat menyediakan mask_url.
max_num_objectsopsional
Tipeinteger
Bawaan16
1 – 128
Batas atas jumlah objek yang dilacak dalam video.
return_object_rlesopsional
Tipeboolean
Bawaanfalse
Apakah juga akan mengembalikan mask terpisah untuk setiap objek yang dilacak di setiap bingkai, menggunakan ID objek yang stabil sepanjang video. Respons tetap menyertakan rle gabungan.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video-rle",
  "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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan oleh segmentasi.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArsip ZIP overlay kotak pembatas untuk setiap bingkai.

Model lainnya: Video ke Video

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/sam-3-1/video-rle.md. Semua model dan panduan: https://doitong.com/developers/llms.txt