Bild hochladen
Generierte Referenz für POST /files: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
POST /files
operationId: create_file_v1_files_post
Lädt PNG, JPEG oder WebP als multipart file hoch und gibt eine wiederverwendbare öffentliche Datei-ID zurück. Bildbytes und Abmessungen werden geprüft; die Generierung startet nicht. Uploads sind keine idempotenten kostenpflichtigen Erstellungen: Wiederhole sie nach einem Übertragungsfehler nicht ungeprüft.
Authentifizierung und Nebenwirkungen
Verwende einen serverseitigen Bearer-API-Schlüssel. Erforderliche Berechtigung: animations:write
Diese Operation startet keine kostenpflichtige Generierung. Andere Zustandsänderungen sind oben beschrieben.
Parameter
Keine Pfad-, Query- oder operationsspezifischen Header-Parameter.
Anfragetext (multipart/form-data)
Anfragetext erforderlich: true
| Feld | Typ | Erforderlich | Standardwert | Einschränkungen | Bedeutung |
|---|---|---|---|---|---|
file |
string |
Ja | — | format: binary |
PNG, JPEG, or WebP image bytes; validated before returning a public file ID. |
Vollständiges verschachteltes Schema: Body_create_file_v1_files_post
Antworten
| HTTP | Inhalt | Bedeutung |
|---|---|---|
201 |
FileResponse | Successful public response. Example values are illustrative. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
401 |
APIErrorEnvelope | Missing, expired, or revoked API key. |
403 |
APIErrorEnvelope | Account eligibility, account status, or key scope does not allow this operation. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
413 |
APIErrorEnvelope | Request or decoded image exceeds the configured limit. |
415 |
APIErrorEnvelope | Use supported image media types. |
422 |
APIErrorEnvelope | Decoded image dimensions exceed the allowed size. |
429 |
APIErrorEnvelope | Account-wide rate or queue limit; wait for Retry-After. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
Antwort-Header
| HTTP | Header | Typ | Bedeutung |
|---|---|---|---|
429 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
503 |
Retry-After |
integer |
Suggested wait in seconds; respect the server value and an overall deadline. |
Beispielantwort
{
"byte_size": 1024,
"created_at": "2026-08-30T00:00:00Z",
"height": 512,
"id": "00000000-0000-4000-8000-000000000001",
"mime_type": "image/png",
"object": "file",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"width": 512
}
Weiterführende Anleitungen
Statusabfragen und Downloads · Fehler und sichere Wiederholungen
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