Langkau ke kandungan

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"

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

Membahagi dan menjejaki objek dalam video daripada prompt teks, titik atau kotak, lalu mengembalikan video bertopeng

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

[DEPRECATED] Input legasi yang dikekalkan untuk keserasian ke belakang; gunakan 'prompt' sebagai gantinya.

video_output_type lalai X264 (.mp4)

Jenis output untuk video yang terhasil.

lalai 0.5

Had keyakinan pengesanan; mengurangkan nilai ini meningkatkan bilangan pengesanan dengan mengorbankan ketepatan. Julatnya ialah 0.0–1.0.

lalai []

Koleksi prompt berasaskan titik.

lalai []

Prompt kotak yang disenaraikan sebagai tupel koordinat (x_min, y_min, x_max, y_max).

POST /run/sam-3/video?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?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

Mengesan dan menjejaki objek sepanjang video yang diberikan melalui `video_url`. Namakan sasaran dalam `prompt`, dengan memisahkan beberapa sasaran menggunakan koma, atau gunakan `point_prompts` dan `box_prompts`. `detection_threshold` berjulat antara 0.1 hingga 1, manakala `apply_mask` mengawal sama ada topeng dilukis pada video. Output ialah mp4 atau webm, serta zip tindanan kotak pembatas bagi setiap bingkai.

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.
promptpilihan
Jenisstring
Lalai
Prompt pembahagian yang menyokong berbilang objek dijejak melalui perihalan dipisahkan koma, seperti 'person, cloth'.
text_promptpilihan
Jenisstring | null
[DEPRECATED] Input legasi yang dikekalkan untuk keserasian ke belakang; gunakan 'prompt' sebagai gantinya.
point_promptspilihan
Jenisobject[]
Lalai[]
Koleksi prompt berasaskan titik.
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.
box_promptspilihan
Jenisobject[]
Lalai[]
Prompt kotak yang disenaraikan sebagai tupel koordinat (x_min, y_min, x_max, y_max).
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.
apply_maskpilihan
Jenisboolean
Lalaitrue
Sama ada topeng hendak digunakan pada video.
video_output_typepilihan
Jenisenum
LalaiX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Jenis output untuk video yang terhasil.
detection_thresholdpilihan
Jenisnumber
Lalai0.5
0.1 – 1
Had keyakinan pengesanan; mengurangkan nilai ini meningkatkan bilangan pengesanan dengan mengorbankan ketepatan. Julatnya ialah 0.0–1.0.
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",
  "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.md. Semua model dan panduan: https://doitong.com/developers/llms.txt