Shotto למפתחים

יוצרים סרטוני UGC בעברית ועורכים סרטונים מתוך Claude Code, Codex, Cursor, n8n, Zapier או כל קוד. REST API רגיל ושרת MCP, עם אותה יתרת קרדיטים, אותם מחירים ואותם כללים כמו באתר.

לא מפתחים? המדריך הפשוט לחיבור Claude, Cursor, Codex ו-n8n.

הזדהות

יוצרים מפתח בהגדרות ← API ו-MCP (המפתח מוצג פעם אחת). כל בקשה נשלחת עם הכותרת Authorization: Bearer sk_shotto_…. בלי מפתח תקין מקבלים 401. מגבלה: 60 בקשות בדקה לכל מפתח (429 עם Retry-After). מפתח שדלף? מבטלים אותו באותו מסך והוא מפסיק לעבוד מיד.

יצירת מפתח כוללת אישור של תנאי השימוש. כל פעולה עם המפתח, גם של סוכן AI, נחשבת פעולה שלכם ומחייבת את היתרה שלכם.

קרדיטים

• סרטון עם מגיש/ה: קרדיט לשנייה באיכות רגילה (10 שנ׳ = 10 · 20 שנ׳ = 20 · 30 שנ׳ = 30), 2 קרדיטים לשנייה עם quality: "hd" (20 / 40 / 60).
• סרטון קומיקס בלי מגיש (format: "faceless"): 0.4 קרדיט לשנייה (4 / 8 / 12).
• עריכת סרטון שלכם: 10 קרדיטים לדקה, אחרי 60 שניות חינם (פעם אחת לחשבון). עד 3 דקות, עד 6 קטעים, עד 250MB לקטע.
• תמונה: 3 קרדיטים (באתר; endpoint לתמונות יגיע בהמשך).
• החיוב מתבצע ברגע יצירת העבודה. תסריט שלא אושר בזמן פג והקרדיטים חוזרים ליתרה, וכך גם בכישלון. רכישת קרדיטים נעשית באתר.

שרת MCP

כתובת: https://www.shottoai.com/mcp. תעבורה Streamable HTTP, JSON-RPC 2.0, הזדהות במפתח Bearer (בלי OAuth בשלב הזה). ב-ChatGPT חיבור MCP דורש OAuth, ולכן בינתיים עדיף GPT מותאם עם Actions מול ה-REST API.

claude mcp add --transport http shotto https://www.shottoai.com/mcp \
  --header "Authorization: Bearer sk_shotto_YOUR_KEY"

# ~/.zshrc או ~/.bashrc
export SHOTTO_API_KEY="sk_shotto_YOUR_KEY"

# ~/.codex/config.toml
[mcp_servers.shotto]
url = "https://www.shottoai.com/mcp"
bearer_token_env_var = "SHOTTO_API_KEY"

{
  "mcpServers": {
    "shotto": {
      "type": "http",
      "url": "https://www.shottoai.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_shotto_YOUR_KEY"
      }
    }
  }
}

הכלים

• shotto_balance

  יתרת הקרדיטים, השניות החינמיות לעריכה והמנוי

• shotto_presenters

  רשימת המגישים והמגישות (מזהה, שם, מגדר, תמונה)

• shotto_create_video

  יצירת סרטון UGC בעברית עם מגיש/ה או קומיקס. מחייב קרדיטים

• shotto_video_status

  סטטוס סרטון: התקדמות, התסריט, קישור לסרטון כשמוכן

• shotto_approve_video

  אישור התסריט (אפשר עם עריכה) כדי שהצילום יתחיל

• shotto_upload_url

  כתובת העלאה חתומה לקטע וידאו (MP4/MOV עד 250MB) לעריכה

• shotto_create_edit

  עריכת סרטון מהקטעים שהועלו. השניות החינמיות קודם, אחר כך 10 קרדיטים לדקה

• shotto_edit_status

  סטטוס עריכה וקישור לסרטון הערוך כשמוכן

• shotto_list_jobs

  הסרטונים והעריכות האחרונים

בדיקה ידנית:

curl -X POST https://www.shottoai.com/mcp \
  -H "Authorization: Bearer $SHOTTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"shotto_balance","arguments":{}}}'

Skills לסוכני AI

שרת ה-MCP נותן לסוכן את הכלים. ה-Skill מלמד אותו להשתמש בהם נכון: מה עולה כמה, איך כותבים בריף שמוציא תסריט טוב, ושלושה כללים שלא עוקפים: לא מוציאים קרדיטים בלי אישור מפורש שלכם על המחיר, לא מאשרים תסריט לפני שראיתם אותו, ולא מנסים שוב פעולה בתשלום. הקבצים באנגלית (סוכנים קוראים אותם טוב יותר), והסרטונים בעברית.

• /skills/shotto/SKILL.md · reference.md · shotto.zip
• לסוכנים שקוראים את האתר: /llms.txt ו-/llms-full.txt

mkdir -p ~/.claude/skills/shotto && \
  curl -s https://www.shottoai.com/skills/shotto/SKILL.md -o ~/.claude/skills/shotto/SKILL.md && \
  curl -s https://www.shottoai.com/skills/shotto/reference.md -o ~/.claude/skills/shotto/reference.md

# Codex: AGENTS.md at the repo root
curl -s https://www.shottoai.com/skills/shotto/reference.md >> AGENTS.md

# Cursor: a project rule
mkdir -p .cursor/rules && curl -s https://www.shottoai.com/skills/shotto/reference.md -o .cursor/rules/shotto.md

REST API

כתובת בסיס: https://www.shottoai.com/api/v1. כל התשובות JSON.

• GET /meיתרת קרדיטים, שניות עריכה חינם ומנוי
• GET /presenters?gender=female|maleרשימת המגישים (id, name, gender, thumbnail)
• POST /videosסרטון חדש. מחייב קרדיטים מיד
• GET /videos/{id}סטטוס, התקדמות, תסריט, video_url כשמוכן
• POST /videos/{id}/approveאישור התסריט (אפשר עם עריכה). בלי חיוב נוסף
• POST /uploadsכתובת העלאה חתומה לקטע וידאו לעריכה
• POST /editsעריכת הקטעים שהועלו. מחייב קרדיטים אחרי השניות החינמיות
• GET /edits/{id}סטטוס עריכה ו-video_url כשמוכן
• GET /jobs?limit=20הסרטונים והעריכות האחרונים

יצירת סרטון

שדות חובה: business_name, vertical, brief (10-600 תווים), target_seconds (10 / 20 / 30), ו-presenter_id או format: "faceless". אופציונלי: tone, cta_type (leads / whatsapp / website) עםwhatsapp או website, cta, presenter_gender (לקול של קומיקס), quality (regular ברירת מחדל, או hd ×2 קרדיטים; רק לסרטון עם מגיש/ה). התסריט נכתב אוטומטית; הצילום מתחיל רק אחרי אישור התסריט, בדיוק כמו באתר.

curl -X POST https://www.shottoai.com/api/v1/videos \
  -H "Authorization: Bearer $SHOTTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "סטודיו נועה",
    "vertical": "fitness",
    "brief": "סטודיו פילאטיס בתל אביב, שיעור ניסיון ראשון במתנה",
    "target_seconds": 20,
    "presenter_id": "<id from /presenters>",
    "tone": "energetic",
    "cta_type": "whatsapp",
    "whatsapp": "0501234567"
  }'

# 201
{ "id": "6f1c…", "status": "queued", "credits_charged": 20, "estimated_seconds": 420, "next_step": "…" }

# 1. poll until the script is ready
curl https://www.shottoai.com/api/v1/videos/6f1c… -H "Authorization: Bearer $SHOTTO_API_KEY"
# → { "status": "awaiting_approval", "script": { "hook": "…", "lines": ["…", "…"] }, … }

# 2. approve (optionally with an edited script, same number of lines)
curl -X POST https://www.shottoai.com/api/v1/videos/6f1c…/approve -H "Authorization: Bearer $SHOTTO_API_KEY"

# 3. poll until done
# → { "status": "done", "video_url": "https://…/final.mp4", … }

עריכת סרטון שלכם

ה-API לא מוריד קבצים מקישורים: קודם מבקשים כתובת העלאה, מעלים אליה ב-PUT (MP4 או MOV), ואז שולחים את path. אותו קטע לא מחויב פעמיים: בקשה חוזרת מחזירה את אותה עבודה עם "duplicate": true. עד 3 עריכות ב-10 דקות.

# 1. ask for an upload URL
curl -X POST https://www.shottoai.com/api/v1/uploads -H "Authorization: Bearer $SHOTTO_API_KEY" \
  -H "Content-Type: application/json" -d '{"type":"video/mp4","size":48211337,"filename":"clip.mp4"}'
# → { "path": "<uid>/uploads/<uuid>.mp4", "upload_url": "https://…", "method": "PUT", … }

# 2. upload the file
curl -X PUT -H "Content-Type: video/mp4" --data-binary @clip.mp4 "<upload_url>"

# 3. create the edit (seconds = total length of all clips)
curl -X POST https://www.shottoai.com/api/v1/edits -H "Authorization: Bearer $SHOTTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paths":["<uid>/uploads/<uuid>.mp4"],"seconds":42.5,"options":{"skin":"bold","captions":true,"music":true}}'
# → { "id": "…", "status": "approved", "credits_charged": 0, "trial_seconds_applied": 42, "duplicate": false }

שגיאות

תמיד { error: { code, message } }, ההודעה בעברית. קודים נפוצים: UNAUTHORIZED 401, VALIDATION / BAD_REQUEST 400,NO_CREDITS 402, NOT_FOUND 404, NOT_AWAITING 409, RATE_LIMIT 429, SERVER_ERROR 500.

HTTP/1.1 402
{ "error": { "code": "NO_CREDITS", "message": "אין מספיק קרדיטים לסרטון הזה" } }

שאלות? וואטסאפ · תנאי שימוש