ממשקי ה-API למפתחים עדיין נמצאים בגרסת בטא ועשויים להשתנות בכל עת. בשלב זה הם מתאימים יותר לבדיקות ולהתנסות אישיות, ועדיין אינם מומלצים לשימוש בסביבת ייצור.
סביבת ניסוי
זמינה דרך REST API ו-MCP. עיינו להלן בפרמטרים של הבקשה ובערכים המותרים.
POST /api/v1/nano-banana-ai-image-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/nano-banana-ai-image-generator/submit" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw '{
"prompt": "A playful corgi working as a barista in a bright modern cafe, detailed commercial illustration",
"aspectRatio": "1:1"
}')"
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/nano-banana-ai-image-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 // .["imageUrl"] // .data["imageUrl"] // empty)'
break
;;
failed|error)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2
exit 1
;;
esac
sleep 5
done