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

   पूरा होने तक इसे पोल करें

   eta.next_poll_in_seconds सेकंड बाद urls.get पर दोबारा रिक्वेस्ट भेजें: अनुमानित समय के आधे पर, अनुमानित समय पूरा होने पर, और उसके बाद हर 2 सेकंड में। इससे ज़्यादा तेज़ी से पोल करने पर नतीजा जल्दी नहीं मिलता।

   स्टेटस: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 जैसे ही हैं।

इन जवाबों में दिए गए ID, समय और URL सिर्फ़ उदाहरण हैं: आपके अपने मान हर जवाब में आते हैं।