ForHosting KIT · أدوات المطورين

أنصاف النغمات بين الترددات

تحوّل حاسبة أنصاف النغمات بين الترددات أي ترددين موجبين إلى المسافة الموسيقية ذات الإشارة بينهما وفق السلم المتساوي ذي الاثنتي عشرة درجة.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

أدخلوا الترددين بالترتيب المقصود

استخدموا frequency_1_hz للتردد المرجعي أو الابتدائي، وfrequency_2_hz للتردد المراد مقارنته به. يجب أن تكون القيمتان عددين موجبين محدودين بوحدة الهرتز. يؤثر الترتيب في النتيجة لأنها تحمل إشارة: إدخال 440 Hz ثم 880 Hz يعطي اثني عشر نصف نغمة موجبة، أما الترتيب المعاكس فيعطي اثني عشر نصف نغمة سالبة. القيم المتساوية تعطي صفراً والاتجاه unison. يمكن إدخال قيم عشرية مثل 439.7 Hz أو 261.625565 Hz. لا تُدخلوا أسماء النغمات أو الأطوال الموجية أو cents أو النسب في هذين الحقلين، بل حوّلوها إلى ترددات أولاً. تكرر الاستجابة المدخلين المقبولين لتسهيل حفظ الحساب مع القياسات الأصلية. يرفض التحقق الحقول الناقصة والصفر والقيم السالبة والسلاسل الرقمية واللانهاية والبيانات غير الرقمية، بدلاً من إظهار لوغاريتم غير معرّف على أنه نتيجة صالحة.

افهموا طريقة الحساب اللوغاريتمي

تقسم الحاسبة أولاً تردد النهاية على تردد البداية، ثم تأخذ اللوغاريتم للأساس اثنين للنسبة وتضربه في اثني عشر. يعكس ذلك بنية السلم المتساوي ذي الاثنتي عشرة درجة: مضاعفة التردد ترفع الطبقة أوكتافاً واحداً، وتساوي log2(2) واحداً، فيكون حاصل الضرب اثني عشر نصف نغمة. النسبة التي تساوي واحداً تعطي صفراً، والنسبة الأقل من واحد تعطي مسافة سالبة. بخلاف جدول أسماء النغمات، تعمل هذه الطريقة بصورة متصلة؛ فقد تعطي 7.01955 نصف نغمة لخماسية أوسع قليلاً، أو 0.23 لانحراف ضبط صغير. تُقرّب النسبة وعدد أنصاف النغمات إلى اثنتي عشرة منزلة عشرية للحفاظ على ثبات JSON مع دقة تفوق حاجة معظم القياسات العملية. ويوضح حقلا الصيغة ونظام الضبط الاتفاق المستخدم عند مشاركة النتيجة مع برامج قد تفترض cents أو الضبط الطبيعي أو نظاماً آخر.

فسّروا النتيجة ذات الإشارة واستخدموها

اقرؤوا semitones على أنه المسافة الموجّهة من التردد الأول إلى الثاني. تعني القيمة الموجبة أن الثاني أعلى، وتعني السالبة أنه أدنى، ويعني الصفر تطابقهما. يعرض الحقل direction العلاقة نفسها بالقيم up أو down أو unison كي لا تضطر الواجهة إلى استنتاجها من الإشارة. تحدد النتائج الصحيحة درجات السلم المتساوي بدقة: 12 أوكتاف، و7 خماسية، و1 نصف نغمة. أما الكسور فتفيد خصوصاً عند ضبط آلة أو مقارنة قمم طيفية أو تحديد مقدار تغيير الطبقة. للتحويل إلى cents، اضربوا قيمة أنصاف النغمات في 100. احتفظوا بدقة القياس الأصلية وتجنبوا تقريب الترددات قبل الحساب. تبلغ كلفة كل طلب API ناجح $0.002 لكل عنصر؛ وتنفذ نسخة المتصفح الحساب الحتمي نفسه محلياً من دون إرسال بيانات التردد إلى أي جهة خارجية.

حالات الاستخدام

قياس ضبط آلة موسيقية

قارنوا التردد الأساسي المقاس بالتردد المستهدف، وحددوا الانحراف ذا الإشارة بكسور نصف النغمة.

إعداد تغيير الطبقة

احسبوا عدد أنصاف النغمات اللازم لنقل صوت مسجل من تردد معروف إلى تردد آخر.

تحليل القمم الطيفية

حوّلوا نسبة قمتين تردديتين مكتشفتين إلى فاصل يسهل على الموسيقيين وأدوات الصوت فهمه.

الأسئلة الشائعة

ما الصيغة التي تستخدمها الحاسبة؟

تستخدم semitones = 12 × log2(frequency_2_hz / frequency_1_hz)، وهي العلاقة القياسية للسلم المتساوي ذي الاثنتي عشرة درجة.

لماذا قد تكون النتيجة سالبة؟

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

هل يمكن أن تتضمن النتيجة كسراً من نصف نغمة؟

نعم. نادراً ما تطابق نسب التردد العشوائية درجات السلم المتساوي تماماً، لذلك تكون القيم الكسرية طبيعية ومفيدة.

كيف تُحوّل النتيجة إلى cents؟

اضربوا semitones في 100. يساوي نصف النغمة الواحد في السلم المتساوي 100 cents.

ما المدخلات غير الصالحة؟

تُرفض القيم الناقصة والصفرية والسالبة واللانهائية وغير الرقمية والسلاسل. يجب أن يكون الترددان عددي JSON موجبين ومحدودين بالهرتز.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API ناجح $0.002 لكل عنصر. ويتاح الحساب الحتمي نفسه مجاناً في المتصفح.

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/optics/semitones-between-frequencies

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/optics/semitones-between-frequencies \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frequency_1_hz":440,"frequency_2_hz":880}'

const res = await fetch("https://api.kit.forhosting.com/optics/semitones-between-frequencies", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "frequency_1_hz": 440,
    "frequency_2_hz": 880
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/optics/semitones-between-frequencies",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "frequency_1_hz": 440,
    "frequency_2_hz": 880
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/optics/semitones-between-frequencies", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"frequency_1_hz":440,"frequency_2_hz":880}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"frequency_1_hz":440,"frequency_2_hz":880}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/optics/semitones-between-frequencies", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "frequency_1_hz": 440,
  "frequency_2_hz": 880
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "optics.semitones_between_frequencies",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←