API beroperasi59 keupayaan

Beta

API Pembangun masih dalam peringkat beta dan boleh berubah pada bila-bila masa. Pada peringkat ini, API lebih sesuai untuk ujian dan percubaan peribadi dan belum disyorkan untuk kegunaan produksi.

Playground

Reka Bentuk Suara

Reka suara tersuai dengan AI - terangkan gaya suara yang anda mahukan dan jana pertuturan semula jadi daripada teks.

POST /api/v1/voice-design/submit → /query

Akses API hanya tersedia kepada pelanggan. Kredit langganan anda dikongsi antara laman web dan API.

Lihat pelan

Parameter

2 parameter

textContent*string

Parameter permintaan wajib. Ikuti jenis dan nilai yang diterima dalam jadual ini.

toneDescription*string

Parameter permintaan wajib. Ikuti jenis dan nilai yang diterima dalam jadual ini.

Kunci APIKunci API hanya digunakan dalam tab pelayar ini dan tidak disimpan secara setempat atau dihantar ke perkhidmatan lain.

Kod permintaan

#!/usr/bin/env bash
set -euo pipefail

SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/voice-design/submit" \
  -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "textContent": "Welcome to VidMage.",
  "toneDescription": "Warm, clear, and conversational."
}')"
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/voice-design/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 // .["audioUrl"] // .data["audioUrl"] // empty)'
      break
      ;;
    failed|error)
      printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2
      exit 1
      ;;
  esac
  sleep 5
done

#!/usr/bin/env bash set -euo pipefail SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/voice-design/submit" \ -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \ -H "Content-Type: application/json" \ --data-raw '{ "textContent": "Welcome to VidMage.", "toneDescription": "Warm, clear, and conversational." }')" 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/voice-design/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 // .["audioUrl"] // .data["audioUrl"] // empty)' break ;; failed|error) printf '%s' "$QUERY_RESPONSE" | jq -r '(.message // .error // .data.error // "Task failed")' >&2 exit 1 ;; esac sleep 5 done