Source: https://ailoot.ai/docs/de-at/api/video-music/
Canonical: https://ailoot.ai/docs/de-at/api/video-music/
Language: de-at

[API](https://ailoot.ai/docs/de-at/) 

# Video und Musik

[Markdown](https://ailoot.ai/docs/de-at/api/video-music/index.md)

Videos und Musik generieren: Der Request erstellt einen Auftrag, dessen Ergebnis über die zugehörige ID abgerufen wird.

POST`https://api.ailoot.ai/v1/videos`

Video und Musik

```bash
# Bewahren Sie die Request ID auf: Der Support findet damit Ihre Anfrage.
# Erstellen Sie den Auftrag einmal; die folgende Schleife fragt nur seinen Status ab.
curl --fail-with-body --max-time 120 -D video-create-headers-v1.txt \
  https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"ein ruhiger See","seconds":"8","size":"1280x720"}' \
  -o video-create-v1.json || exit 1
VIDEO_ID=$(jq -er '.id // .request_id' video-create-v1.json) || exit 1
VIDEO_STATUS=""
# Diese Schleife fragt nur den ursprünglichen Auftrag ab. Sie sendet die Anfrage zur Erstellung nie erneut.
for ATTEMPT in $(seq 1 60); do
  curl --fail-with-body --max-time 30 \
    "https://api.ailoot.ai/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $AILOOT_API_KEY" \
    -o video-status-v1.json || exit 1
  VIDEO_STATUS=$(jq -r '.status // empty' video-status-v1.json)
  # result_pending_check: true (Status bleibt in_progress): Das Ergebnis wird geprüft. Stoppen Sie; erstellen Sie den Auftrag keinesfalls erneut.
  if jq -e '.result_pending_check == true' video-status-v1.json >/dev/null; then
    cat video-status-v1.json
    echo "The result is being checked. Do not create the job again: check GET /v1/videos/$VIDEO_ID later or contact support with the Request ID." >&2
    exit 1
  fi
  case "$VIDEO_STATUS" in
    done|completed) break ;;
    queued|in_progress|pending|processing) sleep 5 ;;
    # failed oder jeder andere Status: anzeigen und stoppen. Den Auftrag keinesfalls erneut erstellen.
    *) cat video-status-v1.json; exit 1 ;;
  esac
done
case "$VIDEO_STATUS" in
  done|completed) ;;
  *) echo "The job is not finished yet (status: ${VIDEO_STATUS:-none}). Check it later: GET /v1/videos/$VIDEO_ID" >&2; exit 1 ;;
esac
curl --fail-with-body --max-time 120 -L --max-redirs 3 \
  "https://api.ailoot.ai/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video-v1.mp4
# Prüfen Sie nach einer Zeitüberschreitung beim Erstellen zuerst die Request ID in Ihrem Nutzungsverlauf, bevor Sie dieses Skript erneut ausführen.
```

```bash
curl https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/lyria", "prompt": "Ruhiges Klavier und Violoncello, ohne Gesang"}' 
```

Antwort · gekürzt

```json
// Die Auftrags-ID steht im Feld id oder request_id
{ "id": "…", … }

// Das Format hängt vom Modell ab: Übernehmen Sie die ID
// unverändert aus der Antwort auf die Erstellung.
```

## Authentifizierung

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `Authorization` | header | erforderlich | Schlüssel in der Form `Bearer sk-…`. Alternativ akzeptiert Ailoot die Header `x-api-key` oder `x-goog-api-key`. |

## Video: Request-Body

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `model` | string | erforderlich | Videomodell: `google/omni-1.1-flash`, `grok-imagine-video`, `happyhorse-1.1-t2v`, `MiniMax-Hailuo-2.3`, `grok-imagine-video-1.5`, `happyhorse-1.1-r2v`, `grok-imagine-video-1.5-preview`, `happyhorse-1.1-i2v`. |
| `prompt` | string | erforderlich | Beschreibung des Videos. |
| `duration / seconds` | integer / string | optional | Abhängig von der Modellfamilie: Grok 1–15 Sekunden, MiniMax 6/10 bei 768P oder 6 bei 1080P, HappyHorse 3–15; Google Omni 4/6/8/10. Übertragen Sie Felder einer Modellfamilie nicht auf eine andere. |
| `resolution / size` | string | optional | Grok: 480p/720p/1080p (1080p bei video-1.5), alternativ size 1280x720/720x1280/1920x1080/1080x1920. MiniMax: 768P/1080P. HappyHorse: 480P/720P/1080P. Google Omni: 360p/720p. |
| `image / first_frame_image / image_urls` | string / array | optional | Die Felder für Ausgangsbilder hängen von Modellfamilie und Modus ab. MiniMax Fast erfordert first\_frame\_image. HappyHorse t2v — ohne images, i2v — genau ein Bild ohne ratio, r2v — 1–9 Bilder. |

Die Antwort enthält die Auftrags-ID (Feld `id` oder `request_id`). Verwenden Sie sie unverändert, ohne sie zu zerlegen: Das Format hängt vom Modell ab. Status und fertige Datei:

GET`https://api.ailoot.ai/v1/videos/{id}`

GET`https://api.ailoot.ai/v1/videos/{id}/content`

Dieselben Adressen funktionieren auch mit dem Präfix `/v1/videos/generations/{id}`. Der Status eines fertigen Auftrags und die Antwortfelder hängen vom Modell ab — orientieren Sie sich am Statusfeld und verwenden Sie für den Dateidownload `/content`.

## Erstellen → Status → Herunterladen

Speichern Sie die Antwort auf die Erstellung samt Request ID. Bei MiniMax/HappyHorse ist der Fertigstatus `status: completed`, die Antwort enthält `content_url`, `data[]` und usage. Bei Grok — `status: done` mit `video.url`. Google Omni liefert 202 queued, danach in\_progress mit Retry-After, completed oder partial/content\_revoked. Nicht jede 200-Antwort bedeutet ein fertiges Video. Enthält die Statusantwort `result_pending_check: true` (`status` bleibt `in_progress`), wird das Ergebnis noch geprüft. Erstellen Sie den Auftrag nicht erneut — prüfen Sie ihn später über GET /v1/videos/{id} oder kontaktieren Sie den Support mit der Request ID.

`/content` kann MP4 direkt oder eine Weiterleitung zu einer signierten Datei liefern. Enthält die Antwort mehrere Ergebnisse in `data[]`, speichern Sie jedes davon: Alle ausgelieferten Ergebnisse werden verrechnet. Ein Videoauftrag lässt sich über die API weder stornieren noch löschen. Das Löschen der fertigen Datei sperrt den Zugriff darauf, storniert aber nicht die Generierung.

Abgerechnet werden die Sekunden des fertigen Videos in der gewählten Auflösung oder das Video als Ganzes, wie im Katalog angegeben. Die vollen Kosten werden beim Erstellen des Auftrags reserviert.

## Musik

POST`https://api.ailoot.ai/v1/music/generations`

| Parameter | Typ | Erforderlich | Beschreibung |
| --- | --- | --- | --- |
| `model` | string | erforderlich | `google/lyria`, `google/lyria-3-clip-preview`. |
| `prompt` | string | erforderlich | Beschreibung des Musikstücks: Genre, Instrumente, Stimmung. |

In der Antwort enthält das Feld `data[]` die Links zu den fertigen Clips. Ein Request kann mehrere Clips liefern; jeder ausgelieferte Clip wird verrechnet.

Senden Sie einen Video- oder Musikrequest nach einem Verbindungsabbruch nicht erneut: Der Auftrag könnte bereits gestartet sein. Prüfen Sie zuerst den Status anhand der ID oder kontaktieren Sie den Support mit der Request ID.

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung — wir helfen Ihnen weiter.[Support kontaktieren](mailto:support@ailoot.ai)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.