وثائق API

ادمج خدمات تحويل الكتب الإلكترونية من E-Ink في تطبيقاتك

استخدم مع وكلاء الذكاء الاصطناعي — بدون إعداد

انسخ الأمر أدناه والصقه في Cursor أو Claude Code أو Codex أو أي وكيل ذكاء اصطناعي للتثبيت تلقائيًا.

ثبّت مهارة E-Ink: شغّل npx e-ink-skill، ثم اضبط متغير البيئة EINK_API_KEY على مفتاح API الخاص بي.

متوافق مع Cursor وClaude Code وWindsurf وCodex والمزيد.

طرق تثبيت أخرى

البدء

لاستخدام API الخاص بـ E-Ink، تحتاج إلى مفتاح API. أنشئ واحدًا من لوحة التحكم ثم أضفه في رأس Authorization لطلباتك.

المصادقة

يجب أن تتضمن جميع طلبات API مفتاح API في رأس Authorization:

Authorization: Bearer eink_your_api_key_here

Base URL

https://e-ink.me/api/v1

نظام الرصيد

تستهلك استدعاءات API رصيدًا من حسابك، مثل واجهة الويب.

APIتكلفة الرصيد
صفحة ويب إلى كتاب إلكتروني3(لكل رابط)
تحويل تنسيق الملفات2 / 5(PDF OCR: 5)
ترجمة الكتب الإلكترونية3(لكل ملف)
تحويل النص إلى كلام5(لكل ملف)
إنشاء خريطة ذهنية2 / 5(AI: 5)

نقاط نهاية API

GET/api/v1/credits

التحقق من رصيد النقاط

يُرجع رصيد النقاط الحالي.

0 credits
curl
curl https://e-ink.me/api/v1/credits \
  -H "Authorization: Bearer eink_your_api_key"
Response
{
  "credits": 150
}
POST/api/v1/convert/webpage

صفحة ويب إلى كتاب إلكتروني

تحويل صفحة ويب واحدة أو أكثر إلى تنسيق EPUB أو PDF أو Markdown.

3 credits لكل رابط
curl
curl -X POST https://e-ink.me/api/v1/convert/webpage \
  -H "Authorization: Bearer eink_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://e-ink.me", "format": "epub"}' \
  -o article.epub
POST/api/v1/convert

تحويل تنسيق الملفات

تحويل الملفات بين EPUB وPDF وMarkdown وHTML وDOCX وTXT والمزيد.

2 / 5 credits
curl
curl -X POST https://e-ink.me/api/v1/convert \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "converter=epub-to-pdf" \
  -o book.pdf
POST/api/v1/convert/translate

ترجمة الكتب الإلكترونية

ترجمة ملف EPUB إلى لغة أخرى.

3 credits لكل ملف
curl
curl -X POST https://e-ink.me/api/v1/convert/translate \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "targetLanguage=Chinese" \
  -F "sourceLanguage=auto" \
  -o book-translated.epub
POST/api/v1/convert/tts

تحويل النص إلى كلام

تحويل النص إلى صوت (تنسيق MP3).

5 credits لكل ملف
curl
curl -X POST https://e-ink.me/api/v1/convert/tts \
  -H "Authorization: Bearer eink_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello, this is a test.", "voice": "en-US-JennyNeural"}' \
  -o speech.mp3
POST/api/v1/convert/mindmap

إنشاء خريطة ذهنية

إنشاء خريطة ذهنية من ملف EPUB أو PDF.

2 / 5 credits
curl
curl -X POST https://e-ink.me/api/v1/convert/mindmap \
  -H "Authorization: Bearer eink_your_api_key" \
  -F "file=@book.epub" \
  -F "mode=structure" \
  -F "format=freemind"
Response
{
  "tree": { "label": "Book Title", "children": [...] },
  "stats": { "nodeCount": 42, "maxDepth": 4 },
  "files": {
    "freemind": "<map>...</map>",
    "opml": "<?xml ...?>...",
    "markdown": "# Book Title\n## Chapter 1\n..."
  }
}

رموز الخطأ

CodeDescription
400Bad Request — معاملات غير صالحة
401Unauthorized — مفتاح API مفقود أو غير صالح
402Payment Required — رصيد غير كافٍ
413Payload Too Large — الملف يتجاوز حد الحجم
500Internal Server Error — حدث خطأ في الخادم

AI Agent Skill

استخدم E-Ink مباشرة في Cursor وClaude Code وCodex وأدوات البرمجة الأخرى بالذكاء الاصطناعي.

التثبيت

1

أخبر وكيل الذكاء الاصطناعي

موصى به

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

ثبّت مهارة E-Ink: شغّل npx e-ink-skill، ثم اضبط متغير البيئة EINK_API_KEY على مفتاح API الخاص بي.
2

تشغيل npx يدويًا

npx
npx e-ink-skill
3

استنساخ من GitHub

git clone
# Cursor
git clone https://github.com/Selenium39/e-ink-skill.git ~/.cursor/skills/e-ink-skill

# Claude Code / Codex
git clone https://github.com/Selenium39/e-ink-skill.git ~/.claude/skills/e-ink-skill

تعيين مفتاح API كمتغير بيئة:

export EINK_API_KEY="eink_your_api_key_here"

المهارة متاحة الآن في وكيل الذكاء الاصطناعي. جرب أن تسأل:

“حوّل https://e-ink.me إلى EPUB”
“ترجم هذا الـ EPUB إلى العربية”
“تحقق من رصيد نقاط E-Ink”
عرض على GitHub