> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tencent Video-Hochskalierung > - Tencent Video Upscale (tencent-video-upscale) verbessert vorhandene Videos und skaliert sie auf `720p`, `1080p`, `2k` oder `4k` hoch - Bietet 7 Optimierungsstile für Realaufnahmen, Animationen, kleine Gesichter in Fernaufnahmen, Gesichtstreue, stärkere Details und weichere Ergebnisse - Behält standardmäßig die ursprüngliche Bildrate bei (`model_params.max_fps: "source"`); mit `"30"`, `"60"` oder `"120"` lässt sich eine Obergrenze festlegen. Die Bildrate wird nur reduziert; es werden keine Zwischenbilder erzeugt - Abrechnung nach Videodauer. Preise für verschiedene Auflösungen und Ausgabebildraten finden Sie unter [EvoLink-Modellpreise](https://evolink.ai/models) - Asynchrone Verarbeitung: Verwenden Sie die zurückgegebene Aufgaben-ID, um den [Aufgabenstatus abzufragen](/de/api-manual/task-management/get-task-detail) - Aufgaben können nach dem Absenden nicht abgebrochen werden - Die URLs der optimierten Videos sind 24 Stunden gültig. Speichern Sie Ihr Video rechtzeitig ## OpenAPI ````yaml de/api-manual/video-series/tencent/tencent-video-upscale.json POST /v1/videos/generations openapi: 3.1.0 info: title: tencent-video-upscale Schnittstelle description: >- Videoqualität mit Tencent Video Upscale verbessern und auf 720p, 1080p, 2K oder 4K hochskalieren license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] tags: - name: Videogenerierung description: KI-Videogenerierung zugehörige APIs paths: /v1/videos/generations: post: tags: - Videogenerierung summary: tencent-video-upscale Schnittstelle description: >- - Tencent Video Upscale (tencent-video-upscale) verbessert vorhandene Videos und skaliert sie auf `720p`, `1080p`, `2k` oder `4k` hoch - Bietet 7 Optimierungsstile für Realaufnahmen, Animationen, kleine Gesichter in Fernaufnahmen, Gesichtstreue, stärkere Details und weichere Ergebnisse - Behält standardmäßig die ursprüngliche Bildrate bei (`model_params.max_fps: "source"`); mit `"30"`, `"60"` oder `"120"` lässt sich eine Obergrenze festlegen. Die Bildrate wird nur reduziert; es werden keine Zwischenbilder erzeugt - Abrechnung nach Videodauer. Preise für verschiedene Auflösungen und Ausgabebildraten finden Sie unter [EvoLink-Modellpreise](https://evolink.ai/models) - Asynchrone Verarbeitung: Verwenden Sie die zurückgegebene Aufgaben-ID, um den [Aufgabenstatus abzufragen](/de/api-manual/task-management/get-task-detail) - Aufgaben können nach dem Absenden nicht abgebrochen werden - Die URLs der optimierten Videos sind 24 Stunden gültig. Speichern Sie Ihr Video rechtzeitig operationId: createTencentVideoUpscaleTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: default_1080p: summary: >- Standard: allgemeiner realistischer Stil, 1080p, ursprüngliche Bildrate value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 explicit_defaults: summary: >- Entspricht dem obigen Beispiel, mit allen Standardwerten ausdrücklich angegeben value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: realistic quality: 1080p model_params: max_fps: source animation_4k: summary: Ein animiertes Video auf 4K optimieren value: model: tencent-video-upscale video_urls: - https://example.com/my-animation.mp4 mode: animation quality: 4k cap_frame_rate: summary: Ein Video mit hoher Bildrate auf 30 Bilder/s begrenzen value: model: tencent-video-upscale video_urls: - https://example.com/my-60fps-video.mp4 quality: 1080p model_params: max_fps: '30' with_callback: summary: Mit Callback-URL value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: face_fidelity quality: 2k callback_url: https://your-domain.com/webhooks/video-task-completed responses: '200': description: Aufgabe zur Videooptimierung erfolgreich erstellt content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_video: summary: Fehlende Video-URL value: error: code: invalid_parameter message: >- video_urls is required and must not be empty for tencent-video-upscale type: invalid_request_error invalid_mode: summary: Ungültiger Optimierungsstil value: error: code: invalid_parameter message: >- invalid mode "general" for tencent-video-upscale; supported: realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft type: invalid_request_error invalid_max_fps: summary: Ungültige Obergrenze der Bildrate value: error: code: invalid_parameter message: >- invalid model_params.max_fps auto for tencent-video-upscale; supported: "source", 30, 60, 120 type: invalid_request_error too_long: summary: Video ist länger als 60 Sekunden value: error: code: invalid_parameter message: video duration 75.2s exceeds the 60s limit type: invalid_request_error source_too_large: summary: Quellvideo überschreitet 4K value: error: code: invalid_parameter message: >- source video resolution exceeds 4K (short side 2880px > 2160px) type: invalid_request_error target_too_low: summary: Zielauflösung ist niedriger als die Quellauflösung value: error: code: invalid_parameter message: >- target quality 720p is lower than the source video (short side 1080px); choose a higher quality type: invalid_request_error top_level_fps: summary: Der Parameter fps auf oberster Ebene wird nicht unterstützt value: error: code: invalid_parameter message: >- fps is not supported for tencent-video-upscale; use model_params.max_fps (30, 60 or 120) to cap the output frame rate type: invalid_request_error probe_failed: summary: Videometadaten konnten nicht gelesen werden value: error: code: video_probe_failed message: >- Failed to read the video's duration, resolution and frame rate. Please provide a publicly downloadable MP4 or MOV video URL type: invalid_request_error '401': description: Nicht autorisiert, ungültiges oder abgelaufenes Token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Unzureichendes Kontingent, Aufladung erforderlich content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Zugriff verweigert content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: tencent-video-upscale' type: invalid_request_error '429': description: Ratenlimit überschritten content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: >- Dienst vorübergehend nicht verfügbar. Versuchen Sie es später erneut oder kontaktieren Sie den Support content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: VideoGenerationRequest: type: object required: - model - video_urls properties: model: type: string description: Name des Modells zur Video-Hochskalierung enum: - tencent-video-upscale default: tencent-video-upscale example: tencent-video-upscale video_urls: type: array description: >- Liste der Eingabevideo-URLs **Hinweise:** - Pro Anfrage wird nur `1` Video unterstützt (bei mehreren Videos wird nur das erste verwendet) - Die Video-URL muss für den Server direkt erreichbar sein (öffentliche oder vorsignierte URL) - Unterstützte Formate: `.mp4`, `.mov` - Maximale Dauer: `60` Sekunden - Maximale Quellauflösung: 4K (kurze Seite höchstens `2160` Pixel) - Beim Absenden liest der Server Dauer, Auflösung und Bildrate des Videos. Schlägt dies fehl, wird `video_probe_failed` zurückgegeben items: type: string format: uri minItems: 1 maxItems: 1 example: - https://example.com/my-video.mp4 mode: type: string description: >- Optimierungsstil. Wählen Sie passend zum Videoinhalt **Optionen:** - `realistic` - Allgemein realistisch: Realaufnahmen und andere typische Szenen — **Standard** - `realistic_distant` - Realistisch, Fernaufnahmen: für kleine Gesichter in Fernaufnahmen optimiert - `animation` - Allgemeine Animation: Animationen, Anime und Zeichentrick - `animation_distant` - Animation, Fernaufnahmen: für kleine Gesichter in animierten Szenen mit entfernten Figuren optimiert - `face_fidelity` - Gesichtstreue: bewahrt die ursprünglichen Gesichtszüge möglichst genau - `detail_boost` - Detailverstärkung: hebt Texturen und Kanten hervor - `soft` - Weich: geringere Schärfung für ein natürlicheres Erscheinungsbild Groß- und Kleinschreibung werden nicht unterschieden. Ungültige Werte werden abgelehnt enum: - realistic - realistic_distant - animation - animation_distant - face_fidelity - detail_boost - soft default: realistic example: realistic quality: type: string description: >- Zielauflösung, gemessen an der kurzen Seite des Videos **Optionen:** - `720p` - Kurze Seite mit `720` Pixeln - `1080p` - Kurze Seite mit `1080` Pixeln — **Standard** - `2k` - Kurze Seite mit `1440` Pixeln - `4k` - Kurze Seite mit `2160` Pixeln **Hinweise:** - Die Zielauflösung darf nicht niedriger als die Quellauflösung sein. Bei einer `1080p`-Quelle sind beispielsweise `1080p`, `2k` und `4k` möglich; `720p` wird abgelehnt - Die niedrigste Stufe, die mindestens der Quellauflösung entspricht, lässt die Bildgröße weitgehend unverändert enum: - 720p - 1080p - 2k - 4k default: 1080p example: 1080p model_params: type: object description: Modellspezifische Parameter properties: max_fps: type: string description: >- Maximale Bildrate des Ausgabevideos. Standardmäßig `"source"`: Die ursprüngliche Bildrate bleibt erhalten. Das Weglassen entspricht `"source"` **Optionen:** - `"source"` - Ursprüngliche Bildrate beibehalten — **Standard** - `"30"` - Ausgabebildrate höchstens 30 Bilder/s - `"60"` - Ausgabebildrate höchstens 60 Bilder/s - `"120"` - Ausgabebildrate höchstens 120 Bilder/s **Verhalten:** - Liegt die ursprüngliche Bildrate innerhalb der Obergrenze, bleibt sie erhalten; **es werden keine Zwischenbilder erzeugt**. Höhere Bildraten werden auf die Obergrenze reduziert - Bei `"source"` oder ohne Angabe werden ursprüngliche Bildraten über `120` Bilder/s dennoch auf `120` Bilder/s reduziert **Akzeptierte Typen:** - Zeichenfolgen werden empfohlen. Auch die Ganzzahlen `30`, `60` und `120` werden akzeptiert (zum Beispiel sind `"60"` und `60` gleichwertig) - Bei `"source"` wird die Groß- und Kleinschreibung nicht unterschieden - Andere Werte (wie `45`, `60.5` oder `"auto"`) werden abgelehnt - Dieses Modell akzeptiert den Parameter `fps` auf oberster Ebene nicht enum: - source - '30' - '60' - '120' default: source example: '30' callback_url: type: string description: >- HTTPS-Callback-Adresse nach Aufgabenabschluss **Callback-Zeitpunkt:** - Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde - Wird nach Abschluss der Abrechnungsbestätigung gesendet **Sicherheitsbeschränkungen:** - Nur HTTPS-Protokoll wird unterstützt - Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.) - URL-Länge darf `2048` Zeichen nicht überschreiten **Callback-Mechanismus:** - Timeout: `10` Sekunden - Maximal `3` Wiederholungsversuche bei Fehler (Wiederholung nach `1` Sekunde/`2` Sekunden/`4` Sekunden) - Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API - Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1757169743 id: type: string description: Aufgaben-ID example: task-unified-1757169743-7cvnl5zw model: type: string description: Tatsächlich verwendeter Modellname example: tencent-video-upscale object: type: string enum: - video.generation.task description: Aufgabentyp progress: type: integer description: Aufgabenfortschritt in Prozent (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Aufgabenstatus enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Detaillierte Informationen zur Videoaufgabe type: type: string enum: - text - image - audio - video description: Aufgaben-Ausgabetyp example: video usage: $ref: '#/components/schemas/VideoUsage' description: Nutzungs- und Abrechnungsinformationen ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Fehlercode-Bezeichner message: type: string description: Fehlerbeschreibung type: type: string description: Fehlertyp VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Ob die Aufgabe abgebrochen werden kann (Aufgaben dieses Modells können nach dem Absenden nicht abgebrochen werden) example: false estimated_time: type: integer description: >- Geschätzte Fertigstellungszeit in Sekunden. Die tatsächliche Zeit hängt von der Warteschlange ab; 4K, hohe Bildraten und lange Videos benötigen deutlich mehr Zeit minimum: 0 example: 120 video_duration: type: integer description: Videodauer (Sekunden) example: 0 VideoUsage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: >- Abrechnungsregel. Dieses Modell wird nach Videodauer mit `per_second` abgerechnet. Die tatsächlichen Preise finden Sie unter [EvoLink-Modellpreise](https://evolink.ai/models) enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: >- Geschätzter Credit-Verbrauch (Vorautorisierung). Der endgültige Verbrauch wird nach Abschluss der Aufgabe abgerechnet; maßgeblich ist Ihre Abrechnung minimum: 0 example: 3.264 user_group: type: string description: Benutzergruppenkategorie example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Alle APIs erfordern Bearer-Token-Authentifizierung## **API-Schlüssel erhalten:** Besuchen Sie die [API-Schlüsselverwaltungsseite](https://evolink.ai/dashboard/keys), um Ihren API-Schlüssel zu erhalten **Zum Anfrage-Header hinzufügen:** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.