API betriebsbereit59 Funktionen

Beta

Die Entwickler-APIs befinden sich weiterhin in der Beta-Phase und können jederzeit geändert werden. Derzeit eignen sie sich eher für persönliche Tests und Experimente und werden noch nicht für den Produktionseinsatz empfohlen.

Playground

KI-Text zu Musik

Über REST API und MCP verfügbar. Beachte die folgenden Anfrageparameter und zulässigen Werte.

POST /api/v1/text-to-music/submit → /query

Der API-Zugriff ist Abonnenten vorbehalten. Website und API verwenden dasselbe Guthaben deines Abonnements.

Tarife ansehen

Parameter

3 Parameter

description*string

Erforderlicher Anfrageparameter. Beachte Typ und zulässige Werte in dieser Tabelle.

titleOptionalstring

Optionaler Anfrageparameter. Beachte Typ, Standardwert und zulässige Werte in dieser Tabelle.

makeInstrumentalOptionalboolean

Optionaler Anfrageparameter. Beachte Typ, Standardwert und zulässige Werte in dieser Tabelle.

Standard: false

API-SchlüsselDer API-Schlüssel wird nur in diesem Browser-Tab verwendet und weder lokal gespeichert noch an andere Dienste gesendet.

Anfragecode

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

SUBMIT_RESPONSE="$(curl --fail-with-body --silent --show-error -X POST "https://vidmage.ai/api/v1/text-to-music/submit" \
  -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "description": "ambient electronic music for a calm evening",
  "makeInstrumental": false
}')"
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/text-to-music/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/text-to-music/submit" \ -H "Authorization: Bearer ${VIDMAGE_API_KEY}" \ -H "Content-Type: application/json" \ --data-raw '{ "description": "ambient electronic music for a calm evening", "makeInstrumental": false }')" 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/text-to-music/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