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

Elevenlabs Music v2

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

ID โมเดล elevenlabs/music/v2
# 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/elevenlabs/music/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

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

ไฟล์เช่นเดียวกับตัวอย่าง: $1.20 1,200 เครดิต API ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API
ElevenLabs ข้อความเป็นเพลง #music#text-to-music

ประพันธ์เพลงจากพรอมต์ข้อความหรือแผนการประพันธ์แบบแบ่งชิ้น พร้อมโหมดเพลงบรรเลงเท่านั้นที่เลือกใช้ได้

ElevenLabs · เสียง

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

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

สร้างคำขอ

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

88 / 4100

คำอธิบายข้อความของเพลงที่ต้องการ

ระยะเวลาเพลงที่ระบุได้เป็นมิลลิวินาที ตั้งแต่ 3000 ms ถึง 600000 ms ใช้ได้เฉพาะเมื่อใช้พรอมต์ เมื่อไม่ระบุ โมเดลจะกำหนดระยะเวลาจากพรอมต์

ขั้นสูง output_format · seed · force_instrumental · composition_plan
ค่าเริ่มต้น mp3_48000_192

เลือกรูปแบบเสียงที่สร้างโดยใช้รูปแบบ codec_sample_rate_bitrate อินพุตเสียงของ Twilio มักใช้ μ-law ซึ่งเขียนเป็น mu-law หรือประมาณเป็น u-law ได้เช่นกัน ตัวอย่าง MP3 คือ mp3_22050_32 ซึ่งระบุอัตราการสุ่มตัวอย่าง 22.05 kHz และบิตเรต 32 kbs

ซีดสำหรับเริ่มต้นการสร้างเพลง ใช้ได้เฉพาะร่วมกับ `composition_plan` เพื่อเพิ่มความสอดคล้องระหว่างการทำงานที่ใช้พารามิเตอร์และซีดเดียวกัน แต่ไม่รับประกันว่าผลลัพธ์จะเหมือนเดิมทุกประการ

แผนองค์ประกอบเพลงที่จัดระเบียบเป็นชิ้น

POST /run/elevenlabs/music/v2?wait=20 ใบเสนอราคา → $1.20
# 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/elevenlabs/music/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

เกี่ยวกับ Elevenlabs Music v2

สร้างเพลงจาก `prompt` ข้อความที่มีความยาวสูงสุด 4100 อักขระ หรือจาก `composition_plan` แบบมีโครงสร้าง `music_length_ms` กำหนดความยาวระหว่าง 3000 ถึง 600000 ms เมื่อใช้ร่วมกับพรอมต์ และ `force_instrumental` จะลบเสียงร้อง `output_format` เลือกตัวแปลงสัญญาณ อัตราสุ่มตัวอย่าง และบิตเรต รวมถึงตัวเลือก MP3 และ PCM `seed` ใช้ได้เฉพาะกับแผนการประพันธ์เพลง

พารามิเตอร์

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
promptไม่บังคับ
ประเภทstring | null
≤ 4,100 อักขระ
คำอธิบายข้อความของเพลงที่ต้องการ
composition_planไม่บังคับ
ประเภทobject
แผนองค์ประกอบเพลงที่จัดระเบียบเป็นชิ้น
composition_plan.chunksจำเป็น
ประเภทobject[]
1 – 30 items
ชิ้นที่ใช้สำหรับการสร้างตามลำดับ จำกัดไม่เกิน 30 ชิ้น โดยมีระยะเวลารวมตั้งแต่ 3000 ms ถึง 600000 ms
composition_plan.chunks[].textจำเป็น
ประเภทstring
ข้อความสำหรับการสร้างชิ้น จำกัดไม่เกิน 30 บรรทัด โดยแต่ละบรรทัดมีได้สูงสุด 200 อักขระ เนื้อร้องอาจมีคำสั่งในบรรทัดเดียวกันภายในวงเล็บปีกกา เช่น {scratching} และอาจขึ้นต้นด้วยชื่อส่วนประกอบในวงเล็บเหลี่ยม เช่น [Verse 1] ชื่อส่วนประกอบนั้นต้องมีความยาว 1–100 อักขระ
composition_plan.chunks[].duration_msจำเป็น
ประเภทinteger
3,000 – 120,000
ความยาวชิ้นเป็นมิลลิวินาที ตั้งแต่ 3000 ms ถึง 120000 ms
composition_plan.chunks[].positive_stylesจำเป็น
ประเภทstring[]
สไตล์และทิศทางดนตรีที่ต้องการสำหรับชิ้นนี้ โดยตัวเลือกของชิ้นแรกมีอิทธิพลมากที่สุดและจะกำหนดแนวเพลงและโทนโดยรวมของเพลง ชิ้นถัดมาอาจพัฒนาดนตรี เพิ่มความละเอียด หรือเปลี่ยนทิศทาง คำอธิบายภาษาอังกฤษให้ผลดีที่สุด
composition_plan.chunks[].negative_stylesไม่บังคับ
ประเภทstring[]
สไตล์และทิศทางดนตรีที่ต้องการหลีกเลี่ยงในชิ้นนี้ ให้ระบุรายการเฉพาะสิ่งที่ต้องการตัดออกอย่างชัดเจน มิฉะนั้นการปล่อยรายการว่างไว้จะเป็นค่าเริ่มต้นที่เหมาะสม
composition_plan.chunks[].context_adherenceไม่บังคับ
ประเภทenum
lowmediumhigh
การยึดตามบริบทช่วยปรับสมดุลระหว่างอิสระในการสร้างสรรค์กับความสอดคล้องกับชิ้นข้างเคียง ให้เลือกค่าสูงเพื่อความสอดคล้อง หรือค่าต่ำเพื่อเปิดโอกาสให้แตกต่างอย่างสร้างสรรค์มากขึ้น
composition_plan.chunks[].audio_referenceไม่บังคับ
ประเภทobject
คลิปเสียงสำหรับกำหนดสไตล์ของชิ้นนี้ หากต้องการกำหนดทั้งเพลง ให้ระบุในชิ้นแรก ตำแหน่งนี้มีอิทธิพลมากที่สุด เนื่องจากเสียงอ้างอิงจะส่งผลต่อชิ้นถัดมาทั้งหมด
music_length_msไม่บังคับ
ประเภทinteger | null
3,000 – 600,000
ระยะเวลาเพลงที่ระบุได้เป็นมิลลิวินาที ตั้งแต่ 3000 ms ถึง 600000 ms ใช้ได้เฉพาะเมื่อใช้พรอมต์ เมื่อไม่ระบุ โมเดลจะกำหนดระยะเวลาจากพรอมต์
force_instrumentalไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
การควบคุมให้มีเฉพาะดนตรีบรรเลง ใช้ได้เฉพาะเมื่อใช้พรอมต์ การตั้งค่าเป็น true จะรับประกันเอาต์พุตที่เป็นดนตรีบรรเลง ส่วน false อนุญาตให้สร้างเพลงบรรเลงหรือไม่บรรเลงตามพรอมต์
seedไม่บังคับ
ประเภทinteger | null
ซีดสำหรับเริ่มต้นการสร้างเพลง ใช้ได้เฉพาะร่วมกับ `composition_plan` เพื่อเพิ่มความสอดคล้องระหว่างการทำงานที่ใช้พารามิเตอร์และซีดเดียวกัน แต่ไม่รับประกันว่าผลลัพธ์จะเหมือนเดิมทุกประการ
output_formatไม่บังคับ
ประเภทenum
ค่าเริ่มต้นmp3_48000_192
mp3_22050_32mp3_24000_48mp3_44100_32mp3_44100_64mp3_44100_96mp3_44100_128mp3_44100_192mp3_48000_128mp3_48000_192mp3_48000_240mp3_48000_320pcm_8000pcm_16000pcm_22050pcm_24000pcm_32000
เพิ่มเติมอีก 9 ค่าpcm_44100pcm_48000ulaw_8000alaw_8000opus_48000_32opus_48000_64opus_48000_96opus_48000_128opus_48000_192
เลือกรูปแบบเสียงที่สร้างโดยใช้รูปแบบ codec_sample_rate_bitrate อินพุตเสียงของ Twilio มักใช้ μ-law ซึ่งเขียนเป็น mu-law หรือประมาณเป็น u-law ได้เช่นกัน ตัวอย่าง MP3 คือ mp3_22050_32 ซึ่งระบุอัตราการสุ่มตัวอย่าง 22.05 kHz และบิตเรต 32 kbs
จำเป็น

เอาต์พุต

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "elevenlabs/music/v2",
  "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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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
    }
  },
  "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}ไฟล์เพลงที่สร้างขึ้นและเข้ารหัสเป็นเสียง MP3

โมเดลเพิ่มเติม: ข้อความเป็นเพลง

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