Was macht KI-Video-Notizen?
Erstelle strukturierte Notizen aus Video-URLs mit der Baidu-KI. Unterstützt drei Notizformate.
Arbeitsablauf
- Aufgabe erstellen: Video-URL senden → Aufgaben-ID erhalten
- Status abfragen: Aufgabe alle 3-5 Sekunden abfragen, bis sie abgeschlossen ist
- Ergebnisse abrufen: Generierte Notizen abrufen, wenn Status = 10002
Statuscodes
| Code | Status | Aktion |
|---|---|---|
| 10000 | In Bearbeitung | Weiter abfragen |
| 10002 | Abgeschlossen | Ergebnisse zurückgeben |
| Andere | Fehlgeschlagen | Fehler anzeigen |
Notiztypen
| Typ | Beschreibung |
|---|---|
| 1 | Dokumentnotizen |
| 2 | Gliederungsnotizen |
| 3 | Grafiktextnotizen |
APIs
Aufgabe erstellen
Endpunkt: POST /v2/tools/ai_note/task_create
Parameter:
video_url(erforderlich): Öffentliche Video-URL
Beispiel:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
Antwort:
{
"task_id": "uuid-string"
}
Aufgabe abfragen
Endpunkt: GET /v2/tools/ai_note/query
Parameter:
task_id(erforderlich): Aufgaben-ID aus dem Create-Endpunkt
Beispiel:
python3 scripts/ai_notes_task_query.py "task-id-here"
Antwort (Abgeschlossen):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents": ["Notizinhalt..."]
}
]
}
Polling-Strategie
Option 1: Manuelles Polling
- Aufgabe erstellen →
task_idspeichern - Alle 3-5 Sekunden abfragen:
python3 scripts/ai_notes_task_query.py <task_id> - Fortschrittsaktualisierungen anzeigen:
- Status 10000: Verarbeitung...
- Status 10002: Abgeschlossen
- Nach 30-60 Sekunden stoppen (abhängig von der Videolänge)
Option 2: Automatisches Polling (Empfohlen)
Verwende das Polling-Skript für automatische Statusaktualisierungen:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
Beispiele:
# Standard: 20 Versuche, 3-Sekunden-Intervalle
python3 scripts/ai_notes_poll.py "task-id-here"
# Benutzerdefiniert: 30 Versuche, 5-Sekunden-Intervalle
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
Ausgabe:
- Zeigt Fortschritt in Echtzeit an:
[1/20] Verarbeitung... 25% - Stoppt automatisch bei Abschluss
- Gibt formatierte Notizen mit Typbezeichnungen zurück
Fehlerbehandlung
- Ungültige URL: „Video-URL nicht zugänglich“
- Verarbeitungsfehler: „Video konnte nicht analysiert werden“
- Zeitüberschreitung: „Video zu lang, versuche es später erneut“