Source: https://ailoot.ai/models/ar/suno-api/
Canonical: https://ailoot.ai/models/ar/suno-api/
Language: ar

# suno-api

[Markdown](https://ailoot.ai/models/ar/suno-api/index.md) · [JSON](https://ailoot.ai/models/ar/suno-api/facts.json)

## [suno-api](https://ailoot.ai/models/ar/suno-api/)

ينشئ Suno موسيقى من فكرة مكتوبة قصيرة. يُنتج مسار العمل التلقائي الموثّق أغنيتين، ويتضمن خيارًا للموسيقى الآلية، ويعيد الصوت المكتمل والبيانات الوصفية للمقاطع عبر مهمة التوليد.

- [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/ar/suno-api/#method-0)

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Suno خدمة لتوليد الموسيقى تحوّل فكرة مكتوبة إلى أغانٍ. يقبل مسار العمل التلقائي الموثّق وصفًا قصيرًا للموسيقى المقصودة واختيارًا للموسيقى الآلية، ثم يولّد أغنيتين. استخدم الوصف لتحديد الموضوع والأجواء والتوجه الموسيقي الذي تريد سماعه في المقاطع المكتملة.

ابدأ بالدور الذي ينبغي أن تؤديه الموسيقى. فخلفية هادئة لشرح، أو افتتاحية حيوية لفيديو قصير، أو أغنية تأملية عن رحلة، يمنح كل منها الوصف غرضًا ملموسًا. صِف الأجواء المقصودة والسمات الموسيقية المهمة لذلك الغرض في بضع عبارات واضحة.

في أغنية تتضمن غناءً، اجعل الموضوع واللغة واضحين في الموجز الإبداعي. صِف الفكرة التي ينبغي أن يعبّر عنها المقطع، والنبرة التي ينبغي أن ينقلها الأداء. استمع إلى النتيجة المكتملة لتقييم تكامل الغناء والكلمات والتوزيع الموسيقي. احتفظ بمعلومات المقطع الناتجة إلى جانب الصوت للمراجعة.

للحصول على موسيقى آلية، استخدم خيار الموسيقى الآلية الموثّق، وصِف التوجه الموسيقي في النص. حدّد الأجواء المطلوبة والآلات البارزة عندما تكون مهمة للمشروع. راجع المقطع المكتمل وفق الموضع الذي سيشغله في المونتاج، بما في ذلك الأجزاء التي ينبغي أن ترافق الكلام في الخلفية أو تدعم انتقالًا بصريًا.

يُنتج مسار العمل التلقائي أغنيتين من الفكرة المقدّمة. تعامل معهما بوصفهما خيارين مرشحين منفصلين، واحتفظ بكلا الملفين الصوتيين المكتملين. استمع إلى كل منهما من البداية، مرورًا بالتطور، وصولًا إلى النهاية. قارن المقاطع الفعلية بالغرض نفسه، بما يشمل أجواءها وتوزيعها الموسيقي وملاءمتها للاستخدام المخطّط له.

يُنظَّم التوليد على هيئة مهمة. احتفظ بمعرّف المهمة المُعاد أثناء التحقّق من نتيجتها، وميّز المقاطع المكتملة من العناصر التي لا تزال قيد التنفيذ. تتضمن النتيجة الموثّقة معلومات على مستوى المقطع، مثل العنوان والحالة وموقع الملف الصوتي والمدة. احفظ الصوت المكتمل نفسه مع البيانات الوصفية المتاحة والوصف الأصلي.

في فيديو أو عرض تقديمي، جرّب الموسيقى المختارة مع المادة الفعلية. تحقّق من البداية والانتقالات والنهاية عند مستوى الصوت المقصود. حدّد الجزء الذي يخدم المونتاج، واحتفظ بالمقطع كاملًا للتغييرات اللاحقة. يُقيَّم المقتطف الموسيقي المناسب في سياق الصوت والصور وإيقاع العمل المكتمل.

احتفظ بالفكرة المكتوبة، وخيار الموسيقى الآلية، واختيار النموذج، وجميع المقاطع المكتملة معًا. عندما يحتاج مقطع مرشح إلى مراجعة، حدّد وجه عدم التوافق الموسيقي، مثل توزيع موسيقي مزدحم أكثر من اللازم خلف الكلام أو مقدمة تتطور ببطء مفرط. حافظ على التوجه المفيد، وعدّل الجزء من الوصف المرتبط بتلك المشكلة.

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

[`suno-api`](https://ailoot.ai/models/ar/#m=suno-api&route=Ultra&caller=suno-api&fmt=music)

Suno /`suno-api`

### البداية

ينشئ Suno موسيقى من فكرة مكتوبة قصيرة. يُنتج مسار العمل التلقائي الموثّق أغنيتين، ويتضمن خيارًا للموسيقى الآلية، ويعيد الصوت المكتمل والبيانات الوصفية للمقاطع عبر مهمة التوليد.

المدخلات المقبولة

النص

النتائج

الصوت · الصور · فيديو

### متاح في 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 مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/)

### أمثلة للطلبات

#### Ailoot Ultra · Music

curl · أنشئ مرة واحدة واحتفظ بإيصال العمليةاقرأ المهمة الأصليةاحفظ كل أصل رقمي مكتمل تملكه

```bash
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.
```

```bash
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
```

```bash
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}`

##### الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

احتفظ بالاستجابة والترويسات كاملة، والمعرّفات الأصلية، وكل مخرج فعلي، وجميع حقول الاستخدام والمحاسبة. احفظ كل أصل فريد مملوك لك، واحتفظ بكل دور يشير إليه.

##### عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بالمعرّف العام المُعاد للمهمة أو العملية وبجميع الترويسات. اقرأ المهمة الأصلية فقط؛ فالحالة 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`](https://ailoot.ai/models/ar/#m=suno-api&route=Ultra&caller=suno-api&fmt=music)

#### الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

#### معرّفات النماذج ذات الصلة IDs

[`suno-api`](https://ailoot.ai/models/ar/#m=suno-api&route=Ultra&caller=suno-api&fmt=music)

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%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.