Langkau ke kandungan

Sam 3 · Video RLE

Integrasikan

ID model sam-3/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/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"

Fail seperti contoh: $0.095 95 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

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

Segmentasi video dengan penyemaian URL topeng, kawalan indeks bingkai dan had bawah ambang pengesanan yang lebih rendah

Meta · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

lalai

Prompt pembahagian yang menyokong berbilang objek dijejak melalui perihalan dipisahkan koma, seperti 'person, cloth'.

•diperlukan video_url
Lepaskan fail, atau

URL video untuk pembahagian.

Lanjutan mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
Lepaskan fail, atau

URL topeng untuk penggunaan awal.

lalai 0.5

Had keyakinan pengesanan dengan lalai 0.5 untuk objek sedia ada dan 0.7 untuk objek baharu. Dalam julat 0.0–1.0, nilai lebih kecil mengorbankan ketepatan demi lebih banyak pengesanan; cuba 0.2–0.3 apabila prompt teks gagal.

lalai 0

Indeks bingkai untuk interaksi awal apabila membekalkan mask_url.

lalai []

Senarai prompt titik yang menetapkan indeks bingkai.

lalai []

Senarai prompt kotak, dengan frame_index pilihan bagi setiap entri.

POST /run/sam-3/video-rle?wait=20 sebut 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-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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Sam 3 · Video RLE

Membahagi video dengan SAM 3 menggunakan `prompt` teks, prompt titik atau kotak, atau topeng awal daripada `mask_url` yang digunakan pada `frame_index`. `detection_threshold` adalah antara 0.01 hingga 1, dan nilai lebih rendah seperti 0.2 hingga 0.3 mungkin membantu apabila prompt teks gagal. Boleh mengembalikan zip kotak pembatas bagi setiap bingkai melalui `boundingbox_zip`.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
video_urldiperlukan video
Jenisurl · video
URL video untuk pembahagian.
mask_urlpilihan mask
Jenisurl · image
URL topeng untuk penggunaan awal.
promptpilihan
Jenisstring
Lalai
Prompt pembahagian yang menyokong berbilang objek dijejak melalui perihalan dipisahkan koma, seperti 'person, cloth'.
point_promptspilihan
Jenisobject[]
Lalai[]
Senarai prompt titik yang menetapkan indeks bingkai.
point_prompts[].xpilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi X.
point_prompts[].ypilihan
Jenisinteger | null
Kedudukan prompt sepanjang paksi Y.
point_prompts[].labelpilihan
Jenisenum
01
Label latar depan/latar belakang: 1 menunjukkan latar depan; 0 menunjukkan latar belakang.
point_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan prompt untuk memperhalus satu objek. Jika teks juga diberikan sebagai prompt, pengecam ini menentukan objek yang dikesan untuk diperhalus oleh titik tersebut.
point_prompts[].frame_indexpilihan
Jenisinteger | null
Indeks yang mengenal pasti bingkai untuk interaksi.
box_promptspilihan
Jenisobject[]
Lalai[]
Senarai prompt kotak, dengan frame_index pilihan bagi setiap entri.
box_prompts[].x_minpilihan
Jenisinteger | null
Koordinat x minimum untuk kotak.
box_prompts[].y_minpilihan
Jenisinteger | null
Koordinat y minimum untuk kotak.
box_prompts[].x_maxpilihan
Jenisinteger | null
Koordinat X maksimum untuk kotak.
box_prompts[].y_maxpilihan
Jenisinteger | null
Koordinat Y maksimum untuk kotak.
box_prompts[].object_idpilihan
Jenisinteger | null
Pengecam pilihan yang mengumpulkan kotak untuk memperhalus satu objek.
box_prompts[].frame_indexpilihan
Jenisinteger | null
Indeks yang mengenal pasti bingkai untuk interaksi.
apply_maskpilihan
Jenisboolean
Lalaifalse
Sama ada topeng hendak digunakan pada video.
boundingbox_zippilihan
Jenisboolean
Lalaifalse
Sama ada arkib ZIP yang mengandungi tindanan kotak sempadan bagi setiap bingkai hendak dikembalikan.
detection_thresholdpilihan
Jenisnumber
Lalai0.5
0.01 – 1
Had keyakinan pengesanan dengan lalai 0.5 untuk objek sedia ada dan 0.7 untuk objek baharu. Dalam julat 0.0–1.0, nilai lebih kecil mengorbankan ketepatan demi lebih banyak pengesanan; cuba 0.2–0.3 apabila prompt teks gagal.
frame_indexpilihan
Jenisinteger
Lalai0
Indeks bingkai untuk interaksi awal apabila membekalkan mask_url.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan melalui pembahagian.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArkib ZIP tindanan kotak sempadan bagi setiap bingkai.

Lebih banyak model: Video ke Video

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