لا تزال واجهات API للمطورين في المرحلة التجريبية وقد تتغير في أي وقت. في الوقت الحالي، هي أنسب للاختبار والتجربة الشخصية ولا يُنصح بعد باستخدامها في بيئات الإنتاج.
ساحة التجربة
متاحة عبر REST API وMCP. راجع معاملات الطلب والقيم المقبولة أدناه.
POST /api/v1/gpt-image-2-5-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/gpt-image-2-5-generator/submit" \
-H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
-H "Content-Type: application/json" \
--data-raw '{
"prompt": "A refined botanical poster with a sage ceramic vase, fern fronds, and the exact headline FERN in dark green type on ivory paper",
"aspectRatio": "16:9",
"resolution": "1k"
}')"
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/gpt-image-2-5-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