Authentifizierung und Bildeingaben

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.

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 "[email protected]"

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.