PicassoIA Image

1. 1

   أنشئ التنبؤ

   أرسل المدخلات في طلب POST. تستجيب واجهة API فورًا بالرمز 201 دون انتظار النتيجة: يكون التنبؤ في الحالة starting، مع تقدير للوقت في eta والعنوان الذي تستعلم عنه في urls.get.

   الطلب

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

   الاستجابة · 201 Createdstarting

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "model": "picassoia/picassoia-image",
     "input": {
       "prompt": "a lighthouse at sunset, oil painting",
       "aspect_ratio": "1:1",
       "num_outputs": 1,
       "output_format": "jpg",
       "output_quality": 80
     },
     "output": null,
     "error": null,
     "status": "starting",
     "created_at": "2026-10-01T09:30:00.000Z",
     "started_at": null,
     "completed_at": null,
     "metrics": {
       "predict_time": null
     },
     "urls": {
       "get": "https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
       "cancel": "https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60/cancel"
     },
     "eta": {
       "seconds": 12,
       "next_poll_in_seconds": 6
     }
   }

2. 2

   استعلم عنه دوريًا حتى ينتهي

   أعد طلب urls.get بعد عدد الثواني الذي يحدده eta.next_poll_in_seconds: عند منتصف الوقت المقدَّر، ثم عند بلوغ الوقت المقدَّر، ثم كل ثانيتين. الاستعلام بوتيرة أسرع لن يمنحك النتيجة في وقت أبكر.

   الحالات:startingprocessingsucceeded·failed·canceled

   الطلب

   # Repeat after eta.next_poll_in_seconds until status is
   # succeeded, failed or canceled.
   curl -s https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60 \
     -H "Authorization: Bearer $PICASSOIA_API_KEY"

   الاستجابة · 200 OK · قيد التنفيذprocessing

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "status": "processing",
     "output": null,
     "eta": {
       "seconds": 6,
       "next_poll_in_seconds": 6
     }
   }

   لا تُعرض إلا الحقول التي تتغير؛ أما البقية فكما في الخطوة 1.

3. 3

   اقرأ النتيجة

   عندما تكون قيمة status هي succeeded، يكون output قائمة بعناوين URL للصور. نزّل الملفات التي تريد الاحتفاظ بها.

   إذا كانت قيمة status هي failed، فإن error يوضّح السبب؛ وتعني canceled أن التنبؤ أُلغي قبل أن ينتهي. هذه الحالات الثلاث نهائية: لا يتغير التنبؤ بعدها أبدًا.

   الطلب

   # The last poll holds the result: "output" when "status" is succeeded,
   # "error" when it is failed. With jq, just those three fields:
   curl -s https://api.picassoia.com/v1/predictions/api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60 \
     -H "Authorization: Bearer $PICASSOIA_API_KEY" | jq '.status, .output, .error'

   الاستجابة · 200 OK · مكتملsucceeded

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "status": "succeeded",
     "output": [
       "https://…/output-1.jpg"
     ],
     "error": null,
     "completed_at": "2026-10-01T09:30:08.000Z",
     "metrics": {
       "predict_time": 6.4
     },
     "eta": null
   }

   لا تُعرض إلا الحقول التي تتغير؛ أما البقية فكما في الخطوة 1.

المعرّفات والأوقات وعناوين URL في هذه الاستجابات مجرد أمثلة: تصلك قيمك الفعلية في كل استجابة.