Seedance 2.5 وصل الآن · Nano Banana 2 وGPT Image 2.5 غير محدودة حتى ١٥ نوفمبرترقية
  • شعار Picasso IALogo Picasso IA
  • الرئيسية
  • صورة
  • فيديو
  • موسيقى
  • صوت
  • دردشة
  • ثلاثي الأبعاد
  • مؤثر بالذكاء الاصطناعيNEW
  • AI ToolkitNEW
  • SupercomputerNEW
  • APINEW
  • MCPNEW
  • التوليدات
  • الفواتير
  • الدعم
  • الحساب
انتقل إلى المحتوى
  • استكشاف
  • صورة
  • فيديو
  • دردشة
  • غير محدودة
  • تحرير الفيديو
  • مزامنة الشفاه
  • تحسين
  • موسيقى
  • صوت
  • تفريغ صوتي
  • ثلاثي الأبعاد
  • ترقية الدقة
  • إزالة الخلفية
ابدأ مجانًاابدأ مجانًا الآنجديدإنشاءابدأ الإنشاءالأسعارالأسعار80% OFF
Crea GratisStart Freeابدأ مجانًاCrie GrátisEssai Gratuitमुफ़्त शुरूEmpieza Gratis YaStart Free Nowابدأ مجانًا الآنComece Grátis JáCommencer Gratuitementअभी मुफ़्त शुरू करेंNuevoNewجديدNovoNouveauनयाCrearCreateإنشاءCriarCréerबनाएंEmpieza a CrearStart Creatingابدأ الإنشاءComece a CriarCommencer à Créerबनाना शुरू करेंPreciosPricingالأسعارPreçosTarifsमूल्यPreciosPricingالأسعارPreçosTarifsमूल्य80% OFF
  • ExplorarExploreاستكشافExplorarExplorerएक्सप्लोर
  • Inicio RápidoQuickstartالبدء السريعInício RápidoDémarrage Rapideत्वरित शुरुआत
  • DocumentaciónDocsالوثائقDocumentaçãoDocumentationडॉक्स
  • PreciosPricingالأسعارPreçosTarifsकीमत
  • Claves de APIAPI Keysمفاتيح APIChaves de APIClés APIAPI कुंजियाँ
  • MCPMCPخادم MCPMCPMCPMCP
Documentación de la APIAPI Docsوثائق APIDocumentação da APIDocumentation APIAPI डॉक्स
Crear una predicciónCreating a predictionإنشاء تنبؤCriar uma previsãoCréer une prédictionप्रेडिक्शन बनाना
Documentación de la APIAPI Docsوثائق APIDocumentação da APIDocumentation APIAPI डॉक्स
  • IntroducciónOverviewنظرة عامةVisão GeralVue d'Ensembleओवरव्यू
  • Inicio RápidoQuickstartالبدء السريعInício RápidoDémarrage Rapideत्वरित शुरुआत
  • AutenticaciónAuthenticationالمصادقةAutenticaçãoAuthentificationप्रमाणीकरण
  • ModelosModelsالنماذجModelosModèlesमॉडल
  • PrediccionesPredictionsالتنبؤاتPrevisõesPrédictionsप्रेडिक्शन
  • Crear una predicciónCreating a predictionإنشاء تنبؤCriar uma previsãoCréer une prédictionप्रेडिक्शन बनाना
  • Listar prediccionesListing predictionsسرد التنبؤاتListar previsõesLister les prédictionsप्रेडिक्शन की सूची
  • El objeto de predicciónThe prediction objectكائن التنبؤO objeto de previsãoL’objet prédictionप्रेडिक्शन ऑब्जेक्ट
  • Sondeo y ETAPolling and ETAالاستعلام الدوري وتقدير الوقت (ETA)Consulta periódica e ETAInterrogation périodique et ETAपोलिंग और ETA
  • CancelaciónCancelingالإلغاءCancelamentoAnnulationरद्द करना
  • Errores y LímitesErrors and Limitsالأخطاء والحدودErros e LimitesErreurs et Limitesत्रुटियाँ और सीमाएँ
API de PicassoIAPicassoIA APIواجهة PicassoIA APIPicassoIA APIAPI PicassoIAPicassoIA API
PrediccionesPredictionsالتنبؤاتPrevisõesPrédictionsप्रेडिक्शन
Copiar PáginaCopy Pageنسخ الصفحةCopiar PáginaCopier la Pageपेज कॉपी करें
Una predicción es una ejecución de un modelo: la creas, la consultas y lees su salida.A prediction is one run of a model: you create it, poll it and read its output.التنبؤ هو تشغيل واحد لنموذج: تُنشئه، وتستعلم عنه دوريًا، وتقرأ مخرجاته.Uma previsão é uma execução de um modelo: você a cria, a consulta e lê a saída dela.Une prédiction est une exécution d'un modèle : vous la créez, vous l'interrogez et vous lisez sa sortie.प्रेडिक्शन किसी मॉडल का एक रन है: आप उसे बनाते हैं, पोल करते हैं और उसका आउटपुट पढ़ते हैं।

Crear una predicción

POST /v1/models/{owner}/{name}/predictions con el cuerpo { "input": { … } }.

  • La API responde en cuanto el modelo acepta el trabajo, normalmente en pocos segundos, con la predicción en el estado starting. Nunca espera al resultado.
  • Si la predicción falla de inmediato, la respuesta sigue siendo 201, con la predicción en el estado failed y su error. Esto ocurre, por ejemplo, cuando el filtro de seguridad rechaza la entrada.
  • Si no se ha creado ninguna predicción, la respuesta es un error: entrada no válida, plan insuficiente, demasiadas predicciones en curso, servicio no disponible.

Listar predicciones

GET /v1/predictions devuelve tus predicciones de la API, 50 por página, de la más reciente a la más antigua, incluidas las de todas tus API keys.

  • next es la URL de la página siguiente (…/v1/predictions?cursor=…), o null en la última página.
  • previous siempre es null.
  • Las predicciones que hayas eliminado en picassoia.com no aparecen.

Una predicción es visible desde cualquiera de tus API keys, y nunca para nadie más.

El objeto de predicción

Creating a prediction

POST /v1/models/{owner}/{name}/predictions with the body { "input": { … } }.

  • The API answers once the model has accepted the job, usually within seconds, with the prediction in the starting state. It never waits for the result.
  • If the prediction fails right away, the answer is still 201, with the prediction in the failed state and its error. This happens, for example, when the input is refused by the safety filter.
  • If no prediction was created, the answer is an error: invalid input, plan, too many predictions in progress, service unavailable.

Listing predictions

GET /v1/predictions returns your API predictions, 50 per page, newest first, across all your keys.

  • next is the URL of the next page (…/v1/predictions?cursor=…), or null on the last page.
  • previous is always null.
  • Predictions you deleted on picassoia.com are left out.

A prediction is visible through any of your keys, and never to anyone else.

The prediction object

إنشاء تنبؤ

أرسل POST /v1/models/{owner}/{name}/predictions مع جسم الطلب { "input": { … } }.

  • تستجيب الواجهة بمجرد أن يقبل النموذج المهمة، عادةً في غضون ثوانٍ، بتنبؤ في الحالة starting. ولا تنتظر النتيجة أبدًا.
  • إذا فشل التنبؤ على الفور، تظل الاستجابة 201، مع تنبؤ في الحالة failed وحقل error الخاص به. يحدث هذا مثلًا عندما يرفض مرشّح الأمان المدخلات.
  • إذا لم يُنشأ أي تنبؤ، تكون الاستجابة خطأً: مدخلات غير صالحة، أو خطة غير مؤهلة، أو كثرة التنبؤات قيد التنفيذ، أو عدم توفر الخدمة.

سرد التنبؤات

يُرجع GET /v1/predictions تنبؤات API الخاصة بك، بواقع 50 تنبؤًا في كل صفحة، الأحدث أولًا، عبر جميع مفاتيحك.

  • الحقل next هو عنوان URL للصفحة التالية (…/v1/predictions?cursor=…)، أو null في الصفحة الأخيرة.
  • الحقل previous قيمته null دائمًا.
  • لا تُدرج التنبؤات التي حذفتها على picassoia.com.

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

كائن التنبؤ

Criar uma previsão

POST /v1/models/{owner}/{name}/predictions com o corpo { "input": { … } }.

  • A API responde assim que o modelo aceita o trabalho, geralmente em poucos segundos, com a previsão no estado starting. Ela nunca espera pelo resultado.
  • Se a previsão falhar imediatamente, a resposta continua sendo 201, com a previsão no estado failed e o seu error. Isso acontece, por exemplo, quando a entrada é recusada pelo filtro de segurança.
  • Se nenhuma previsão tiver sido criada, a resposta é um erro: entrada inválida, plano, previsões demais em andamento, serviço indisponível.

Listar previsões

GET /v1/predictions retorna as suas previsões da API, 50 por página, das mais recentes para as mais antigas, considerando todas as suas chaves.

  • next é a URL da próxima página (…/v1/predictions?cursor=…), ou null na última página.
  • previous é sempre null.
  • As previsões que você excluiu em picassoia.com não são incluídas.

Uma previsão fica visível por meio de qualquer uma das suas chaves, e nunca para outras pessoas.

O objeto de previsão

Créer une prédiction

POST /v1/models/{owner}/{name}/predictions avec le corps { "input": { … } }.

  • L’API répond dès que le modèle a accepté la tâche, généralement en quelques secondes, avec la prédiction à l’état starting. Elle n’attend jamais le résultat.
  • Si la prédiction échoue immédiatement, la réponse reste 201, avec la prédiction à l’état failed et son error. C’est le cas, par exemple, lorsque l’entrée est refusée par le filtre de sécurité.
  • Si aucune prédiction n’a été créée, la réponse est une erreur : entrée non valide, forfait, trop de prédictions en cours, service indisponible.

Lister les prédictions

GET /v1/predictions renvoie vos prédictions effectuées via l’API, 50 par page, de la plus récente à la plus ancienne, toutes clés confondues.

  • next est l’URL de la page suivante (…/v1/predictions?cursor=…), ou null sur la dernière page.
  • previous vaut toujours null.
  • Les prédictions que vous avez supprimées sur picassoia.com sont exclues.

Une prédiction est accessible avec n’importe laquelle de vos clés, et n’est jamais visible par quelqu’un d’autre.

L’objet prédiction

प्रेडिक्शन बनाना

POST /v1/models/{owner}/{name}/predictions, बॉडी { "input": { … } } के साथ।

  • मॉडल के जॉब स्वीकार करते ही API जवाब देता है, आमतौर पर कुछ ही सेकंड में, और उस समय प्रेडिक्शन starting स्टेट में होता है। API कभी भी नतीजे का इंतज़ार नहीं करता।
  • अगर प्रेडिक्शन तुरंत फ़ेल हो जाता है, तब भी जवाब 201 ही होता है, जिसमें प्रेडिक्शन failed स्टेट में और अपने error के साथ होता है। उदाहरण के लिए, ऐसा तब होता है जब सेफ़्टी फ़िल्टर इनपुट को अस्वीकार कर देता है।
  • अगर कोई प्रेडिक्शन नहीं बना, तो जवाब एक त्रुटि होता है: अमान्य इनपुट, ज़रूरी प्लान न होना, एक साथ प्रगति में बहुत ज़्यादा प्रेडिक्शन, सेवा उपलब्ध न होना।

प्रेडिक्शन की सूची

GET /v1/predictions आपकी सभी keys से बने API प्रेडिक्शन लौटाता है, हर पेज पर 50, सबसे नए पहले।

  • next अगले पेज का URL (…/v1/predictions?cursor=…) होता है, या आख़िरी पेज पर null।
  • previous हमेशा null होता है।
  • picassoia.com पर आपके डिलीट किए गए प्रेडिक्शन इसमें शामिल नहीं होते।

कोई भी प्रेडिक्शन आपकी किसी भी key से देखा जा सकता है, लेकिन किसी और को वह कभी नहीं दिखता।

प्रेडिक्शन ऑब्जेक्ट

  • الرئيسية
  • مجموعة الأدوات
  • المكتبة
  • الحساب
ابدأ مجانًاابدأ مجانًا الآنجديدإنشاءابدأ الإنشاءالأسعارالأسعار80% OFF
  • استكشاف
  • البدء السريع
  • الوثائق
  • الأسعار
  • مفاتيح API
  • خادم MCP

وثائق API

  • نظرة عامة
  • البدء السريع
  • المصادقة
  • النماذج
  • التنبؤات
  • إنشاء تنبؤ
  • سرد التنبؤات
  • كائن التنبؤ
  • الاستعلام الدوري وتقدير الوقت (ETA)
  • الإلغاء
  • الأخطاء والحدود

واجهة PicassoIA API

التنبؤات

التنبؤ هو تشغيل واحد لنموذج: تُنشئه، وتستعلم عنه دوريًا، وتقرأ مخرجاته.

إنشاء تنبؤ

أرسل POST /v1/models/{owner}/{name}/predictions مع جسم الطلب { "input": { … } }.

  • تستجيب الواجهة بمجرد أن يقبل النموذج المهمة، عادةً في غضون ثوانٍ، بتنبؤ في الحالة starting. ولا تنتظر النتيجة أبدًا.
  • إذا فشل التنبؤ على الفور، تظل الاستجابة 201، مع تنبؤ في الحالة failed وحقل error الخاص به. يحدث هذا مثلًا عندما يرفض مرشّح الأمان المدخلات.
  • إذا لم يُنشأ أي تنبؤ، تكون الاستجابة خطأً: مدخلات غير صالحة، أو خطة غير مؤهلة، أو كثرة التنبؤات قيد التنفيذ، أو عدم توفر الخدمة.

سرد التنبؤات

يُرجع GET /v1/predictions تنبؤات API الخاصة بك، بواقع 50 تنبؤًا في كل صفحة، الأحدث أولًا، عبر جميع مفاتيحك.

  • الحقل next هو عنوان URL للصفحة التالية (…/v1/predictions?cursor=…)، أو null في الصفحة الأخيرة.
  • الحقل previous قيمته null دائمًا.
  • لا تُدرج التنبؤات التي حذفتها على picassoia.com.

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

كائن التنبؤ

الحقلالنوعملاحظات
idسلسلة نصيةالبادئة api_ يليها 32 حرفًا ست عشريًا.
modelسلسلة نصيةالنموذج الذي يشغّله.
inputكائنمدخلاتك بعد تطبيق القيم الافتراضية. تشير حقول الصور إلى النسخة المحفوظة لدى PicassoIA.
statusسلسلة نصيةstarting أو processing أو succeeded أو failed أو canceled.
outputقائمة عناوين URL، أو عنوان URL واحد، أو nullتُعيَّن قيمته بمجرد أن تصبح الحالة succeeded؛ وشكله هو output_schema الخاص بالنموذج.
errorسلسلة نصية أو nullسبب انتهائه بالحالة failed.
created_atISO 8601 أو null
started_atISO 8601 أو nullعادةً null: راجع status أدناه.
completed_atISO 8601 أو nullوقت انتهائه.
metrics.predict_timeرقم أو nullمدة التوليد بالثواني، بعد أن تصبح الحالة succeeded.
urls.get، urls.cancelعناوين URLعنوانا الاستعلام عنه وإلغائه.
etaكائن أو nullأثناء التشغيل: seconds، وهو عدد الثواني المتبقية المقدَّر، وnext_poll_in_seconds، أي متى تستعلم مجددًا. وقيمته null بعد انتهائه.

الحالات.

الحالةالمعنى
startingمقبول وينتظر في قائمة الانتظار.
processingقيد التوليد.
succeededانتهى. يحتوي output على النتيجة.
failedانتهى دون نتيجة. يوضّح error السبب.
canceledأُلغي قبل أن ينتهي.

التمييز بين starting وprocessing هو تقدير مبني على الموضع في قائمة الانتظار عند الإنشاء. ويكون التنبؤ الجديد دائمًا في الحالة starting. أما الحالات الثلاث الأخيرة فهي نهائية: التنبؤ الذي يصل إلى إحداها لا يتغير بعد ذلك أبدًا.

أخطاء التنبؤ الفاشل. تكون قيمة error في التنبؤ الفاشل إحدى الرسائل التالية:

  • رفض مرشّح الأمان المدخلات أو المخرجات. وتنتهي الرسالة بالعبارة (SAFETY_CHECKER_PICASSO_FILTER_S4).
  • The prediction failed. You can try again.
  • The prediction timed out. You can try again. لم يكتمل التنبؤ في غضون 3 ساعات.

المخرجات. تستضيف PicassoIA عناوين URL للمخرجات. نزّل الملفات التي تريد الاحتفاظ بها.

الاستعلام الدوري وتقدير الوقت (ETA)

يخبرك eta.next_poll_in_seconds بالوقت الذي يستحق فيه إجراء الاستعلام التالي:

  1. عند منتصف الوقت المقدَّر.
  2. عند بلوغ الوقت المقدَّر.
  3. ثم كل ثانيتين.

مثال بوقت مقدَّر قدره 10 ثوانٍ: استعلم بعد 5 ثوانٍ، ثم بعد 10 ثوانٍ، ثم كل ثانيتين. الاستعلام بوتيرة أسرع لن يمنحك النتيجة في وقت أبكر.

الإلغاء

عند إرسال POST /v1/predictions/{id}/cancel:

التنبؤ…ما يحدث
صورة، في قائمة الانتظار أو قيد التوليديُلغى. وتكون الاستجابة 200 مع status: "canceled".
فيديو، لا يزال في قائمة الانتظاريُلغى. وتكون الاستجابة 200 مع status: "canceled".
فيديو، بدأ توليده بالفعللا يمكن إلغاؤه: 409 not_cancelable. استعلم عنه دوريًا للحصول على نتيجته.
منتهٍ بالفعلتكون الاستجابة 200 مع التنبؤ كما هو.

يُفسح التنبؤ المُلغى مكانه فورًا ضمن حد 5 تنبؤات قيد التنفيذ المسموح به لك.

السابقالنماذجالتاليالأخطاء والحدود