רילס בעברית מתוך הקוד, במחיר שאישרתם מראש.
מעלים סרטון ומקבלים ריל עם כתוביות בעברית, כותרת פתיחה, חיתוכים ומוזיקה, בכל הפורמטים. כל רינדור מתחיל בהצעת מחיר בשקלים, ורץ רק בסכום שאישרתם.
מפתח בדיקה חינם, 20 רינדורים ביום. לתיעוד
GET /api/v1/renders/…
{
"status": "done",
"aspect": "9:16",
"style": "karaoke",
"hook": "חומוס אמיתי, בלי קיצורים!",
"duration_seconds": 14,
"amount_agorot": 60,
"download_url": "https://…"
}מסרטון לריל, בארבע קריאות
REST ו-JSON, על אותו סטודיו ובאותם מחירים.
מעלים את הסרטון
POST /v1/uploadsנותן כתובת להעלאת הקובץ, ו-POST /v1/videosהופך אותו לסרטון. התמלול בעברית, עם זמן לכל מילה, בלי עלות.מבקשים הצעת מחיר
POST /v1/renders/estimateמחזיר את המחיר באגורות, שורה אחרי שורה, בלי לחייב ובלי להתחיל רינדור.מרנדרים במחיר שאישרתם
POST /v1/rendersמקבל את הסכום שאישרתם. הסכום נשמר לרינדור, יורד מהקרדיט רק כשהריל מוכן, ומשתחרר אם הרינדור נכשל. אם המחיר השתנה בינתיים, שום דבר לא יורד ומקבלים את המחיר החדש.מורידים את הריל
GET /v1/renders/{id}מחזיר MP4, תמונת שער, כתוביות SRT וטקסט לפוסט. אותו ריל גם ב-4:5 · 1:1 · 16:9 · 4:3, בלי תוספת.
מתחילים בבדיקה, עוברים לחי
שני סוגי מפתחות מאותו חשבון. בודקים בחינם, ועוברים למפתח חי כשהכול עובד.
- מפתח בדיקה
rly_test_… - חינם, עד 20 רינדורים ביום. הריל יוצא ברזולוציה נמוכה ועם סימן מים, בלי מוזיקה, ושום דבר לא יורד מהיתרה.
- מפתח חי
rly_live_… - ריל מלא מהקרדיט שבחשבון, במחירי הסטודיו: ₪0.04 לשנייה של ריל מוכן, ₪0.60 לכל הפחות. את המחירון כולו מחזיר
GET /v1/prices, גם בלי מפתח. - שליטה בכל מפתח
- לכל מפתח קובעים הרשאות, תוקף ותקרת הוצאה, ורואים כל קריאה שלו ביומן. מחליפים סוד או מבטלים מפתח מהחשבון.
בלי הפתעות בחיוב
מחיר לפני כל רינדור
רינדור לא מתחיל בלי הסכום שאישרתם. מחיר שהשתנה מחזיר תשובה ברורה, לא חיוב.
ניסיון חוזר בטוח
כל רינדור נשלח עם
Idempotency-Key. אותה בקשה פעמיים מחזירה את אותו רינדור, ולא מחייבת שוב.כישלון לא עולה כלום
הסכום רק נשמר בזמן הרינדור. אם משהו נכשל אצלנו, הוא חוזר ליתרה.
שגיאות שאפשר לקרוא
כל שגיאה מגיעה לפי RFC 9457, עם סוג קבוע לבדוק בקוד והסבר בעברית.
התיעוד
פתוח לכולם, גם בלי חשבון: התחלה מהירה, כל הקריאות, המחירים והשגיאות.
להתחלה
- התחלה מהירה, בעבריתapp.reely.co.il/developers/docs
- Quick start in Englishapp.reely.co.il/developers/docs/en
לעיון
- כל הקריאות, אחת אחתapp.reely.co.il/developers/docs/reference
- מה כל קריאה עולהapp.reely.co.il/developers/docs/capabilities
- סוגי השגיאותapp.reely.co.il/developers/docs/errors
- OpenAPI 3.1app.reely.co.il/api/v1/openapi.json
שאלות של מפתחים
צריך חשבון כדי לקבל מפתח?
כן. נרשמים בחינם ויוצרים מפתח בעמוד המפתחים בחשבון. המפתח המלא מוצג רק פעם אחת, כשיוצרים אותו, אז שמרו אותו במקום בטוח.
כמה עולה ריל מה-API?
בדיוק כמו בסטודיו: ₪0.04 לשנייה של ריל מוכן, ₪0.60 לכל הפחות, מהקרדיט שבחשבון. העלאה, תמלול, הצעת מחיר והפורמטים הנוספים לא עולים כלום.
מה קורה כשרינדור נכשל?
שום דבר לא יורד מהיתרה. הסכום רק נשמר בזמן הרינדור ומשתחרר אם הוא נכשל, והתשובה מסבירה בעברית מה השתבש.
אפשר לרנדר במותג של לקוח?
כן. GET /v1/brands מחזיר את המותגים שבחשבון. שולחים את המזהה של אחד מהם ב-brand_id, והריל יוצא עם הלוגו והצבעים שלו.
באיזו שפה ה-API?
שמות השדות באנגלית, והתוכן בעברית: התמלול, הכותרת, הכתוביות, טקסט הפוסט והודעות השגיאה. התיעוד כתוב בעברית ובאנגלית.
נסו עם מפתח בדיקה
מפתח בדיקה מרנדר בחינם, עם סימן מים.
ליצירת מפתח APIאין לכם חשבון? נרשמים בחינם, וחוזרים ישר לעמוד המפתחים.