MiniMax 官方视频

Was macht MiniMax 官方视频?

Verwenden Sie scripts/minimax_video.py dieser Fähigkeit, um direkt die offizielle MiniMax V2-Schnittstelle anzusteuern. Standardmäßig wird der chinesische Server https://api.minimax.cn verwendet, der internationale Server lautet https://api.minimax.io, das Standardmodell ist MiniMax-H3. Allgemein werden neue MiniMax-Aufgaben mit dieser Fähigkeit erstellt; „Nadotong“-Aufgaben müssen von der ursprünglichen Client-Anwendung fortgesetzt werden, die Aufgaben-ID wird nicht zwischen Diensten migriert.

Konfiguration

• Suchen Sie das Skript im tatsächlichen Installationsverzeichnis der Fähigkeit. Verwenden Sie vorzugsweise ~/.config/minimax/venv/bin/python; für reine Texteingabe, HTTPS- oder mm_file://-Eingaben wird nur Python 3.9+ benötigt. Lokale Materialüberprüfung und optionales R2 erfordern die Abhängigkeiten aus scripts/requirements.txt.
• Die Anmeldeinformationen werden aus MINIMAX_API_KEY gelesen, wobei Umgebungsvariablen Vorrang haben, andernfalls wird ~/.config/minimax/env analysiert. Es werden keine Chat-Anmeldeinformationen anderer Anwendungen gelesen, und der Schlüssel wird nicht in die Fähigkeit, die Befehlszeile oder den Aufgabenverlauf geschrieben. Informationen zu in- und ausländischen Servern sowie zur Werkzeugumgebung finden Sie unter Konfiguration und Wiederherstellung.
• Wenn der Schlüssel fehlt, konfigurieren Sie ihn auf dem Mac mit scripts/configure.py --region cn --gui in einem versteckten Eingabefeld; auf anderen Systemen im Terminal des Benutzers. Bitten Sie den Benutzer nicht, den Schlüssel in den Chat einzugeben. Benutzer mit vorhandenen Umgebungsvariablen können --from-env verwenden, zur Rotation --replace-key.
• doctor --check-api liest nur die letzten Aufgabenlisten, um Authentifizierung und V2-Abfrageschnittstelle zu überprüfen; es weist nicht auf Guthaben, Berechtigungen für bestimmte Modelle oder Ergebnisqualität hin. Installation, Konfiguration und Schnittstellenuntersuchung berechtigen nicht zur kostenpflichtigen Generierung.

Parameter und Eingabe

Wenn Sie Modelle, nicht standardmäßige Parameter oder multimodales Material auswählen, lesen Sie zuerst Offizielle Schnittstelle und Fähigkeiten und übernehmen Sie nicht die Modell-IDs, 720p/960p-Stufen oder 4–12-Sekunden-Limits von „Nadotong“.

• Standardmäßig wird H3, 4 Sekunden, 768P ausgegeben; reiner Text hat standardmäßig ein Seitenverhältnis von 16:9, das durch die eingegebenen Bilder des Start-/Endbildes bestimmt wird. Die vier H3-Modelle haben unterschiedliche Einschränkungen in Bezug auf Auflösung, Dauer und Referenzverhältnisse; der Client prüft gemäß den Modellspezifikationen.
• --first-frame und --last-frame jeweils maximal ein Bild; für multimodale Referenzen verwenden Sie wiederholbare --ref-image, --ref-video, --ref-audio. Start-/Endbilder können nicht mit multimodalen Referenzen gemischt werden. Behalten Sie die Materialreihenfolge bei und geben Sie Rollen wie „Referenzbild 1“ oder „Referenzvideo 1“ im Prompt klar an.
• Unterstützt werden lokale Dateien, HTTPS-URLs und mm_file://-Handler des aktuellen offiziellen Kontos. Lokale Eingaben werden zuerst als unveränderliche Kopie gespeichert und auf Format, Größe, Dauer usw. überprüft; die Mediengröße bei Remote-Eingaben wird offiziell bestätigt, es wird nicht behauptet, dass sie lokal geprüft wurde.
• Kleine lokale Materialien verwenden standardmäßig --delivery inline und werden im offiziellen data-URI-Format mit der Generierungsanforderung gesendet, ohne dass ein Drittanbieter gehostet werden muss. Die Gesamtgröße der Base64-Erweiterung darf 64 MB nicht überschreiten; bei lokalen MOV- oder größeren Materialien kann explizit --delivery r2 verwendet werden, gefolgt von der Ausführung von host. Es werden keine Dateien automatisch hochgeladen, transcodiert oder geändert, um Einschränkungen zu umgehen.
• Der R2-Modus verwendet nur den konfigurierten privaten Bucket, nutzt Objekte nach Hash wieder und überprüft anonyne Downloads. Vor dem Hochladen werden die Material- und Datenschutzvereinbarungen des Zielprojekts eingehalten; es wird nur im Rahmen der autorisierten Materialien der aktuellen Aufgabe gehostet. Bei Fehlschlagen der Konfiguration oder des Hostings wird gemeldet, es wird nicht automatisch der Bildhoster gewechselt.

Erstellung und Weiterverfolgung

Wenn der Benutzer die Videoerstellung anfordert, wird ein Kandidat erstellt; Batches und zusätzliche Versuche folgen den aktuellen Konventionen. Jeder Kandidat verwendet ein neues Aufgabenverzeichnis, vorzugsweise im projektingorierten tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/; wenn kein Projekt vorhanden ist, wird ein temporäres Verzeichnis im Arbeitsbereich oder ein vom Benutzer angegebener Speicherort verwendet, wobei alte Aufgaben nicht überschrieben werden.

1. Überprüfen Sie die Konfiguration mit doctor --check-api. Schreiben Sie Aktionen, Kamerafahrten, Rollen-/Objektbeschränkungen und Tonanforderungen in eine UTF-8-Promptdatei, frieren Sie Prompt, offizielle Parameter, Service-Region und Eingabekopien mit prepare ein. Dieser Schritt erfolgt offline, es wird kein Video generiert.
2. Führen Sie host nur aus, wenn --delivery r2 gesetzt ist und lokale Materialien vorhanden sind. Dieser Vorgang überträgt die Materialien in den privaten R2 und lässt MiniMax signierte Links verwenden; Inline-Materialien werden direkt an MiniMax übergeben.
3. Führen Sie submit einmal aus. Der Client speichert vor dem kostenpflichtigen POST exklusiv den Einreichungsdatensatz und den Anforderungshash; die offizielle Dokumentation verspricht keinen Idempotenzschlüssel, daher kann die lokale Anforderungs-UUID nicht als serverseitige Deduplizierungsgarantie angesehen werden.
4. Verwenden Sie separate status-Abfragen mit den Status queued / running / succeeded / failed / cancelled. Verwenden Sie einen unterbrechbaren Warte- und Fortschrittsmechanismus im Host, nicht mehrere Minuten Polling in einer langen Shell-Befehlskette.
5. Nach erfolgreichem Abschluss laden Sie mit download die MP4 herunter, überprüfen Sie sie und speichern Sie den Hash. Bei Fehlschlagen des Downloads wiederholen Sie nur status / download; abgelaufene Medien-URLs können durch erneutes Abfragen aktualisiert werden. Die offizielle API bietet nur Aufgaben der letzten 7 Tage, daher sollten Sie die Datei rechtzeitig speichern.
6. Zur Wiederherstellung über verschiedene Chats hinweg verwenden Sie zuerst inspect --job, dann status / download. Jede vorhandene submission.json verhindert eine erneute Einreichung. Timeouts, Verbindungsabbrüche, 5xx-Fehler oder fehlende ID sind unklar; bewahren Sie Beweise auf. Verwenden Sie bei Bedarf das schreibgeschützte tasks zur Überprüfung, aber ähnliche Modelle und Zeitpunkte beweisen nicht die Identität der Aufgabe. Erstellen Sie bei Fehlschlagen oder unklarem Ergebnis keine zusätzlichen kostenpflichtigen Kandidaten automatisch.

Befehlsbeispiel (Variablen stehen für tatsächliche absolute Pfade; JOB darf noch nicht existieren):

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --duration 4 --resolution 768P
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

Bei reinem Text lassen Sie --first-frame weg und geben Sie bei Bedarf --ratio an; Start-/Endbilder können mit --last-frame ergänzt werden. Für multimodale Referenzen verwenden Sie die entsprechenden --ref-*-Parameter. Im R2-Modus fügen Sie --delivery r2 zu prepare hinzu und führen vor submit host --job "$JOB" aus. Vollständige Optionen finden Sie mit --help des Skripts.

Auslieferung

Liefern Sie eine abspielbare lokale video.mp4 und das Aufgabenverzeichnis, zeigen Sie das Video mit absolutem Pfad an. Geben Sie das tatsächliche Modell, die Dauer, Auflösung, das Seitenverhältnis und die Tonqualität an, sowie ob die Originalgeschwindigkeit, Start-/Endbilder und Konsistenz der Charaktere geprüft wurden; HTTP-Erfolg bedeutet nicht automatisch visuelle Abnahme.

Der Aufgabenverlauf enthält den Prompt, Base64-Materialien, signierte URLs und die echte Aufgaben-ID und ist nur für den aktuellen Benutzer lesbar; er wird nicht vollständig in den Chat eingefügt oder in Git committet. Die Konsole zeigt den Aufgaben-Fingerprint; der offizielle API-Bearer wird nur an autorisierte offizielle API-Hosts gesendet, das fertige Video und alle Weiterleitungen werden anonym über HTTPS heruntergeladen.