تحويل PDF إلى تدرج رمادي صفحة بصفحة
حوّلوا ملف PDF إلى التدرج الرمادي في مرحلة بيانات الصفحات الوصفية بعملية صغيرة وحتمية.
شغّل الأداة مجانًا
أدخلوا وضع اللون الحالي لكل صفحة وفق ترتيب المستند، فتحصلون على قائمة من الطول نفسه تكون فيها كل صفحة مضبوطة على grayscale. تعرض النتيجة أيضاً العدد الإجمالي للصفحات والعدد الدقيق للأوضاع التي تغيرت، وبذلك يمكن التمييز بين التحويل الكامل والمستند الذي كان مجهزاً مسبقاً. يُرفض المستند الخالي برسالة واضحة عن خطأ الإدخال.
طريقة الاستخدام
أدخل القيم في النموذج أعلاه. تتحقق الأداة منها قبل الحساب ثم تعرض النتيجة في الصفحة نفسها.
راجع بياناتك
اتبع التسميات والوحدات الموضحة بجانب كل حقل. إذا كانت قيمة مفقودة أو خارج النطاق، توضح الصفحة الحقل الذي يحتاج إلى تصحيح.
أعد الحساب أو نفّذه آليًا
استخدم أداة الويب للفحوص الفردية، واستخدم الواجهة البرمجية عند دمج الإمكانية نفسها في سير عمل آلي.
حالات الاستخدام
احصل على النتيجة الآن
أدخل مجموعة من القيم وشاهد النتيجة من دون إعداد جدول بيانات أو برنامج نصي.
قارن السيناريوهات
غيّر قيمة واحدة في كل مرة وأعد الحساب لمعرفة ما الذي يؤثر في النتيجة.
أتمت العمل المتكرر
استخدم الواجهة البرمجية عندما تحتاج إلى تشغيل الحساب نفسه داخل منتجك أو سير عملك.
الأسئلة الشائعة
هل تعيد هذه الإمكانية ملف PDF محولاً؟
لا. إنها توحّد أوصاف وضع اللون المقدمة، وعلى مصيّر PDF لاحق تطبيق الوضع المطلوب على وحدات البكسل والموارد.
ما الذي يحسبه pages_changed؟
يحسب كل صفحة صحيحة لم تكن قيمتها grayscale بعد إزالة المسافات وإهمال الفرق بين الأحرف الكبيرة والصغيرة.
ماذا يحدث إذا كانت كل الصفحات بالتدرج الرمادي مسبقاً؟
ينجح الطلب، وتبقى جميع الصفحات المعادة على grayscale، وتكون قيمة pages_changed صفراً.
هل يمكن إرسال مصفوفة pages فارغة؟
لا. يجب أن يحتوي وصف PDF على وضع صفحة واحد على الأقل، ويعيد الإدخال الفارغ أو المفقود الخطأ invalid_input.
هل يتغير ترتيب الصفحات؟
لا. تحافظ مصفوفة pages المعادة على طول الإدخال وترتيبه تماماً.
كم تبلغ كلفة الطلب الآلي؟
السعر المنشور هو $0.002 لكل طلب، من دون رسم إضافي لكل صفحة.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/pdf/grayscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pages":["color","grayscale","cmyk"]}'const res = await fetch("https://api.kit.forhosting.com/pdf/grayscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pages": [
"color",
"grayscale",
"cmyk"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/grayscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pages": [
"color",
"grayscale",
"cmyk"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/grayscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pages":["color","grayscale","cmyk"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pages":["color","grayscale","cmyk"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/grayscale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"pages": [
"color",
"grayscale",
"cmyk"
]
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.grayscale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_mb | 25 |
max_pages | 200 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |