Bỏ qua đến nội dung

Sam Audio · Span Separate

Tích hợp

Id mô hình sam-audio/span-separate
# 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-audio/span-separate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  }'

# 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"

Các tệp như ví dụ: 0,05 $ 50 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Meta Âm thanh 10–60 s #audio-to-audio#sam-audio

Tách âm thanh khỏi tệp âm thanh bằng các khoảng thời gian bạn cung cấp, với gợi ý văn bản tùy chọn

Meta · Dữ liệu (JSON)

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

Trợ giúp nhận diện âm thanh để trích xuất âm thanh từ đoạn. Nên cung cấp mô tả văn bản của âm thanh cần tách, nhưng không bắt buộc.

•bắt buộc audio_url
Thả tệp hoặc

URL tệp âm thanh để xử lý.

mặc định 1

Số lượng ứng viên chỉ được dùng với lời nhắc văn bản: số lượng ứng viên tương ứng sẽ được tạo và xếp hạng. Phân tách chỉ theo đoạn sẽ bỏ qua thiết lập này.

•bắt buộc

Các khoảng thời gian chứa âm thanh mục tiêu cần tách.

Nâng cao acceleration · output_format · max_chunk_duration · chunk_overlap · use_sound_activity_ranking · trim_to_span
acceleration mặc định balanced

Mức tăng tốc áp dụng cho quá trình xử lý.

output_format mặc định wav

Định dạng âm thanh được tạo.

mặc định 60

Giới hạn âm thanh cho mỗi lượt xử lý, tính bằng giây; khi vượt quá giới hạn, quá trình xử lý sử dụng các đoạn chồng lấn được hòa trộn với nhau.

mặc định 5

Độ dài phần chồng lấn giữa các đoạn, tính bằng giây, dùng để hòa trộn crossfade.

POST /run/sam-audio/span-separate?wait=20 báo giá → 0,05 $
# 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-audio/span-separate?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  }'

# 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Sam Audio · Span Separate

Thay vì chỉ dựa vào văn bản, bạn truyền `spans` đánh dấu thời điểm âm thanh mục tiêu xuất hiện trong `audio_url`. `prompt` là tùy chọn nhưng giúp xác định loại âm thanh. `trim_to_span` có thể cắt đầu ra theo phạm vi span, còn `use_sound_activity_ranking` cho phép xếp hạng lại mà không cần lời nhắc. Trả về âm thanh `target` và `residual` ở định dạng wav hoặc mp3.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
audio_urlbắt buộc audio
Kiểuurl · audio
URL tệp âm thanh để xử lý.
prompttùy chọn
Kiểustring | null
Trợ giúp nhận diện âm thanh để trích xuất âm thanh từ đoạn. Nên cung cấp mô tả văn bản của âm thanh cần tách, nhưng không bắt buộc.
spansbắt buộc
Kiểuobject[]
Các khoảng thời gian chứa âm thanh mục tiêu cần tách.
spans[].startbắt buộc
Kiểunumber
≥ 0
Dấu thời gian bắt đầu đoạn, tính bằng giây.
spans[].endbắt buộc
Kiểunumber
≥ 0
Dấu thời gian kết thúc đoạn, tính bằng giây.
spans[].includetùy chọn
Kiểuboolean
Mặc địnhtrue
Có bao gồm âm thanh trong đoạn hay không: True bao gồm, còn False loại trừ.
reranking_candidatestùy chọn
Kiểuinteger
Mặc định1
1 – 7
Số lượng ứng viên chỉ được dùng với lời nhắc văn bản: số lượng ứng viên tương ứng sẽ được tạo và xếp hạng. Phân tách chỉ theo đoạn sẽ bỏ qua thiết lập này.
accelerationtùy chọn
Kiểuenum
Mặc địnhbalanced
fastbalancedquality
Mức tăng tốc áp dụng cho quá trình xử lý.
max_chunk_durationtùy chọn
Kiểunumber
Mặc định60
10 – 60
Giới hạn âm thanh cho mỗi lượt xử lý, tính bằng giây; khi vượt quá giới hạn, quá trình xử lý sử dụng các đoạn chồng lấn được hòa trộn với nhau.
chunk_overlaptùy chọn
Kiểunumber
Mặc định5
0 – 30
Độ dài phần chồng lấn giữa các đoạn, tính bằng giây, dùng để hòa trộn crossfade.
use_sound_activity_rankingtùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn xếp hạng hoạt động âm thanh yêu cầu reranking_candidates > 1, cho phép xếp hạng lại hiệu quả khi phân tách chỉ theo đoạn mà không có lời nhắc văn bản. Các ứng viên được chấm điểm dựa trên mức độ các vùng không im lặng được phát hiện khớp với các đoạn đã cung cấp.
trim_to_spantùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn độ dài đầu ra giữa riêng đoạn được chỉ định và toàn bộ âm thanh. Khi bật, tùy chọn này cắt theo phạm vi thời gian của đoạn; False giữ nguyên toàn bộ độ dài và tách âm thanh mục tiêu xuyên suốt.
output_formattùy chọn
Kiểuenum
Mặc địnhwav
wavmp3
Định dạng âm thanh được tạo.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-audio/span-separate",
  "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": 50,
    "usd": "0.05",
    "charged": 50,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "spans": [
      {
        "end": 10,
        "include": true,
        "start": 6
      }
    ]
  },
  "output": {
    "target": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "residual": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "duration": 5,
    "sample_rate": 48000
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
target
object {url, content_type, file_name, file_size}Âm thanh mục tiêu được trích xuất riêng.
residual
object {url, content_type, file_name, file_size}Âm thanh còn lại ngoài âm thanh mục tiêu.
duration
numberĐộ dài âm thanh đầu ra, tính bằng giây.
sample_rate
integerTần số lấy mẫu tính bằng Hz của âm thanh đầu ra.

Thêm mô hình: Âm thanh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/sam-audio/span-separate.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt