API الذكاء الاصطناعيAPI

الكتابة بالذكاء الاصطناعي، متاحة بالطريقة التي ستستدعيها بها فعلًا

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

POST /v1/ai/generate-caption
curl -X POST https://api.fopost.com/v1/ai/generate-caption \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "instructions": "Announce webhook retries with exponential backoff. Keep it direct.",
    "platforms": ["linkedin"]
  }'

نقطة نهاية REST واحدة

تأخذ generate-caption موجزًا والمنصات المستهدفة، وتُعيد نصًا جاهزًا.

ثلاث أدوات MCP

generate_caption وrewrite_for_platforms وrepurpose_url لأي عميل MCP.

قائم على الرصيد

كل طلب يُخصم من رصيد الذكاء الاصطناعي لمساحة العمل. اطّلع على الرصيد متى شئت.

REST

ولّد تعليقًا من مسار عملك الخاص

أرسل موجزًا قصيرًا والشبكة المستهدفة، واحصل على تعليق مكتوب ضمن حدود تلك الشبكة. يحتاج المفتاح إلى صلاحية ai. الاستجابة نص، ولا يُنشر شيء حتى تمرّره بنفسك إلى POST /v1/posts.

اقرأ مرجع الذكاء الاصطناعي
الاستجابة
{
  "caption": "Webhook retries are live. A failed delivery now retries with exponential backoff before it ever reaches your inbox as an error. Details in the changelog.",
  "credits": { "charged": 1, "remaining": 199 }
}

مُراعٍ للمنصة

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

لا نشر تلقائي أبدًا

تُعيد نقطة النهاية نصًا. والنشر طلب منفصل وصريح.

صلاحية ai

امنحها فقط للمفاتيح التي يجب أن تستهلك الرصيد.

MCP

أعد الصياغة وأعد التوظيف من عميل ذكاء اصطناعي

يتيح خادم MCP مجموعة الكتابة كاملة. تحوّل rewrite_for_platforms مسودة واحدة إلى سلسلة على X وفقرة على LinkedIn. وتقرأ repurpose_url صفحة وتقترح سلسلة منشورات. وكلتاهما تسلّم ناتجها إلى schedule_post في الجلسة نفسها، ويطلب العميل الإذن قبل نشر أي شيء.

أعدّ خادم MCP
الطلب
> Take our latest changelog at https://yourbrand.com/changelog
  and turn it into three posts for LinkedIn and X this week.

Agent: I'll call repurpose_url, then rewrite_for_platforms for each,
then schedule_post for Tue, Wed, and Thu at 9am. Proceed? (y/n)

rewrite_for_platforms

مسودة واحدة تدخل، ونسخة لكل شبكة تخرج، كلٌّ ضمن حدودها.

repurpose_url

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

مباشرة إلى الجدولة

يربط الوكيل أدوات الكتابة بـ schedule_post دون مغادرة المحادثة.

الرصيد

الإنفاق واضح ومحدود ولكل مساحة عمل

يُحتسب كل طلب ذكاء اصطناعي من رصيد الاستخدام الشهري المجاني المُضمَّن مع كل حساب. اقرأ الرصيد عبر MCP بالأداة get_ai_credits، وفي لوحة التحكم ضمن AI Usage. وحين ينفد الرصيد، يُعيد الطلب 402 مع رابط للترقية بدلًا من أن يفشل بصمت.

ابدأ البناء
الوكيل يكتب مسودات منشورات لعدة شبكات بصوت علامة تجارية محفوظ

get_ai_credits

اسأل الوكيل عن الرصيد المتبقي قبل دفعة كبيرة.

خطأ 402 واضح

نفاد الرصيد خطأ صريح، وليس منشورًا مكتوبًا إلى نصفه أبدًا.

محصور في مساحة العمل

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

أسئلة حول API الذكاء الاصطناعي، مع إجاباتها

ما ميزات الذكاء الاصطناعي المتاحة عبر REST API؟

نقطة نهاية واحدة: POST /v1/ai/generate-caption، بصلاحية ai. أما إعادة الصياغة لكل شبكة واقتراح الهاشتاغات وإعادة توظيف الروابط فمتاحة اليوم كأدوات MCP وداخل الوكيل في التطبيق، لا كنقاط نهاية REST عامة.

ما النموذج الذي تستخدمه؟

لا يكشف FoPost عن المزوّد أو النموذج. تختار أنت ميزة ونبرة، وتختار الخدمة ما يشغّلها ويمكنها تغييره دون أي تغيير من جهتك.

هل سينشر من تلقاء نفسه؟

لا. كل نقطة نهاية وأداة للذكاء الاصطناعي تُعيد نصًا. النشر طلب منفصل، وتعرض عملاء MCP طلب schedule_post للموافقة قبل تنفيذه.

كيف يُحتسب الرصيد؟

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

هل يعرف صوت علامتي التجارية؟

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

ما الصلاحية التي يحتاجها المفتاح؟

صلاحية ai. المفتاح الذي لا يحملها يحصل على 403 من نقطة النهاية هذه، بينما يواصل العمل لأي صلاحيات أخرى يحملها.

ابنِ على API الذكاء الاصطناعي اليوم

البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.

احصل على مفتاح API