PicassoIA Image का मॉडल ID picassoia/picassoia-image है। टेक्स्ट से इमेज: हर रिक्वेस्ट पर 1 या 2 इमेज और 7 आस्पेक्ट रेशियो।
API को कॉल करना
https://api.picassoia.com/v1/models/picassoia/picassoia-image/predictions पर ऐसी JSON बॉडी के साथ रिक्वेस्ट भेजें जिसका input नीचे दिए गए पैरामीटर से मेल खाता हो।
सेटअप
अपनी API key अपने सर्वर पर किसी एनवायरनमेंट वेरिएबल में रखें, और उसे हर रिक्वेस्ट के Authorization हेडर में भेजें।
export PICASSOIA_API_KEY="pia_sk_…"रिक्वेस्ट पैरामीटर
promptstringज़रूरी- डिफ़ॉल्टकोई नहीं
- आउटपुट में क्या दिखना चाहिए। 4000 कैरेक्टर तक।
aspect_ratiostring- डिफ़ॉल्ट
"1:1" - आउटपुट का आकार। जहाँ match_input_image का विकल्प हो, वहाँ यह इनपुट इमेज का अनुपात बनाए रखता है, या कई इमेज होने पर पहली इमेज का। विकल्प: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 और 2:3।
num_outputsinteger- डिफ़ॉल्ट
1 - कितने नतीजे बनाने हैं। 1 से 2 तक।
output_formatstring- डिफ़ॉल्ट
"jpg" - नतीजे का फ़ाइल फ़ॉर्मेट। विकल्प: webp, jpg और png।
output_qualityinteger- डिफ़ॉल्ट
80 - कम्प्रेशन क्वालिटी, JPG और WebP के लिए। 0 से 100 तक।
seedinteger- डिफ़ॉल्टकोई नहीं
- किसी नतीजे को दोबारा पाने के लिए इसे सेट करें; रैंडम नतीजे के लिए इसे छोड़ दें।
मोड
मोड इस पर निर्भर करता है कि आप प्रॉम्प्ट के साथ कोई फ़ाइल भेजते हैं या नहीं, और कौन-सी। हर मोड एक ही एंडपॉइंट इस्तेमाल करता है।
उदाहरण रिक्वेस्ट
टेक्स्ट से इमेज
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"}}'const API = 'https://api.picassoia.com/v1'
const headers = {
Authorization: `Bearer ${process.env.PICASSOIA_API_KEY}`,
'Content-Type': 'application/json',
}
const sleep = (s) => new Promise((resolve) => setTimeout(resolve, s * 1000))
const input = {
prompt: "a lighthouse at sunset, oil painting"
}
const created = await fetch(`${API}/models/picassoia/picassoia-image/predictions`, {
method: 'POST',
headers,
body: JSON.stringify({ input }),
})
let prediction = await created.json()
if (!created.ok) throw new Error(`${prediction.code}: ${prediction.detail}`)
while (!['succeeded', 'failed', 'canceled'].includes(prediction.status)) {
await sleep(prediction.eta?.next_poll_in_seconds ?? 2)
prediction = await (await fetch(prediction.urls.get, { headers })).json()
}
if (prediction.status !== 'succeeded') throw new Error(prediction.error ?? prediction.status)
console.log(prediction.output)import os, time, requests
API = "https://api.picassoia.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['PICASSOIA_API_KEY']}"}
payload = {"input": {
"prompt": "a lighthouse at sunset, oil painting",
}}
response = requests.post(f"{API}/models/picassoia/picassoia-image/predictions", json=payload, headers=HEADERS)
prediction = response.json()
if not response.ok:
raise RuntimeError(f"{prediction['code']}: {prediction['detail']}")
while prediction["status"] not in ("succeeded", "failed", "canceled"):
time.sleep((prediction.get("eta") or {}).get("next_poll_in_seconds", 2))
prediction = requests.get(prediction["urls"]["get"], headers=HEADERS).json()
if prediction["status"] != "succeeded":
raise RuntimeError(prediction["error"] or prediction["status"])
print(prediction["output"])प्रमाणीकरण
हर रिक्वेस्ट के Authorization हेडर में Bearer टोकन के रूप में एक API key होनी चाहिए। अपने अकाउंट में keys बनाएँ; पूरी key सिर्फ़ एक बार दिखाई जाती है।
Authorization: Bearer $PICASSOIA_API_KEYकतार और पोलिंग
हर प्रेडिक्शन में तीन स्टेप होते हैं: उसे बनाएँ, पूरा होने तक पोल करें, फिर नतीजा पढ़ें।
भेजना
API आमतौर पर कुछ ही सेकंड में 201 के साथ जवाब देता है, जिसमें प्रेडिक्शन starting स्टेट में होता है, eta में एक अनुमान होता है और urls.get में पोल करने का URL होता है। अगर प्रेडिक्शन तुरंत फ़ेल हो जाता है, जैसे जब सेफ़्टी फ़िल्टर इनपुट को अस्वीकार कर देता है, तब भी जवाब 201 ही होता है, जिसमें प्रेडिक्शन failed स्टेट में और अपने error के साथ होता है।
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"}}'const API = 'https://api.picassoia.com/v1'
const headers = {
Authorization: `Bearer ${process.env.PICASSOIA_API_KEY}`,
'Content-Type': 'application/json',
}
const input = {
prompt: "a lighthouse at sunset, oil painting"
}
const created = await fetch(`${API}/models/picassoia/picassoia-image/predictions`, {
method: 'POST',
headers,
body: JSON.stringify({ input }),
})
let prediction = await created.json()
if (!created.ok) throw new Error(`${prediction.code}: ${prediction.detail}`)
console.log(prediction.id, prediction.status) // api_…, startingimport os, requests
API = "https://api.picassoia.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['PICASSOIA_API_KEY']}"}
payload = {"input": {
"prompt": "a lighthouse at sunset, oil painting",
}}
response = requests.post(f"{API}/models/picassoia/picassoia-image/predictions", json=payload, headers=HEADERS)
prediction = response.json()
if not response.ok:
raise RuntimeError(f"{prediction['code']}: {prediction['detail']}")
print(prediction["id"], prediction["status"]) # api_…, starting{
"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
}
}पोल करना
eta.next_poll_in_seconds के बाद urls.get को फिर से पोल करें: अनुमानित समय के आधे पर, अनुमानित समय पूरा होने पर, फिर हर 2 सेकंड में।
# 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"const sleep = (s) => new Promise((resolve) => setTimeout(resolve, s * 1000))
while (!['succeeded', 'failed', 'canceled'].includes(prediction.status)) {
await sleep(prediction.eta?.next_poll_in_seconds ?? 2)
prediction = await (await fetch(prediction.urls.get, { headers })).json()
}import time
while prediction["status"] not in ("succeeded", "failed", "canceled"):
time.sleep((prediction.get("eta") or {}).get("next_poll_in_seconds", 2))
prediction = requests.get(prediction["urls"]["get"], headers=HEADERS).json(){
"id": "api_3f9c2b7e8d1a4c6f9e0b1a2c3d4e5f60",
"status": "processing",
"output": null,
"eta": {
"seconds": 6,
"next_poll_in_seconds": 6
}
}नतीजा
जब status succeeded होता है, तो output में नतीजा होता है। अगर प्रेडिक्शन 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'if (prediction.status !== 'succeeded') throw new Error(prediction.error ?? prediction.status)
console.log(prediction.output)if prediction["status"] != "succeeded":
raise RuntimeError(prediction["error"] or prediction["status"])
print(prediction["output"]){
"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
}रद्द करना
POST urls.cancel ऐसे प्रेडिक्शन को रोक देता है जो अभी कतार में है (कोई भी मॉडल) या ऐसी इमेज को जो अभी जनरेट हो रही है; जो वीडियो पहले से जनरेट हो रहा है, उसके लिए जवाब 409 not_cancelable होता है।
इन जवाबों में दिए गए ID, समय और URL उदाहरण हैं: आपके जवाबों में आपके अपने होंगे।
आउटपुट
प्रेडिक्शन सफल होने पर output 1 या 2 इमेज URL की सूची होता है।
असली आउटपुट
त्रुटियाँ और सीमाएँ
त्रुटियाँ स्थिर code वाले JSON problem details के रूप में आती हैं, और 422 जवाब में हर गलत फ़ील्ड का नाम होता है।
सीमाएँ
- हर अकाउंट पर एक साथ 5 प्रेडिक्शन, कतार में या चलते हुए
- रिक्वेस्ट बॉडी 10 MB तक; data URL के रूप में इमेज, हर एक 5 MB तक
- प्रॉम्प्ट 4000 कैरेक्टर तक
- अज्ञात फ़ील्ड 422 invalid_input के साथ अस्वीकार किए जाते हैं
कीमत
सक्रिय Infinite प्लान के साथ $0 प्रति रिक्वेस्ट: सेटिंग्स चाहे जो हों, API प्रेडिक्शन में कोई क्रेडिट खर्च नहीं होता।
अन्य प्रोवाइडर किसी मिलते-जुलते मॉडल के लिए $0.02/मेगापिक्सेल चार्ज करते हैं (1 अक्टूबर 2026 तक की कीमत)।
API की कीमतJSON Schema
वही स्कीमा जो API GET /v1/models/picassoia/picassoia-image पर देता है।
{
"input_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "What the image should show."
},
"aspect_ratio": {
"default": "1:1",
"description": "Aspect ratio of the images.",
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"num_outputs": {
"default": 1,
"description": "How many images to create: 1 or 2.",
"type": "integer",
"minimum": 1,
"maximum": 2
},
"output_format": {
"default": "jpg",
"description": "File format of the images.",
"type": "string",
"enum": [
"webp",
"jpg",
"png"
]
},
"output_quality": {
"default": 80,
"description": "Quality of JPG and WebP images, from 0 to 100.",
"type": "integer",
"minimum": 0,
"maximum": 100
},
"seed": {
"description": "Random seed. Set it to reproduce a result.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"prompt"
],
"additionalProperties": false
},
"output_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1,
"maxItems": 2,
"description": "URLs of the generated images, in the requested output_format."
}
}