Authentifizierung und Bildeingaben
Halte API-Zugangsdaten serverseitig, wähle passende Berechtigungen und übertrage Bilder als Dateien, Base64 oder sichere öffentliche HTTPS-URLs.
Auf dieser Seite
Aus einer vertrauenswürdigen Umgebung authentifizieren
Nutze Authorization: Bearer <API_KEY> für öffentliche API-Anfragen. Schlüssel werden nur bei Erstellung unter Konto → Entwickler im Klartext angezeigt. Bewahre sie im Geheimnisspeicher auf, aktualisiere Clients vor Widerruf eines alten Schlüssels und protokolliere keine Anfrage-Header.
Ein verifiziertes AnimGen-Konto ist erforderlich. Registrierter Zugang beginnt mit 1 gleichzeitigem Auftrag, 3 Warteschlangenplätzen, 3 Erstellungen pro Minute und 60 anderen Anfragen pro Minute. Aktive Abonnements erhöhen diese kontoweiten Limits. GET /account liefert Stufe, Schlüsselberechtigungen und Limits; GET /credits/balance verfügbare Credits.
| API-Schlüsselberechtigung | Operationen |
|---|---|
animations:read |
Konto, Credits, Modelle, Auftragsabfragen/-listen und Asset-Abfrage |
animations:write |
Uploads, Kalkulationen, Auftragserstellung und Abbruchanforderungen |
MCP nutzt OAuth mit anderen, feineren Berechtigungen. Übertrage diese Tabelle nicht auf MCP.
Option A: einmal hochladen, Datei-ID wiederverwenden
curl --fail-with-body https://api.animgen.com/v1/files \
-H "Authorization: Bearer $ANIMGEN_API_KEY" \
-F "file=@character.png"
Die Antwort enthält id, MIME-Typ, Abmessungen, Byte-Größe und SHA-256. Verwende diese ID, keine Studio-uploadId, keinen Dateisystempfad oder internen Jobbezeichner:
{
"input": {
"first_frame": {
"type": "file",
"file_id": "00000000-0000-4000-8000-000000000001"
}
}
}
Die UUID ist ein Platzhalter. Uploads akzeptieren PNG, JPEG und WebP. Das Standard-Multipart-Limit beträgt 20 MB; zusätzlich werden decodierte Bilder und Abmessungen validiert. Behandle tatsächliche Limitfehler statt Dateinamen oder MIME-Deklaration zu vertrauen.
Option B: Inline-Base64
{
"type": "base64",
"media_type": "image/png",
"data": "<PURE_BASE64_IMAGE_BYTES>"
}
Verwende reines Base64 ohne Präfix data:image/...;base64,. Decodiert gelten 10 MB pro Bild und 20 MB über alle Inline-Bilder einer Anfrage. JSON/Base64 ist größer als die Rohdatei. Für größere oder wiederholte Bilder nutze wiederverwendbare Uploads.
Base64-Inhalte werden vor Annahme der Erstellung gespeichert. Behalte bei idempotenten Wiederholungen dieselben Bytes.
Option C: öffentliche HTTPS-URL
{
"type": "url",
"url": "https://your-public-image-host.example/character.png"
}
Ersetze den Beispielhost durch eine echte erreichbare Bild-URL. Der Server muss das Bild ohne deine Browser-Cookies abrufen können. Erlaubt ist öffentliches HTTPS auf Port 443 ohne eingebettete Zugangsdaten oder Fragmente. Private, Loopback- und Link-Local-Ziele werden blockiert; auch Weiterleitungsziele werden geprüft.
Halte die Bytes unter der URL während Kalkulation und Erstellung stabil. Nutze weder private Intranetadressen noch URLs mit Anmeldeseiten. Signierte Eingabe-URLs sind vertraulich und können ablaufen.
Zum gewählten Modell passen
Jede Generierung braucht ein Startbild. Endbild oder zusätzliche Referenzen sind nur bei Unterstützung des aktuellen Modells erlaubt. Das allgemeine Schema-Maximum überschreibt kein kleineres modellspezifisches Limit.
Nutze GET /models für gültige Modi und Einstellungen und kalkuliere die vollständige Anfrage vor Erstellung. Für transparente Quellen siehe transparente Animation, anschließend Schnellstart.
Videos als Bewegungsreferenz
Wähle ein Modell mit supports_reference_video=true und beachte reference_video. Erstelle mit filename, mime_type und byte_size eine Sitzung über POST /v1/video-uploads. Übertrage Bytes per PUT mit der zurückgegebenen URL und den Headern, ohne API-/OAuth-Zugangsdaten. POST /v1/video-uploads/{upload_id}/complete liefert eine file_id. Private MP4/MOV/WebM-Quellen sind auf 100 MiB und 2–30 Sekunden begrenzt. Eigene Video-Assets können mit source.type=asset und asset_id wiederverwendet werden. Video und Charakterbild müssen im selben Workspace liegen.
Übergebe die Referenz in input.reference_video für Video- oder Ein-Klick-Generierung. Wähle 2–5 Sekunden unter Beachtung niedrigerer Modellgrenzen. Start und Dauer werden kaufmännisch auf 1/24 Sekunde gerundet; Angebot und Generierung verwenden denselben Bereich. processing ist standardmäßig original und verwendet den ursprünglichen Ausschnitt einschließlich Erscheinungsbild und Effekten. Wähle bei Bedarf depth ausdrücklich; die Tiefenkonvertierung benötigt zusätzliche Zeit. Das Bild dient als Charakterreferenz, nicht als festes Startbild; last_frame ist ausgeschlossen. Das Videoangebot enthält dieselbe Auswahl ohne source in request.reference_video. Upload und Angebot starten keine Tiefenberechnung; nur wenn aktiviert, führt der Worker sie nach dem Generierungsauftrag aus.
{
"input": {
"first_frame": {
"type": "file",
"file_id": "00000000-0000-4000-8000-000000000001"
},
"reference_video": {
"source": {
"type": "file",
"file_id": "00000000-0000-4000-8000-000000000008"
},
"start_seconds": 1,
"duration_seconds": 2,
"processing": "original"
}
}
}
War diese Seite hilfreich?
Es werden keine Suchbegriffe, Codes oder Freitexte erfasst. Dieser Schalter steuert nur Dokumentationsinteraktionen; allgemeine Website-Analysen folgen der Datenschutzerklärung. Datenschutzerklärung