ממשקי ה-API למפתחים עדיין נמצאים בגרסת בטא ועשויים להשתנות בכל עת. בשלב זה הם מתאימים יותר לבדיקות ולהתנסות אישיות, ועדיין אינם מומלצים לשימוש בסביבת ייצור.
סביבת ניסוי
זמינה דרך REST API ו-MCP. עיינו להלן בפרמטרים של הבקשה ובערכים המותרים.
POST /api/v1/grok-video-generator/submit → /queryהגישה ל-API זמינה למנויים בלבד. נקודות הזכות של המינוי משותפות לאתר ול-API.
הצגת מסלוליםפרמטר בקשה נדרש. השתמשו בסוג ובערכים המותרים המוצגים בטבלה.
פרמטר בקשה אופציונלי. השתמשו בסוג, בברירת המחדל ובערכים המותרים המוצגים בטבלה.
פרמטר בקשה אופציונלי. השתמשו בסוג, בברירת המחדל ובערכים המותרים המוצגים בטבלה.
פרמטר בקשה אופציונלי. השתמשו בסוג, בברירת המחדל ובערכים המותרים המוצגים בטבלה.
#!/usr/bin/env bash
set -euo pipefail
SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/grok-video-generator/submit" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw '{
"prompt": "A handheld documentary shot of street musicians performing in a busy evening plaza",
"duration": "6",
"aspectRatio": "16:9"
}')"
TASK_ID="$(printf '%s' "$SUBMIT_RESPONSE" | jq -er '.["taskId"]')"
while true; do
QUERY_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/grok-video-generator/query" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw "{\"taskId\":\"${TASK_ID}\"}")"
STATUS="$(printf '%s' "$QUERY_RESPONSE" | jq -r '(.status // .data.status // "") | ascii_downcase')"
case "$STATUS" in
success|succeeded|completed)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.result // .["videoUrl"] // .data["videoUrl"] // empty)'
break
;;
failed|error)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2
exit 1
;;
esac
sleep 5
done