ข้ามไปยังเนื้อหา

Ffmpeg Api · Loudnorm

ผสานการทำงาน

ID โมเดล ffmpeg-api/loudnorm
# 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/ffmpeg-api/loudnorm?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"
  }'

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

สูงสุด $0.306 ต่อการเรียกใช้ คิดค่าบริการตามการใช้งานจริง ส่วนที่เหลือจะคืนเงิน เรียกใช้ในหน้านี้

รับคีย์ API
Utility เสียง #ffmpeg

ปรับความดังของเสียงให้เป็นมาตรฐานตามเป้าหมาย EBU R128 พร้อมการตั้งค่า LUFS, true peak และช่วงไดนามิกที่ปรับได้

Utility · เสียง

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น audio_url
วางไฟล์ หรือ

URL ที่ชี้ไปยังไฟล์เสียงที่ต้องปรับระดับให้เป็นมาตรฐาน

ขั้นสูง integrated_loudness · true_peak · loudness_range · offset · measured_i · measured_lra · measured_tp · measured_thresh · linear · dual_mono · print_summary
ค่าเริ่มต้น -18

ค่าเป้าหมายสำหรับความดังแบบรวม ระบุเป็น LUFS

ค่าเริ่มต้น -0.1

เพดาน true-peak ระบุเป็น dBTP

ค่าเริ่มต้น 7

ช่วงเป้าหมายสำหรับความดัง ระบุเป็น LU

ค่าเริ่มต้น 0

ค่าออฟเซ็ตเกน ระบุเป็น dB และใช้ก่อนตัวจำกัด true-peak

การวัดความดังแบบรวมที่โหมดเชิงเส้นต้องใช้จากไฟล์อินพุต ระบุเป็น LUFS

การวัดช่วงความดังที่โหมดเชิงเส้นต้องใช้ โดยนำมาจากไฟล์อินพุตและระบุเป็น LU

การวัด true-peak ที่โหมดเชิงเส้นต้องใช้ ระบุเป็น dBTP จากไฟล์อินพุต

ค่าขีดจำกัดที่วัดได้ของเสียงอินพุต ระบุเป็น LUFS และจำเป็นเมื่อใช้โหมดเชิงเส้น

POST /run/ffmpeg-api/loudnorm?wait=20 ใบเสนอราคา → $0.306
# 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/ffmpeg-api/loudnorm?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"
  }'

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

เรียกใช้คำขอนี้

คีย์ของคุณจะอยู่ในเบราว์เซอร์นี้ โดยส่งไปยัง Doitong API เท่านั้น และจะบันทึกใน localStorage ก็ต่อเมื่อคุณเลือกจดจำ รับคีย์ API

เกี่ยวกับ Ffmpeg Api · Loudnorm

ใช้การปรับความดังให้เป็นมาตรฐานกับไฟล์ที่ `audio_url` เป้าหมายประกอบด้วย `integrated_loudness` (-70 ถึง -5 LUFS), `true_peak` (-9 ถึง 0 dBTP) และ `loudness_range` (1 ถึง 20 LU) โหมดสองรอบแบบไดนามิกเป็นค่าเริ่มต้น โหมดรอบเดียวแบบเชิงเส้นต้องใช้ค่าที่วัดได้ของอินพุต และสามารถส่งคืนสรุปการวัดได้

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
audio_urlจำเป็น audio
ประเภทurl · audio
URL ที่ชี้ไปยังไฟล์เสียงที่ต้องปรับระดับให้เป็นมาตรฐาน
integrated_loudnessไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น-18
-70 – -5
ค่าเป้าหมายสำหรับความดังแบบรวม ระบุเป็น LUFS
true_peakไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น-0.1
-9 – 0
เพดาน true-peak ระบุเป็น dBTP
loudness_rangeไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น7
1 – 20
ช่วงเป้าหมายสำหรับความดัง ระบุเป็น LU
offsetไม่บังคับ
ประเภทnumber
ค่าเริ่มต้น0
-99 – 99
ค่าออฟเซ็ตเกน ระบุเป็น dB และใช้ก่อนตัวจำกัด true-peak
linearไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
ตัวเลือกโหมดการปรับมาตรฐาน: false เลือกวิธีไดนามิกคุณภาพสูงแบบสองรอบ ส่วน true เลือกการประมวลผลเชิงเส้นแบบรอบเดียว
dual_monoไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
กำหนดว่าจะถือว่าอินพุตแบบโมโนเป็นดูอัลโมโนหรือไม่ เพื่อให้การวัดความดัง EBU R128 ถูกต้องบนระบบสเตอริโอ
print_summaryไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
รวมสรุปการวัดความดังไว้พร้อมกับเสียงที่ปรับมาตรฐานแล้ว
measured_iไม่บังคับ
ประเภทnumber | null
-99 – 0
การวัดความดังแบบรวมที่โหมดเชิงเส้นต้องใช้จากไฟล์อินพุต ระบุเป็น LUFS
measured_lraไม่บังคับ
ประเภทnumber | null
0 – 99
การวัดช่วงความดังที่โหมดเชิงเส้นต้องใช้ โดยนำมาจากไฟล์อินพุตและระบุเป็น LU
measured_tpไม่บังคับ
ประเภทnumber | null
-99 – 99
การวัด true-peak ที่โหมดเชิงเส้นต้องใช้ ระบุเป็น dBTP จากไฟล์อินพุต
measured_threshไม่บังคับ
ประเภทnumber | null
-99 – 0
ค่าขีดจำกัดที่วัดได้ของเสียงอินพุต ระบุเป็น LUFS และจำเป็นเมื่อใช้โหมดเชิงเส้น
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ file_url ของไฟล์ที่อัปโหลด ไฟล์

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ffmpeg-api/loudnorm",
  "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": 306,
    "usd": "0.306",
    "charged": 306,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "summary": {
      "input_integrated": 1.0,
      "input_true_peak": 1.0,
      "input_lra": 1.0,
      "input_threshold": 1.0,
      "output_integrated": 1.0,
      "output_true_peak": 1.0,
      "output_lra": 1.0,
      "output_threshold": 1.0,
      "normalization_type": "string",
      "target_offset": 1.0
    }
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "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"
  }
}
ไฟล์ของคุณ คุณเลือกเองทุก outputs[].url คือสำเนาบนพื้นที่จัดเก็บของเรา: เก็บไว้ตลอดไป (คิดค่าบริการต่อ GB-เดือน) หรือฟรี 7 วัน โดยกำหนดได้ในการตั้งค่าบัญชีหรือ ?storage=
รูปแบบเดียวกันในทุกโมเดลtype, url, content_type, width, height และ duration สำหรับภาพ วิดีโอ และเสียงเหมือนกันทั้งหมด ส่วน output คือออบเจ็กต์ผลลัพธ์ของโมเดลเอง
ฟิลด์ของเอาต์พุต
audio
object {url, content_type, file_name, file_size}ไฟล์เสียงหลังปรับมาตรฐาน
summary
object {input_integrated, input_true_peak, input_lra, input_threshold, output_integrated, output_true_peak, output_lra, output_threshold, normalization_type, target_offset} | nullสรุปการวัดความดังแบบมีโครงสร้าง ซึ่งส่งคืนเมื่อมีการร้องขอ

โมเดลเพิ่มเติม: เสียง

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/ffmpeg-api/loudnorm.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt