> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Suno Persona Erstellung Beta > - Extrahiert wiederverwendbare Personas (Gesangs-/Stilmerkmale) aus abgeschlossenen Suno-Musikgenerierungsaufgaben - Nach erfolgreicher Erstellung wird eine `persona_id` zurückgegeben, die in nachfolgenden [Suno Musikgenerierungen](/de/api-manual/audio-series/suno/suno-music-generation) über die Parameter `persona_id` und `persona_model` angewendet werden kann - Die Modellversion der Quellaufgabe muss **suno-v4 oder höher** sein (v3.5 wird nicht unterstützt) - Pro Song (result_id) kann **nur eine Persona** erstellt werden - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Statusabfragen](/de/api-manual/task-management/get-task-detail) - Aus Persona-Aufgaben können keine neuen Personas erstellt werden ## OpenAPI ````yaml de/api-manual/audio-series/suno/suno-persona-creation.json POST /v1/audios/generations openapi: 3.1.0 info: title: Suno Persona Erstellungs-API description: >- Wiederverwendbare Musikstile (Persona) aus abgeschlossenen Suno-Musikgenerierungsaufgaben extrahieren, um konsistente Gesangs- und Stilmerkmale in nachfolgenden Musikgenerierungen beizubehalten license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Produktionsumgebung security: - bearerAuth: [] paths: /v1/audios/generations: post: tags: - Audio Generation summary: Suno Persona Erstellungs-API description: >- - Extrahiert wiederverwendbare Personas (Gesangs-/Stilmerkmale) aus abgeschlossenen Suno-Musikgenerierungsaufgaben - Nach erfolgreicher Erstellung wird eine `persona_id` zurückgegeben, die in nachfolgenden [Suno Musikgenerierungen](/de/api-manual/audio-series/suno/suno-music-generation) über die Parameter `persona_id` und `persona_model` angewendet werden kann - Die Modellversion der Quellaufgabe muss **suno-v4 oder höher** sein (v3.5 wird nicht unterstützt) - Pro Song (result_id) kann **nur eine Persona** erstellt werden - Asynchroner Verarbeitungsmodus, verwenden Sie die zurückgegebene Aufgaben-ID zum [Statusabfragen](/de/api-manual/task-management/get-task-detail) - Aus Persona-Aufgaben können keine neuen Personas erstellt werden operationId: createSunoPersona requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SunoPersonaCreationRequest' examples: basic: summary: Grundlegende Erstellung (Pflichtparameter) value: model: suno-persona model_params: source_task_id: task-unified-1774169216-ocqaqde7 result_id: 4fcc4507-a7ae-4441-ad8a-465c2f61d5bb name: Electronic Pop Singer description: >- Modern electronic style with energetic beats and synthesizer tones for dance music with_vocal_range: summary: Mit Gesangsextraktionsfenster value: model: suno-persona model_params: source_task_id: task-unified-1774169216-ocqaqde7 result_id: 4fcc4507-a7ae-4441-ad8a-465c2f61d5bb name: Jazz Vocalist description: >- Smooth jazz vocal style with warm tones and improvisational flair suitable for lounge music vocal_start: 15 vocal_end: 35 style: jazz responses: '200': description: Persona-Erstellungsaufgabe erfolgreich übermittelt content: application/json: schema: $ref: '#/components/schemas/AudioGenerationResponse' '400': description: Ungültige Anfrageparameter content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_params: summary: Fehlende Pflichtparameter value: error: code: invalid_request message: model_params.source_task_id is required type: invalid_request_error invalid_source: summary: Ungültige Quellaufgabe value: error: code: invalid_request message: >- Quellaufgabe existiert nicht oder gehört nicht dem aktuellen Benutzer: task-unified-xxx type: invalid_request_error vocal_window: summary: Ungültiges Gesangsfenster value: error: code: invalid_request message: >- vocal_end - vocal_start must be between 10 and 30 seconds 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 '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 components: schemas: SunoPersonaCreationRequest: type: object required: - model - model_params properties: model: type: string description: Modellname, fest als `suno-persona` enum: - suno-persona example: suno-persona model_params: type: object description: Persona-Erstellungsparameter required: - source_task_id - result_id - name - description properties: source_task_id: type: string description: >- Task-ID der abgeschlossenen Suno-Musikgenerierungsaufgabe **Bezugsquelle:** Das `id`-Feld aus der Musikgenerierungsantwort **Anforderungen:** 1. Die Aufgabe muss dem aktuellen Benutzer gehören 2. Der Aufgabenstatus muss `completed` sein 3. Das Aufgabenmodell muss aus der Suno-Serie sein (suno-v4 oder höher) 4. Darf keine `suno-persona`-Aufgabe sein example: task-unified-1774169216-ocqaqde7 result_id: type: string description: >- Eindeutiger Bezeichner des Zielsongs aus den Quellaufgaben-Ergebnissen **Bezugsquelle:** Über die [Aufgabendetails-Abfrage](/de/api-manual/task-management/get-task-detail)-Schnittstelle, im Array `result_data.songs[]` die `result_id` des Zielsongs finden **Einschränkung:** Pro `result_id` kann nur eine Persona erstellt werden, doppelte Erstellung gibt einen Fehler zurück format: uuid example: 4fcc4507-a7ae-4441-ad8a-465c2f61d5bb name: type: string description: Persona-Name, zur Identifizierung und späteren Referenzierung example: Electronic Pop Singer description: type: string description: Beschreibung des Musikstils der Persona example: >- Modern electronic style with energetic beats and synthesizer tones for dance music vocal_start: type: number description: >- Startzeitpunkt der Gesangsextraktion (Sekunden) Muss zusammen mit `vocal_end` angegeben werden, nicht einzeln verwendbar. Wert muss >= 0 sein. Das Extraktionsfenster (`vocal_end - vocal_start`) muss zwischen **10 - 30 Sekunden** liegen minimum: 0 example: 10 vocal_end: type: number description: >- Endzeitpunkt der Gesangsextraktion (Sekunden) Muss zusammen mit `vocal_start` angegeben werden, Wert muss strikt größer als `vocal_start` sein. Das Extraktionsfenster (`vocal_end - vocal_start`) muss zwischen **10 - 30 Sekunden** liegen minimum: 0 example: 30 style: type: string description: >- Stil-Tags zur Kennzeichnung des Musikstils der Persona. Freitext, kein vorgeschriebenes Format, leere Zeichenketten werden ignoriert example: electronic pop AudioGenerationResponse: type: object properties: created: type: integer description: Zeitstempel der Aufgabenerstellung example: 1774170584 id: type: string description: >- Aufgaben-ID, wird zur Abfrage des Aufgabenstatus und der Ergebnisse verwendet example: task-unified-1774170584-su75smg7 model: type: string description: Tatsächlich verwendeter Modellname example: suno-persona object: type: string enum: - audio.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/AudioTaskInfo' description: Audio-Aufgabendetails type: type: string enum: - audio description: Aufgaben-Ausgabetyp example: audio usage: $ref: '#/components/schemas/Usage' 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 AudioTaskInfo: type: object properties: can_cancel: type: boolean description: Ob die Aufgabe abgebrochen werden kann example: false estimated_time: type: integer description: Geschätzte Fertigstellungszeit (Sekunden) example: 15 Usage: type: object description: Nutzungs- und Abrechnungsinformationen properties: billing_rule: type: string description: Abrechnungsregel enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Geschätzter Guthabenverbrauch minimum: 0 example: 1 user_group: type: string description: Benutzergruppenkategorie enum: - default - vip 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 ``` ````