ממשקי ה-API למפתחים עדיין נמצאים בגרסת בטא ועשויים להשתנות בכל עת. בשלב זה הם מתאימים יותר לבדיקות ולהתנסות אישיות, ועדיין אינם מומלצים לשימוש בסביבת ייצור.
סביבת ניסוי
צור מודלי 3D להורדה מהנחיות טקסט.
POST /api/v1/ai-text-to-3d-model/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/ai-text-to-3d-model/submit" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw '{
"prompt": "A stylized low-poly camping lantern with a metal handle, glass chamber, and production-ready proportions"
}')"
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/ai-text-to-3d-model/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 // .["modelUrl"] // .data["modelUrl"] // empty)'
break
;;
failed|error)
printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2
exit 1
;;
esac
sleep 5
done