קבצים ומדיה

העלה ונהל קבצים מקוד האפליקציה שלך. כל קובץ מקבל URL ציבורי קבוע.

Proyecta מספקת Files API דרך ה-SDK לניהול קבצים תוכנתי מקוד האפליקציה שלך.

קבצים מצורפים לצ’אט

תיבת הקלט של הצ’אט מקבלת תמונות ישירות — הדבק צילום מסך או גרור קובץ תמונה לתוך תיבת הקלט. פורמטים נתמכים: PNG, JPEG, WebP, GIF, AVIF. גודל מקסימלי: 10 MB לתמונה.

קבצים מצורפים לצ’אט הם חלק מההודעה, ולא מספריית הקבצים שלך. לאחסון מתמיד, השתמש ב-SDK.

ה-Files API (SDK)

לכל אפליקציית Proyecta שפורסמה יש גישה ל-API של אחסון קבצים דרך ה-Proyecta SDK. ה-SDK תומך ב-listing, fetching ו-uploading של קבצים. קבצים שהועלו מקבלים URL ציבורי קבוע שאפשר לייחס אליו מהאפליקציה שלך.

import Proyecta from '@proyecta-ai/sdk';

const proyecta = new Proyecta({ apiKey: process.env.PROYECTA_API_KEY });

// List files (supports limit and starting_after for pagination)
const files = await proyecta.files.list();

// Fetch a single file by ID
const file = await proyecta.files.get('1234567890123456789');
console.log(file.url); // permanent public URL

// Upload a file (two-step)
// Step 1: create a placeholder and get a signed upload URL
const { id: fileId, upload_url } = await proyecta.files.create({
    filename: 'avatar.png',
    mime_type: 'image/png',
});

// Step 2: PUT the file bytes directly to the signed URL
await fetch(upload_url, {
    method: 'PUT',
    body: fileBytes,
    headers: { 'Content-Type': 'image/png' },
});

// Step 3: finalize to get the permanent file record
const uploaded = await proyecta.files.finalize({ fileId });
console.log(uploaded.url); // permanent public URL, now populated

כל קובץ מכיל:

שדה	תיאור
id	מזהה ייחודי (מחרוזת snowflake מספרית)
url	URL ציבורי קבוע (מתמלא לאחר שלב ה-finalize)
filename	שם הקובץ המקורי בעת ההעלאה
mime_type	image/jpeg, application/pdf, וכדומה
size	גודל בבייטים
path	נתיב תיקייה אופציונלי (לדוגמה /images/blog)
content_hash	SHA-256 של תוכן הקובץ
metadata	מטא-נתונים произволados בצורת מפתח/ערך
created	חותמת זמן יצירה בפורמט ISO 8601
updated	חותמת זמן עדכון אחרון בפורמט ISO 8601

כיצד מועלים קבצים לאפליקציה שלי?

העלאת קבצים מטופלת דרך ה-AI builder. בקש מה-AI לבנות עבורך את תהליך ההעלאה:

• "Let users upload a profile photo and store it in Proyecta Files"
• "Add an image gallery where signed-in users can upload and view their photos"
• "Let me attach PDF invoices to orders"

ה-AI מחווט את ההעלאה בקוד האפליקציה שלך תוך שימוש ב-API ההעלאה הדו-שלבי של ה-SDK ומייחס ל-URL הציבורי שמוחזר. אפשר גם לקרוא ל-files.create() / files.finalize() ישירות מקוד האפליקציה שלך.

שאלות נפוצות

האם כתובות ה-URL של הקבצים הן ציבוריות?

כן. לכל קובץ שמוחזר על ידי ה-Files API יש URL ציבורי קבוע. אל תעלה דברים שאתה לא רוצה שיהיו חשופים.

מה הגודל המקסימלי של קובץ?

מגבלות לפי קובץ תלויות בתוכנית שלך. קבצים מצורפים לצ’אט מוגבלים ל-10 MB לתמונה.

האם אפשר לשנות גודל או לחתוך תמונות דרך ה-URL?

טרנספורמציות תמונה בזמן אמת (שינוי גודל, חיתוך, המרת פורמט) נמצאות ב-roadmap.

בקרוב

• טרנספורמציות תמונה דרך פרמטרי URL (שינוי גודל, חיתוך, המרת פורמט)
• ארגון תיקיות — יצירה וניהול נתיבי תיקיות בפאנל
• “Add to Chat” משורת קובץ, כך שנכסי הספרייה יוכלו להיות מוכנסים לשיחה עם ה-AI