يستخدم Seedance 2.5 Lite معرّف النموذج picassoia/seedance-2.5-lite. تحويل النص والصورة إلى فيديو مع الصوت ومقاطع مدتها 5 أو 10 أو 15 ثانية ودقة 480p أو 720p.
استدعاء API
أرسل الطلبات إلى https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions بجسم JSON يتوافق فيه الكائن input مع المعاملات أدناه.
الإعداد
احتفظ بمفتاح API على خادمك، في متغير بيئة، وأرسله في ترويسة Authorization مع كل طلب.
export PICASSOIA_API_KEY="pia_sk_…"معاملات الطلب
promptstringمطلوب- القيمة الافتراضيةلا يوجد
- ما ينبغي أن تُظهره المخرجات. عدد الأحرف: حتى 4000.
imagestring- القيمة الافتراضيةلا يوجد
- الإطار الافتتاحي، أو الصورة التي تنطلق منها. صورة بصيغة PNG أو JPEG أو WebP، كعنوان URL عام من نوع https أو كعنوان data URL بحجم أقصاه 5 ميغابايت.
last_frame_imagestring- القيمة الافتراضيةلا يوجد
- الإطار الختامي: ينتهي المقطع عنده. يتطلب الحقل image. صورة بصيغة PNG أو JPEG أو WebP، كعنوان URL عام من نوع https أو كعنوان data URL بحجم أقصاه 5 ميغابايت.
resolutionstring- القيمة الافتراضية
"480p" - حجم المخرجات. الخيارات: 480p و720p.
durationnumber- القيمة الافتراضية
5 - مدة المقطع بالثواني. الخيارات: 5 و10 و15. حتى 15 عند 480p. حتى 10 عند 720p.
aspect_ratiostring- القيمة الافتراضية
"match_input_image" / "16:9" - شكل المخرجات. وحيث يتوفر الخيار match_input_image، فإنه يحافظ على نِسب أبعاد الصورة المدخلة، أو الصورة الأولى عند وجود عدة صور. الخيارات: match_input_image و1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3. إذا لم ترسله: match_input_image عند إرسال image، و16:9 عند عدم إرساله.
save_audioboolean- القيمة الافتراضية
true - الاحتفاظ بالمسار الصوتي المُولَّد.
seedinteger- القيمة الافتراضيةلا يوجد
- اضبطها لإعادة إنتاج نتيجة ما، أو احذفها لتكون عشوائية.
enhance_promptboolean- القيمة الافتراضية
true - تعيد Picasso IA صياغة موجّهك للحصول على نتيجة أفضل. ويبقى موجّهك الأصلي في المدخلات.
الأوضاع
يتحدد الوضع بالملفات التي ترسلها مع الموجّه، إن وُجدت. وتستخدم جميع الأوضاع نقطة النهاية نفسها.
مثال على الطلب
تحويل النص إلى فيديو
curl -s -X POST https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions \
-H "Authorization: Bearer $PICASSOIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"prompt":"a paper boat sailing down a rainy street"}}'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 paper boat sailing down a rainy street"
}
const created = await fetch(`${API}/models/picassoia/seedance-2.5-lite/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 paper boat sailing down a rainy street",
}}
response = requests.post(f"{API}/models/picassoia/seedance-2.5-lite/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"])تحويل الصورة إلى فيديو
curl -s -X POST https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions \
-H "Authorization: Bearer $PICASSOIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"prompt":"the camera slowly pushes in as she turns and smiles","image":"https://example.com/first-frame.jpg"}}'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: "the camera slowly pushes in as she turns and smiles",
image: "https://example.com/first-frame.jpg"
}
const created = await fetch(`${API}/models/picassoia/seedance-2.5-lite/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": "the camera slowly pushes in as she turns and smiles",
"image": "https://example.com/first-frame.jpg",
}}
response = requests.post(f"{API}/models/picassoia/seedance-2.5-lite/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"])الإطار الأول والأخير
curl -s -X POST https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions \
-H "Authorization: Bearer $PICASSOIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"prompt":"a smooth transition from day to night over the city","image":"https://example.com/first-frame.jpg","last_frame_image":"https://example.com/last-frame.jpg"}}'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 smooth transition from day to night over the city",
image: "https://example.com/first-frame.jpg",
last_frame_image: "https://example.com/last-frame.jpg"
}
const created = await fetch(`${API}/models/picassoia/seedance-2.5-lite/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 smooth transition from day to night over the city",
"image": "https://example.com/first-frame.jpg",
"last_frame_image": "https://example.com/last-frame.jpg",
}}
response = requests.post(f"{API}/models/picassoia/seedance-2.5-lite/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"])المصادقة
يحتاج كل طلب إلى مفتاح API في ترويسة Authorization، كرمز Bearer. أنشئ المفاتيح من حسابك؛ يُعرض المفتاح كاملًا مرة واحدة.
Authorization: Bearer $PICASSOIA_API_KEYقائمة الانتظار والاستعلام الدوري
يمر كل تنبؤ بثلاث خطوات: أنشئه، ثم استعلم عنه دوريًا حتى ينتهي، ثم اقرأ النتيجة.
الإرسال
تستجيب الواجهة بالرمز 201، عادةً في غضون ثوانٍ، بالتنبؤ في الحالة starting، مع تقدير للوقت في eta والعنوان الذي تستعلم عنه في urls.get. وإذا فشل التنبؤ على الفور، كأن يرفض مرشّح الأمان المدخلات، تظل الاستجابة 201، مع التنبؤ في الحالة failed والخطأ الخاص به.
curl -s -X POST https://api.picassoia.com/v1/models/picassoia/seedance-2.5-lite/predictions \
-H "Authorization: Bearer $PICASSOIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"prompt":"a paper boat sailing down a rainy street"}}'const API = 'https://api.picassoia.com/v1'
const headers = {
Authorization: `Bearer ${process.env.PICASSOIA_API_KEY}`,
'Content-Type': 'application/json',
}
const input = {
prompt: "a paper boat sailing down a rainy street"
}
const created = await fetch(`${API}/models/picassoia/seedance-2.5-lite/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 paper boat sailing down a rainy street",
}}
response = requests.post(f"{API}/models/picassoia/seedance-2.5-lite/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/seedance-2.5-lite",
"input": {
"prompt": "a paper boat sailing down a rainy street",
"resolution": "480p",
"duration": 5,
"aspect_ratio": "16:9",
"save_audio": true,
"enhance_prompt": true
},
"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": 60,
"next_poll_in_seconds": 30
}
}الاستعلام
استعلم عن urls.get مجددًا بعد eta.next_poll_in_seconds: عند منتصف الوقت المقدَّر، ثم عند بلوغه، ثم كل ثانيتين.
# 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": 30,
"next_poll_in_seconds": 30
}
}النتيجة
عندما تكون قيمة status هي succeeded، يحتوي output على النتيجة. ويحمل التنبؤ الفاشل سببه في error، أما التنبؤ المُلغى فقد أُوقف قبل أن ينتهي. وهذه الحالات الثلاث نهائية.
# 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.mp4",
"error": null,
"completed_at": "2026-10-01T09:30:54.000Z",
"metrics": {
"predict_time": 52.8
},
"eta": null
}الإلغاء
يوقف الطلب POST urls.cancel أي تنبؤ لا يزال في قائمة الانتظار (لأي نموذج) أو أي صورة لا تزال قيد التوليد؛ أما الفيديو الذي بدأ توليده بالفعل فتكون الاستجابة له 409 not_cancelable.
المعرّفات والأوقات وعناوين URL في هذه الاستجابات مجرد أمثلة: ستحمل استجاباتك قيمها الخاصة.
المخرجات
عندما ينجح التنبؤ، تكون قيمة output عنوان URL لفيديو MP4.
مخرجات حقيقية
الأخطاء والحدود
الأخطاء عبارة عن تفاصيل مشكلات (problem details) بصيغة JSON مع code ثابت، والاستجابة 422 تذكر كل حقل به خطأ.
{
"title": "Input validation failed",
"status": 422,
"code": "invalid_input",
"detail": "input.duration: At 720p the longest clip is 10 seconds.",
"invalid_fields": [
{
"type": "invalid_value",
"field": "input.duration",
"description": "At 720p the longest clip is 10 seconds."
}
]
}الحدود
- التنبؤات في قائمة الانتظار أو قيد التشغيل في الوقت نفسه: 5 لكل حساب
- جسم الطلب حتى 10 ميغابايت؛ والصور بصيغة data URL حتى 5 ميغابايت لكل منها
- عدد أحرف الموجّه: حتى 4000
- تُرفض الحقول غير المعروفة بالخطأ 422 invalid_input
الأسعار
التكلفة $0 لكل طلب مع خطة Infinite نشطة: لا تستهلك تنبؤات API أي أرصدة، أيًّا كانت الإعدادات.
يتقاضى مزوّدون آخرون ابتداءً من ~$0.2205/ثانية مقابل نموذج مماثل (بتاريخ ١ أكتوبر ٢٠٢٦).
أسعار APIمخطط JSON Schema
المخطط نفسه الذي تقدّمه الواجهة عبر GET /v1/models/picassoia/seedance-2.5-lite.
{
"input_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "What happens in the video."
},
"image": {
"type": "string",
"description": "Opening frame (image-to-video): an https URL or a data URL."
},
"last_frame_image": {
"type": "string",
"description": "Closing frame: an https URL or a data URL. Needs image as well."
},
"resolution": {
"default": "480p",
"description": "480p (up to 15 s) or 720p (up to 10 s).",
"type": "string",
"enum": [
"480p",
"720p"
]
},
"duration": {
"default": 5,
"description": "Length in seconds: 5, 10 or 15.",
"type": "number",
"enum": [
5,
10,
15
]
},
"aspect_ratio": {
"description": "Default: match_input_image when there is an image, 16:9 without one.",
"type": "string",
"enum": [
"match_input_image",
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3"
]
},
"save_audio": {
"default": true,
"description": "Keep the generated audio track.",
"type": "boolean"
},
"seed": {
"description": "Random seed. Set it to reproduce a result.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"enhance_prompt": {
"default": true,
"description": "Let PicassoIA rewrite the prompt for a better video before generating it.",
"type": "boolean"
}
},
"required": [
"prompt"
],
"additionalProperties": false
},
"output_schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "string",
"format": "uri",
"description": "URL of the generated video (MP4)."
}
}