Picasso AI API: أسعار API للصور والفيديو، والمفتاح، والتوثيق

إذا بحثت عن Picasso AI API، فمن المرجح أنك تريد ثلاث إجابات قبل كتابة أي كود: كم تكلّف، وكيف تُجري المصادقة، وما الذي تتيحه الوثائق لاستدعائه. الخلاصة المختصرة: يشغّل PicassoIA واجهة REST API على نمط Replicate على العنوان https://api.picassoia.com/v1، ويجري المصادقة باستخدام توكن حامل الذي يبدأ بالنص pia_sk_، ويعرض أربعة نماذج للصور والفيديو، وتذكر وثائقه أن تنبؤات API مجانية حاليًا. الشرط هو متطلب الخطة، ويستحق القراءة قبل أن تبني أي شيء فوقه. يتبع هذا المقال الترتيب الذي ستصادف به الأمور عمليًا: التسعير، وإعداد بيانات الاعتماد، وطلبك الأول، والحدود، والفيديو، وموصل MCP الذي يشارك النماذج الأربعة نفسها.

ما الذي تقدّمه PicassoIA API

تصف صفحة PicassoIA API واجهة صغيرة ومركّزة. ترسل طلبًا لإنشاء تنبؤ، فتعمل المهمة على وحدات GPU الخاصة بمنصة PicassoIA، ثم تستعلم بشكل متكرر حتى تصبح النتيجة جاهزة. لا توجد حزم SDK لتثبيتها، وتستخدم أمثلة الكود في الوثائق بروتوكول HTTP البسيط في cURL و Python و Node.

عنوان الأساس والمصادقة

يذهب كل استدعاء إلى عنوان أساس واحد، ويحمل ترويسة واحدة:

Base URL:      https://api.picassoia.com/v1
Header:        Authorization: Bearer pia_sk_...
Content-Type:  application/json

نسخ الأمر النصي

تشير البادئة pia_sk_ إلى توكن سري. تعامل معه كما تعامل كلمة المرور، لأن من يحتفظ به يستطيع استهلاك سعة خطتك.

النماذج الأربعة

يضم كتالوج الويب أكثر من 250 نموذجًا للصور والفيديو والدردشة. تعرض API أربعة منها:

💡 يستحق المعرفة: يقدّم مرجع API أيضًا GET /v1/models، الذي يُرجع كل نموذج مع مخطط مدخلاته. اقرأه مرة واحدة بدلًا من تخمين أسماء المعاملات من الأمثلة.

نقاط النهاية في لمحة

لمن تناسب هذه API

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

تسعير API ومتطلبات الخطة

تنبؤات مجانية، مع شرط

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

الشرط يكمن في الخطة. وفقًا لمرجع API، تتطلّب خطة Infinite لإنشاء التنبؤات. الاطلاع على التنبؤات وسردها وإلغاؤها يعمل دون ذلك، لذا يمكنك اختبار التوكن وكود العميل على مستوى أدنى، لكن أول POST ينشئ مهمة يحتاج إلى Infinite.

قراءة صفحة الأسعار

تضيف صفحة الأسعار إشارة ثانية. فهي تدرج وصول API واتصالات MCP ضمن ميزات الباقات المدفوعة (Pro+ و Elite و Infinite)، وعلى كل منها شارة "New"، لكنها لا تذكر شيئًا عما إذا كانت استدعاءات API تستهلك النقاط. لذلك لديك عبارتان لا تتطابقان تمامًا:

💡 قاعدة عملية: اعتبر صفحة API المرجع الفاصل لإنشاء التنبؤات، ثم تحقق من حسابك الخاص قبل أن تعد عميلًا بأي شيء. تتغير أسعار الخطط، لذا اقرأ سعر Infinite الحالي في صفحة الأسعار بدلًا من الوثوق برقم منسوخ في مقال.

بما أن كلمة "حاليًا" موجودة في التوثيق، فابنِ تكاملك بحيث يمكن إضافة تكلفة لاحقًا: سجّل معرّف كل تنبؤ والنموذج وحجم المخرجات منذ اليوم الأول. إن وصل الفوترة يومًا ما، فستكون بيانات الاستخدام لديك جاهزة.

أنشئ بيانات الاعتماد وحمِها

أنشئ توكنًا في حسابك

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

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

أبقِه خارج الكود

ضع التوكن في متغير بيئة واقرأه أثناء التشغيل. تستخدم الأمثلة أدناه PICASSOIA_API_TOKEN، وهو اسم اختير لهذا المقال، وليس اسمًا تشترطه المنصة.

• من جهة الخادم فقط. لا تضع التوكن أبدًا في JavaScript الخاص بالمتصفح أو في تطبيق للجوال. يستطيع أي شخص قراءته من تبويب الشبكة.
• دوّر التوكن عبر الفتحة الثانية. أنشئ التوكن الثاني، ونشّره، وتحقق من عمل حركة المرور، ثم ألغِ التوكن الأول. فلن تحدث فجوة أبدًا.
• لا ترفعه إلى المستودع أبدًا. أضف .env إلى ملف التجاهل الخاص بك، وافحص الإيداعات القديمة (commits) إن أخطأت مرة.
• استخدم توكنًا لكل بيئة كلما أمكن: الإنتاج على فتحة، وبيئة الاختبار المرحلي على الأخرى.

أول طلب لك، خطوة بخطوة

💡 قبل أن تنسخ أي شيء: تتبع API نمط Replicate، لذا تستخدم الأمثلة أسماء الحقول التي يقتضيها هذا النمط (id، status، output). اطبع أول استجابة تتلقاها مرة واحدة وتحقق من تلك الأسماء قبل أن تربط هذا بنظام الإنتاج.

أرسل التنبؤ

export PICASSOIA_API_TOKEN="pia_sk_your_token_here"

curl -X POST https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions \
  -H "Authorization: Bearer $PICASSOIA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a lighthouse at sunset", "aspect_ratio": "16:9"}}'

نسخ الأمر النصي

يعود الاستدعاء بسرعة مع كائن تنبؤ. الصورة ليست موجودة بعد: فالمهمة في الطابور وتعمل بشكل غير متزامن.

استعلم حتى الانتهاء

curl https://api.picassoia.com/v1/predictions/PREDICTION_ID \
  -H "Authorization: Bearer $PICASSOIA_API_TOKEN"

نسخ الأمر النصي

كرر الاستعلام كل بضع ثوانٍ حتى تصبح الحالة succeeded أو failed. الفشل نهائي، لذا أعد الإرسال بتنبؤ جديد بدلًا من الانتظار. وعند النجاح تحتوي المخرجات على روابط الصور. احفظ الملفات التي تهمك في تخزينك الخاص بدل الاعتماد المباشر على روابط النتائج.

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

نسخة Python ونسخة Node

import os, time, requests

BASE = "https://api.picassoia.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['PICASSOIA_API_TOKEN']}"}

def generate(prompt):
    r = requests.post(
        f"{BASE}/models/picassoia/picassoia-image/predictions",
        json={"input": {"prompt": prompt, "aspect_ratio": "16:9"}},
        headers=HEADERS,
        timeout=30,
    )
    r.raise_for_status()
    prediction = r.json()

    while prediction["status"] not in ("succeeded", "failed", "canceled"):
        time.sleep(3)
        prediction = requests.get(
            f"{BASE}/predictions/{prediction['id']}", headers=HEADERS, timeout=30
        ).json()
    return prediction

نسخ الأمر النصي

const BASE = "https://api.picassoia.com/v1";
const headers = {
  Authorization: `Bearer ${process.env.PICASSOIA_API_TOKEN}`,
  "Content-Type": "application/json",
};

export async function generate(prompt) {
  const res = await fetch(`${BASE}/models/picassoia/picassoia-image/predictions`, {
    method: "POST",
    headers,
    body: JSON.stringify({ input: { prompt, aspect_ratio: "16:9" } }),
  });
  let prediction = await res.json();

  while (!["succeeded", "failed", "canceled"].includes(prediction.status)) {
    await new Promise((r) => setTimeout(r, 3000));
    prediction = await (await fetch(`${BASE}/predictions/${prediction.id}`, { headers })).json();
  }
  return prediction;
}

نسخ الأمر النصي

حدود تشكّل تصميمك

خمسة تنبؤات في وقت واحد

السقف لكل حساب، وليس لكل توكن. إذا عملت مهمة مجدولة وتطبيق ويب وجلسة MCP معًا، فإنها تستهلك من الفتحات الخمس نفسها. ضع أداة تحديد للمعدل أمام العميل، مثل semaphore أو مجموعة عمال من خمسة، واحفظ الباقي في طابور من عندك.

يسهل تقدير الإنتاجية. إذا استغرق تنبؤ صورة واحد N ثانية من الإرسال حتى succeeded، فإن الفتحات الخمس تعطيك تقريبًا 5 / N صورة في الثانية، ودفعة من 500 صورة تستغرق نحو 500 × N / 5 ثانية. قِس N خلال أول عشرة استدعاءات، ثم حدّد حجم الدفعات الليلية بناءً على هذا الرقم بدل التخمين. مهام الفيديو أطول، لذا شغّلها في طابور خاص بها، واحتفظ بفتحة أو اثنتين حرتين للصور.

ثلاثة أخطاء تتكرر كثيرًا:

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

حدود الحجم والأمر النصي

يمكن أن يصل الأمر النصي إلى 4,000 حرف، وهي مساحة واسعة للأوامر الطويلة المفصّلة التي تحتاجها الأعمال الواقعية كالصور الفوتوغرافية. القيد الأضيق هو مدخلات الصور. فكل صورة Data URL يمكن أن تبلغ 5 ميغابايت، لكن جسم الطلب كله يتوقف عند 10 ميغابايت، لذا لن تتسع أربع صور قريبة من الحد الأقصى في استدعاء تعديل واحد. صغّر العرض إلى حجم معقول وضغطها بصيغة JPEG قبل ترميزها.

الفيديو عبر API

إعدادات PicassoIA Video

يقبل PicassoIA Video نصًا أو صورة ويعيد ملف MP4 واحدًا. تربط المرجعية الحد الأقصى للمدة بالدقة:

اختر أدنى دقة تفي بالمطلوب. مسودة بدقة 480p تمنحك أربعة أضعاف مدة عرض 1080p، وهذا مناسب للمقاطع المتكررة لوسائل التواصل والقصص المصورة. مهام الفيديو تستغرق وقتًا أطول من مهام الصور، لذا استعلم كل 8 إلى 10 ثوانٍ، لا كل 3.

Seedance 2.5 Lite مع الصوت

يضيف Seedance 2.5 Lite صوتًا متزامنًا إلى المقطع، ما يوفّر خطوة صوت منفصلة. يسرد مرجع API مدد 5 و10 و15 ثانية، بينما يصف كتالوج الويب مقاطع تصل إلى 10 ثوانٍ، لذا اقرأ المخطط من GET /v1/models قبل أن تكتب قيمة مسموحًا بها ثابتة في الكود. أما Seedance 2.5 الأكبر فيبقى في كتالوج المتصفح ولا يدخل ضمن API.

نماذج MCP والدردشة إلى جانب API

يمنح موصّل MCP مساعدي الذكاء الاصطناعي النماذج الأربعة نفسها دون أي كود HTTP. يعرض موصّل claude.ai أدوات لتوليد الصور وتعديلها، وإنشاء الفيديو بأي من نموذجي الفيديو، وإدارة المهام: generate_image، edit_image، generate_video_picassoia، generate_video_seedance، get_generation، list_generations، list_models، get_account وcancel_generation.

يحاكي التدفق نظيره في REST. تعيد أداة التوليد معرّف التنبؤ ووقتًا تقديريًا بمجرد أن تقبل وحدة GPU المهمة. ثم تستدعي get_generation بعد التأخير المقترح، وتكرر ذلك بعد كل تأخير يعيده، حتى تصبح الحالة succeeded أو failed. cancel_generation يوقف مهمة لم تبدأ التصيير بعد. والحد المتزامن هو الخمس المشتركة نفسها.

نماذج الدردشة مسألة منفصلة. لا يكتب أي نموذج من نماذج API الأربعة نصوصًا، لذا تعيش النماذج اللغوية الكبيرة في المتصفح: Claude Sonnet 5 لصياغة النصوص الطويلة، و GPT 5.6 Sol لمشكلات البرمجة الصعبة، و Gemini 3.5 Flash عندما تكون السرعة مهمة. سير عمل جيد هو صياغة الأمر النصي وتحسينه باستخدام أحدها، ثم لصق النتيجة في استدعاء API الخاص بك. وتوجد نماذج مثل GPT Image 2 و Flux 2 Pro و Veo 3.1 و Kling v3 Video في كتالوج المتصفح فقط أيضًا.

كيفية استخدام PicassoIA Image على PicassoIA

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

1. افتح صفحة PicassoIA Image وسجّل الدخول.
2. اكتب الأمر النصي بهذا الترتيب: الشخص والفعل، ثم المكان، والإضاءة، والكاميرا والعدسة، وتفاصيل الملمس.
3. اختر نسبة العرض إلى الارتفاع. تناسب 16:9 اللافتات وترويسات المدونة، وتناسب 1:1 بطاقات المنتجات. تقبل API الحقل نفسه aspect_ratio.
4. اضبط عدد الصور على 1 أو 2، وهو ما يطابق نطاق API.
5. أنشئ الصورة، ثم راجع النتيجة بالحجم الكامل، وانظر إلى الأيدي والحواف وأي نص عشوائي.
6. أرسل أفضل صورة إلى PicassoIA Image Editor Pro لتصحيح تفصيلة، أو دمجها مع ما يصل إلى ثلاث صور إضافية.

هل أنت مستعد لتجربته بنفسك؟ افتح PicassoIA Image، واكتب الأمر النصي الذي كنت سترسله في أول استدعاء API لك، وشاهد عملية التصيير. عندما تبدو النتيجة صحيحة، انسخ الأمر النصي نفسه إلى مثال cURL أعلاه، ودع كودك يتولى الباقي. وإن أردت تصفّح كل ما تستطيع المنصة فعله، فإن كتالوج النماذج الكامل على بعد نقرة واحدة.