Lompat ke konten

Sam 3 · Video

Integrasikan

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

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

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

Mensegmentasikan dan melacak objek dalam video dari prompt teks, titik, atau kotak, lalu mengembalikan video bermask

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 text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

[DEPRECATED] Input lama yang dipertahankan untuk kompatibilitas mundur; gunakan 'prompt' sebagai gantinya.

video_output_type bawaan X264 (.mp4)

Jenis output untuk video yang dihasilkan.

bawaan 0.5

Batas skor keyakinan deteksi; menurunkan nilainya meningkatkan jumlah deteksi dengan mengorbankan presisi. Rentangnya 0.0–1.0.

bawaan []

Kumpulan prompt berbasis titik.

bawaan []

Prompt kotak yang dicantumkan sebagai tuple koordinat (x_min, y_min, x_max, y_max).

POST /run/sam-3/video?wait=20 estimasi harga → $0,095
# 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/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"

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 · Video

Mendeteksi dan melacak objek di seluruh video yang diberikan melalui `video_url`. Sebutkan target dalam `prompt`, pisahkan beberapa target dengan koma, atau gunakan `point_prompts` dan `box_prompts`. `detection_threshold` berkisar dari 0.1 hingga 1, dan `apply_mask` mengontrol apakah mask digambar pada video. Output berupa mp4 atau webm, serta zip overlay kotak pembatas per bingkai.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
video_urlwajib video
Tipeurl · video
URL video untuk segmentasi.
promptopsional
Tipestring
Bawaan
Prompt segmentasi yang mendukung beberapa objek yang dilacak melalui deskripsi yang dipisahkan koma, seperti 'person, cloth'.
text_promptopsional
Tipestring | null
[DEPRECATED] Input lama yang dipertahankan untuk kompatibilitas mundur; gunakan 'prompt' sebagai gantinya.
point_promptsopsional
Tipeobject[]
Bawaan[]
Kumpulan prompt berbasis titik.
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.
box_promptsopsional
Tipeobject[]
Bawaan[]
Prompt kotak yang dicantumkan sebagai tuple koordinat (x_min, y_min, x_max, y_max).
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.
apply_maskopsional
Tipeboolean
Bawaantrue
Apakah masking diterapkan pada video.
video_output_typeopsional
Tipeenum
BawaanX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Jenis output untuk video yang dihasilkan.
detection_thresholdopsional
Tipenumber
Bawaan0.5
0,1 – 1
Batas skor keyakinan deteksi; menurunkan nilainya meningkatkan jumlah deteksi dengan mengorbankan presisi. Rentangnya 0.0–1.0.
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/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.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/video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt