models

suno-api

Markdown · JSON

suno-api

Suno สร้างดนตรีจากแนวคิดสั้น ๆ ที่เขียนไว้ ขั้นตอนอัตโนมัติที่ระบุไว้ในเอกสารสร้างเพลง 2 เพลงและมีตัวเลือกเพลงบรรเลง โดยส่งไฟล์เสียงที่เสร็จแล้วและข้อมูลเมตาของเพลงกลับมาผ่านงานสร้าง

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

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

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

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

สำหรับผลลัพธ์ที่เป็นเพลงบรรเลง ใช้ตัวเลือกเพลงบรรเลงที่ระบุไว้ในเอกสารและอธิบายแนวทางดนตรีในข้อความ ระบุบรรยากาศที่ต้องการและเครื่องดนตรีเด่นเมื่อสิ่งเหล่านั้นสำคัญต่อโครงการ ตรวจฟังเพลงที่เสร็จแล้วโดยคำนึงถึงตำแหน่งที่จะใช้ในงานตัดต่อ รวมถึงช่วงที่ต้องเป็นพื้นหลังให้เสียงพูดหรือช่วยเสริมการเปลี่ยนผ่านทางภาพ

ขั้นตอนอัตโนมัติสร้างเพลง 2 เพลงจากแนวคิดที่ส่งไป พิจารณาทั้งสองเพลงเป็นตัวเลือกแยกกันและเก็บไฟล์เสียงที่เสร็จแล้วทั้งสองไฟล์ ฟังแต่ละเพลงให้ครบช่วงเปิด พัฒนาการ และตอนจบ เปรียบเทียบเพลงจริงกับจุดมุ่งหมายเดียวกัน รวมถึงอารมณ์ การเรียบเรียง และความเหมาะสมกับการใช้งานที่วางแผนไว้

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

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

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

Ailoot Ultra · Music POST /v1/music/generations suno-api

suno-api

Suno /suno-api

เริ่มต้น

Suno สร้างดนตรีจากแนวคิดสั้น ๆ ที่เขียนไว้ ขั้นตอนอัตโนมัติที่ระบุไว้ในเอกสารสร้างเพลง 2 เพลงและมีตัวเลือกเพลงบรรเลง โดยส่งไฟล์เสียงที่เสร็จแล้วและข้อมูลเมตาของเพลงกลับมาผ่านงานสร้าง

อินพุตที่รองรับ
ข้อความ
ผลลัพธ์
เสียง · รูปภาพ · วิดีโอ

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · Music POST /v1/music/generations
ขาเข้า
text
ขาออก
audio, image, video
ฟิลด์ประเภทข้อกำหนดค่าและข้อจำกัดค่าเริ่มต้น
ฟิลด์modelประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
suno-api
เงื่อนไข: ใช้ตัวเลือกระบุเส้นทางของ Ailoot นี้ตามที่ระบุไว้ทุกตัวอักษร
ค่าเริ่มต้น—
ฟิลด์gpt_description_promptประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
เงื่อนไข: อธิบายแนวคิดดนตรีหรือหัวข้อของเพลง
ค่าเริ่มต้น—
ฟิลด์mvประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5
เงื่อนไข: เลือกเวอร์ชัน Suno ที่ระบุไว้ในเอกสารอย่างชัดเจน ตัวอย่างใช้ chirp-crow (v5)
ค่าเริ่มต้น—
ฟิลด์make_instrumentalประเภทbooleanข้อกำหนดจำเป็นค่าและข้อจำกัด
เงื่อนไข: กำหนด true สำหรับดนตรีบรรเลง หรือ false สำหรับเพลงที่มีเสียงร้อง
ค่าเริ่มต้น—
พารามิเตอร์และวงจรการทำงานของเมธอด
พารามิเตอร์ข้อกำหนด
พารามิเตอร์content_typeข้อกำหนดapplication/json
พารามิเตอร์requiredข้อกำหนดmodel, gpt_description_prompt, mv, make_instrumental
พารามิเตอร์optionalข้อกำหนด
พารามิเตอร์material_typesข้อกำหนดtext
พารามิเตอร์conditionsข้อกำหนดใช้ตัวเลือกระบุเส้นทางของ Ailoot นี้ตามที่ระบุไว้ทุกตัวอักษร, อธิบายแนวคิดดนตรีหรือหัวข้อของเพลง, เลือกเวอร์ชัน Suno ที่ระบุไว้ในเอกสารอย่างชัดเจน ตัวอย่างใช้ chirp-crow (v5), กำหนด true สำหรับดนตรีบรรเลง หรือ false สำหรับเพลงที่มีเสียงร้อง

วงจรการทำงาน: submit_once_poll_original

GET /v1/music/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

ราคา

วิธีคำนวณค่าบริการสุดท้าย

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

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว
ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น
ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด
ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

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

การตั้งค่าตารางอัตราค่าบริการปริมาณคาดการณ์ปริมาณที่คิดค่าบริการค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐานตารางอัตราค่าบริการอัตราพื้นฐานปริมาณคาดการณ์—ปริมาณที่คิดค่าบริการ—ค่าบริการ
ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าต่อคำขอตารางอัตราค่าบริการ—ปริมาณคาดการณ์—ปริมาณที่คิดค่าบริการหนึ่งคำขอค่าบริการ
ขาเข้า · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.2 ต่อคำขอ
การตั้งค่าต้นทุนการสร้างโดยประมาณตารางอัตราค่าบริการ—ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้งปริมาณที่คิดค่าบริการ—ค่าบริการ
ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.2 ประมาณการก่อนสร้าง

ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →

ตัวอย่างคำขอ

Ailoot Ultra · Music

curl · สร้างครั้งเดียวและเก็บบันทึกยืนยันไว้อ่านข้อมูลงานต้นฉบับบันทึกชิ้นงานที่เสร็จสมบูรณ์และเป็นของคุณทุกรายการ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "suno-api",
  "gpt_description_prompt": "古诗词",
  "mv": "chirp-crow",
  "make_instrumental": false
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

รับและบันทึกผลลัพธ์

Ailoot Ultra · Music

ดาวน์โหลดภาพที่ส่งกลับมาทุกภาพ หรือบันทึกเนื้อหา Base64 ของภาพนั้น

  • GET /v1/music/generations/{request_id}
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

เก็บทุกการตอบกลับ ไฟล์ และส่วนเนื้อหาที่ส่งกลับมาอย่างครบถ้วน

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

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

เก็บ id งานหรือการดำเนินการสาธารณะที่ส่งกลับและส่วนหัวทั้งหมด อ่านเฉพาะงานเดิม สถานะ unknown หรือ result_pending_check ไม่อนุญาตให้สร้างอีกครั้ง

ฟิลด์การตอบกลับ
ฟิลด์ประเภท
ฟิลด์idประเภทstring
ฟิลด์polling_urlประเภทstring
ฟิลด์provider_task_idประเภทstring
ฟิลด์data.task_idประเภทstring
ฟิลด์data.statusประเภทstring
ฟิลด์data.data[].audio_urlประเภทstring
ฟิลด์data.data[].image_urlประเภทstring
ฟิลด์data.data[].image_large_urlประเภทstring
ฟิลด์data.data[].video_urlประเภทstring

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra suno-api

ชื่อพาธเมธอดอื่น

ใช้พาธเมธอดที่แสดงด้านบน

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

suno-api

FAQ · suno-api
มีอินพุตและผลลัพธ์ใดบ้าง?

POST /v1/music/generations · suno-api: text → audio, image, video

คำขอใช้ฟิลด์ใดบ้าง?

POST /v1/music/generations · suno-api: model, gpt_description_prompt, mv, make_instrumental

รายละเอียดเพิ่มเติม

เชื่อม Ailoot กับ Claude Code, OpenCode, Hermes หรือแอปของคุณ

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.

ซื้อโทเคนพร้อมส่วนลด

ส่วนลดสมาชิกสำหรับงานประจำ โค้ดโปรโมชั่นลดซื้อโทเคนสูงสุด 50%

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

เลือกสมาชิก · ดูราคาโมเดล

เชื่อม API กับผลิตภัณฑ์ ที่คุณขาย

SaaS แอป และบอต ตามข้อเสนอและสัญญาอนุญาต Ailoot หากขายต่อให้ขอใบอนุญาตรีเซลเลอร์

แอปเชิงพาณิชย์
ใส่การสร้างข้อความ ภาพ วิดีโอ และเสียงในฟีเจอร์เสียเงินของบริการคุณ
ใบอนุญาตรีเซลเลอร์
ส่งคำอธิบายโครงการและรูปแบบการเข้าถึง ขอเงื่อนไขใช้และขายต่อเป็นลายลักษณ์อักษร
เอกสารบนเว็บไซต์
อ่านข้อเสนอ สัญญาอนุญาต และนโยบายประมวลผลข้อมูลก่อนเชื่อมได้

ขอใบอนุญาตขายต่อ · ข้อเสนอและสัญญาอนุญาต