דילוג לתוכן
עברית
קבלת מפתח API
מדריך API

קבצים

הצגה כ-Markdown עודכן

מודלים שמקבלים תמונות, וידאו או אודיו מקבלים אותם באחת משלוש צורות. בכל עמוד מודל מסומנים פרמטרי הקובץ שלו (לדוגמה image, images, videos, audios).

1. כתובת URL ציבורית

כל כתובת URL מסוג https:// (או http://) שהמודל יכול להוריד:

JSON
{ "image": "https://example.com/photos/product.jpg" }

הקובץ חייב להיות נגיש ללא עוגיות או התחברות ולהישאר נגיש עד שהבקשה התחילה. בכל עמוד מודל מפורטות מגבלות הגודל והמידות של פרמטרי הקבצים שלו.

2. URI של נתונים

אפשר להוסיף קבצים קטנים ישירות כ-URI מסוג data: בגודל של עד 10 MB:

JSON
{ "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }

Base64 מגדיל את גוף הבקשה בכשליש לעומת הקובץ, לכן העדף העלאות לכל דבר גדול.

3. העלאה

עבור קבצים מקומיים, בקש כתובת URL להעלאה, בצע PUT של הבתים אליה והעבר למודל את file_url שהוחזר. יצירת כתובת URL להעלאה היא ללא עלות.

1 · קבלת כתובת URL להעלאה
curl -X POST "https://api.doitong.com/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
201 Created · העלאה
{
  "object": "upload",
  "upload_url": "https://…signed upload URL…",
  "file_url": "https://content.doitong.com/…/product.jpg",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "content_type": "image/jpeg",
  "expires_in": 3600,
  "max_bytes": 15728640
}
2 · העלאת הבתים עם הכותרות שהוחזרו בדיוק
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · שימוש ב-file_url כקלט המודל
curl -X POST "https://api.doitong.com/v1/run/{model_id}?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://content.doitong.com/…/product.jpg", "prompt": "..."}'
  • העלאות נתמכות: .jpg, .jpeg, .png, .webp (עד 15 MB) ו-.mp4, .mov, .webm (עד 200 MB). הסיומת קובעת את הסוג; content_type חייב להתאים לה.
  • כתובת ה-URL להעלאה תקפה למשך שעה. file_url נשאר תקף.
  • עבור אודיו, השתמש בכתובת URL ציבורית או ב-URI של נתונים.

קובצי פלט

אתה בוחר כמה זמן קובצי הפלט יישמרו:

  • לצמיתות (permanent, ברירת המחדל): עד שתמחק אותם, תמורת 100 קרדיטי API (⁨‏0.10 ‏$⁩) לכל GB בחודש, בחיוב פעם ביום מיתרת ה-API (1 GB = 1024³ בתים).
  • 7 ימים (temporary): ללא עלות, ואז נמחקים מהאחסון שלנו.

הגדר את ברירת המחדל באמצעות המתג "שמירת קבצים לצמיתות" ב-לוח הבקרה או באמצעות PATCH /account/storage, ועקוף אותה בכל הרצה באמצעות ?storage=temporary (או permanent):

מסוף
curl -X PATCH "https://api.doitong.com/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'

כל בקשה מציגה את storage שלה (mode, bytes, expires_at, expired). ההגדרה חלה על בקשות חדשות; קבצים שכבר נשמרים אצלך לצמיתות יישארו עד שתמחק אותם באמצעות DELETE /requests/{id}/files (ראו בקשות). אם יתרת ה-API אינה יכולה לשלם על האחסון, תישלח אליך הודעת דוא״ל ויהיו לך 30 ימים לטעינה לפני שהקבצים הנשמרים יהפכו לזמניים.