Suno API
AI music generation — create full songs with vocals, instruments, and lyrics from a text prompt.
curl -X POST https://runapi.ai/api/v1/suno/cover_audio \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
}'import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.coverAudio.run({
model: "suno-v5.5",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->coverAudio->run([
'model' => 'suno-v5.5',
'prompt' => 'Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.',
]);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.cover_audio.run(
model: "suno-v5.5",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
)npx skills add runapi-ai/suno -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorSuno generates complete songs from text prompts, including vocals, instrumentation, and lyrics. It spans V4 through V5.5, with each generation producing broadcast-ready tracks across any musical genre.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
قارن جميع إصدارات API
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
ثبّت skill Suno لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# Install the model skill for app development workflows
npx skills add runapi-ai/suno -gInstall the Suno skill for this app: 1. Add runapi-ai/suno with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
من model skill إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي Suno API؟
Suno is an AI music generation platform that creates original songs — vocals, instruments, and lyrics — from text descriptions. Through RunAPI, all Suno versions share a single API key with per-call billing.
لماذا تستخدم Suno API عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
How long can a generated song be?
حتى 8 دقائق لكل توليد على v4.5 وv5+ (الإصدارات السابقة حتى 4 دقائق). استخدم نقطة نهاية Extend لربط المقاطع وإنشاء مسارات أطول.
Can I provide my own lyrics?
Yes — pass lyrics with [Verse], [Chorus], and [Bridge] tags. You can also let Suno write lyrics from a theme prompt.
How long does generation take?
Typically 30–120 seconds per track. Instrumental-only tracks tend to generate faster.
Can I create instrumental-only tracks?
Yes — set the instrumental flag to true and Suno generates a vocal-free track.
What genres are supported?
Any genre — pop, jazz, lo-fi, classical, metal, hip-hop, electronic, and more. Describe the genre in your prompt.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.