واجهة PicassoIA API
النماذج والمخططات
كل نموذج تقدّمه الواجهة، بمدخلاته ومخرجاته، بصيغة JSON Schema.
النماذج
يُقدَّم المخطط الدقيق لكل نموذج أيضًا بصيغة JSON Schema: إذ يُرجع GET /v1/models/{owner}/{name} كلًّا من input_schema (بكل حقل وحدوده وقيمه الافتراضية) وoutput_schema.
الصور كمدخلات. تقبل حقول الصور أيًّا من نوعَي القيم التاليين:
- عنوان URL من نوع https يمكن الوصول إليه للعموم؛
- عنوان data URL:
data:image/png;base64,…، وكذلكimage/jpegأوimage/webp، بحجم أقصاه 5 ميغابايت لكل منها.
يجب أن تكون الصور بصيغة PNG أو JPEG أو WebP. تحتفظ PicassoIA بنسختها الخاصة من كل صورة، لذا يعرض الحقل input في التنبؤ عنوان URL لتلك النسخة. استخدم عناوين URL لأي صورة يتجاوز حجمها بضع مئات من الكيلوبايت: إذ إن الحد الأقصى لجسم الطلب بأكمله هو 10 ميغابايت.
الفيديو والصوت كمدخلات. لا يقبلهما سوى picassoia/picassoia-reference-to-video، وفقط على شكل عنوان URL من نوع https يمكن الوصول إليه للعموم (وليس كعنوان data URL):
- فيديو مرجعي: بصيغة MP4 أو MOV أو WebM، بحجم أقصاه 50 ميغابايت؛
- صوت مرجعي: بصيغة MP3 أو WAV أو M4A أو AAC أو OGG أو FLAC، بحجم أقصاه 20 ميغابايت.
تحتفظ PicassoIA بنسختها الخاصة من كل منهما أيضًا، ويعرض الحقل input عنوان URL لتلك النسخة. وأي ملف ليس بإحدى هذه الصيغ، أو يتعذّر تنزيله، تكون الاستجابة له 422 invalid_input مع تسمية الحقل.
تُرفض الحقول غير المعروفة، حتى لا يؤدي خطأ إملائي إلى الرجوع بصمت إلى قيمة افتراضية. وتكون الاستجابة 422 invalid_input.
كائن النموذج
{
"id": "picassoia/seedance-2.5-lite",
"owner": "picassoia",
"name": "seedance-2.5-lite",
"title": "Seedance 2.5 Lite",
"description": "Text or image to video with synchronized audio: …",
"input_schema": { "type": "object", "properties": { "…": {} }, "required": ["prompt"], "additionalProperties": false },
"output_schema": { "type": "string", "format": "uri" }
}