Bỏ qua

Tài liệu API Endpoint Ghép nối âm thanh

Giá cả

25 credits cho mỗi yêu cầu

Chi phí cố định bất kể số lượng tệp âm thanh hay tổng thời lượng.

Tổng quan

Endpoint https://api.revidapi.com/paid/audio/concatenate cung cấp chức năng để kết hợp nhiều tệp âm thanh thành một tệp âm thanh duy nhất.

Tutorials RevidAPI

Endpoint

  • URL: https://api.revidapi.com/paid/audio/concatenate
  • Method: POST

Yêu cầu

Headers

  • x-api-key: Bắt buộc. API key xác thực của bạn.

Tham số Body

Tham số Kiểu Bắt buộc Mô tả
audio_urls Array Có Mảng các đối tượng, mỗi đối tượng chứa thuộc tính audio_url trỏ đến tệp âm thanh cần ghép nối. Phải chứa ít nhất một mục.
webhook_url String Không URL để nhận thông báo callback khi xử lý hoàn tất. Nếu được cung cấp, yêu cầu sẽ được xử lý không đồng bộ.
id String Không Mã định danh tùy chỉnh để theo dõi yêu cầu.

Mỗi đối tượng trong mảng audio_urls phải có: - audio_url: String (định dạng URI). URL của tệp âm thanh cần ghép nối.

Ví dụ yêu cầu

{
  "audio_urls": [
    { "audio_url": "https://example.com/audio1.mp3" },
    { "audio_url": "https://example.com/audio2.mp3" },
    { "audio_url": "https://example.com/audio3.mp3" }
  ],
  "webhook_url": "https://your-webhook-endpoint.com/callback",
  "id": "custom-request-id-123"
}

Ví dụ lệnh cURL

curl -X POST \
  https://api.revidapi.com/paid/audio/concatenate \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: your-api-key-here' \
  -d '{
    "audio_urls": [
      { "audio_url": "https://example.com/audio1.mp3" },
      { "audio_url": "https://example.com/audio2.mp3" }
    ],
    "webhook_url": "https://your-webhook-endpoint.com/callback",
    "id": "custom-request-id-123"
  }'

Phản hồi

Phản hồi đồng bộ (Không cung cấp webhook_url)

Nếu không cung cấp webhook_url, yêu cầu sẽ được xử lý đồng bộ và trả về:

{
  "code": 200,
  "id": "custom-request-id-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "response": "https://storage.example.com/combined-audio-file.mp3",
  "message": "success",
  "run_time": 2.345,
  "queue_time": 0,
  "total_time": 2.345,
  "pid": 12345,
  "queue_id": 67890,
  "queue_length": 0,
  "build_number": "1.0.123"
}

Phản hồi không đồng bộ (cung cấp webhook_url)

Nếu cung cấp webhook_url, yêu cầu sẽ được đưa vào hàng đợi để xử lý và ngay lập tức trả về:

{
  "code": 202,
  "id": "custom-request-id-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "processing",
  "pid": 12345,
  "queue_id": 67890,
  "max_queue_length": "unlimited",
  "queue_length": 1,
  "build_number": "1.0.123"
}

Khi xử lý hoàn tất, một webhook sẽ được gửi đến URL đã cung cấp với payload sau:

{
  "endpoint": "/v1/audio/concatenate",
  "code": 200,
  "id": "custom-request-id-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "response": "https://storage.example.com/combined-audio-file.mp3",
  "message": "success",
  "pid": 12345,
  "queue_id": 67890,
  "run_time": 3.456,
  "queue_time": 1.234,
  "total_time": 4.690,
  "queue_length": 0,
  "build_number": "1.0.123"
}

Phản hồi lỗi

Định dạng yêu cầu không hợp lệ (400 Bad Request)

{
  "code": 400,
  "id": null,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Invalid request: 'audio_urls' is a required property",
  "pid": 12345,
  "queue_id": 67890,
  "queue_length": 0,
  "build_number": "1.0.123"
}

Lỗi xác thực (401 Unauthorized)

{
  "code": 401,
  "message": "Invalid or missing API key",
  "build_number": "1.0.123"
}

Đạt giới hạn hàng đợi (429 Too Many Requests)

{
  "code": 429,
  "id": "custom-request-id-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "MAX_QUEUE_LENGTH (100) reached",
  "pid": 12345,
  "queue_id": 67890,
  "queue_length": 100,
  "build_number": "1.0.123"
}

Lỗi xử lý (500 Internal Server Error)

{
  "code": 500,
  "id": "custom-request-id-123",
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Error downloading audio file: Connection refused",
  "pid": 12345,
  "queue_id": 67890,
  "queue_length": 0,
  "build_number": "1.0.123"
}

Xử lý lỗi

  • Thiếu tham số bắt buộc: Nếu audio_urls bị thiếu hoặc rỗng, phản hồi 400 Bad Request sẽ được trả về.
  • Định dạng URL không hợp lệ: Nếu bất kỳ audio_url nào không phải là URI hợp lệ, phản hồi 400 Bad Request sẽ được trả về.
  • Lỗi xác thực: Nếu API key không hợp lệ hoặc thiếu, phản hồi 401 Unauthorized sẽ được trả về.
  • Giới hạn hàng đợi: Nếu hàng đợi đầy (khi MAX_QUEUE_LENGTH được đặt), phản hồi 429 Too Many Requests sẽ được trả về.
  • Lỗi xử lý: Bất kỳ lỗi nào trong quá trình tải xuống, xử lý hoặc tải lên âm thanh sẽ dẫn đến phản hồi 500 Internal Server Error với chi tiết trong trường message.

Ghi chú sử dụng

  1. Xử lý không đồng bộ: Đối với tệp âm thanh dài, nên sử dụng tham số webhook_url để xử lý yêu cầu không đồng bộ.
  2. Định dạng tệp: Dịch vụ hỗ trợ các định dạng âm thanh phổ biến. Đầu ra sẽ ở định dạng chuẩn (thường là MP3).
  3. Kích thước tệp: Có thể có giới hạn về kích thước tệp âm thanh có thể xử lý. Tệp rất lớn có thể gây timeout hoặc lỗi.
  4. Hành vi hàng đợi: Nếu hệ thống đang chịu tải cao, các yêu cầu với webhook_url sẽ được đưa vào hàng đợi. Biến môi trường MAX_QUEUE_LENGTH điều khiển kích thước hàng đợi tối đa.

Vấn đề thường gặp

  1. URL âm thanh không thể truy cập: Đảm bảo tất cả URL âm thanh có thể truy cập công khai. URL riêng tư hoặc yêu cầu xác thực sẽ gây lỗi.
  2. Định dạng âm thanh không tương thích: Một số định dạng âm thanh lạ có thể không được hỗ trợ. Sử dụng các định dạng phổ biến như MP3, WAV, hoặc AAC.
  3. Lỗi Webhook: Nếu endpoint webhook của bạn không khả dụng khi xử lý hoàn tất, bạn có thể không nhận được thông báo hoàn thành.
  4. Vấn đề Timeout: Tệp âm thanh rất lớn có thể gây timeout trong quá trình tải xuống hoặc xử lý.

Thực hành tốt nhất

  1. Sử dụng Webhooks cho tệp lớn: Luôn sử dụng phương pháp webhook cho tệp âm thanh lớn hoặc khi ghép nối nhiều tệp.
  2. Bao gồm ID: Luôn bao gồm tham số id tùy chỉnh để giúp theo dõi yêu cầu của bạn, đặc biệt trong phản hồi webhook.
  3. Xử lý lỗi: Triển khai xử lý lỗi mạnh mẽ trong ứng dụng khách của bạn để xử lý các mã trạng thái HTTP khác nhau.
  4. Độ tin cậy Webhook: Đảm bảo endpoint webhook của bạn đáng tin cậy và có thể xử lý thử lại nếu cần.
  5. Chuẩn bị tệp: Xử lý trước tệp âm thanh của bạn để đảm bảo chúng có định dạng tương thích, tốc độ mẫu và cấu hình kênh để có kết quả tốt nhất.
  6. Giám sát hàng đợi: Giám sát queue_length trong phản hồi để hiểu tải hệ thống và điều chỉnh mẫu yêu cầu của bạn nếu cần.

Giá cả

25 credits cho mỗi yêu cầu

Chi phí cố định bất kể số lượng tệp âm thanh hay tổng thời lượng.