PicassoIA Image Editor Pro

1. 1

   أنشئ التنبؤ

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

   الطلب

   curl -s -X POST https://api.picassoia.com/v1/models/picassoia/picassoia-image-editor-pro/predictions \
     -H "Authorization: Bearer $PICASSOIA_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"input":{"prompt":"put the cat from image 1 on the sofa from image 2","images":["https://example.com/cat.png","https://example.com/sofa.jpg"]}}'

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

   {
     "id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
     "model": "picassoia/picassoia-image-editor-pro",
     "input": {
       "prompt": "put the cat from image 1 on the sofa from image 2",
       "images": [
         "https://example.com/cat.png",
         "https://example.com/sofa.jpg"
       ],
       "aspect_ratio": "match_input_image",
       "num_outputs": 1,
       "output_format": "webp",
       "output_quality": 95
     },
     "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.webp"
     ],
     "error": null,
     "completed_at": "2026-10-01T09:30:08.000Z",
     "metrics": {
       "predict_time": 6.4
     },
     "eta": null
   }

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

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