> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Suno New Persona > Use DeerAPI to call the Suno New Persona endpoint with request details, response details, examples, and an OpenAPI playground. ## Overview Use this endpoint to call the Suno New Persona workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint. ## Before you start Use the DeerAPI base URL and pass your API Key in the `Authorization` header: ```text theme={null} https://api.deerapi.com ``` ```text theme={null} Authorization: Bearer $DEERAPI_KEY ``` ## Model selection Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first. ## Implementation notes * Use the OpenAPI playground for the exact request fields accepted by this endpoint. * Keep API Keys on the server side when you build production applications. * Log the request ID from failed calls so support can investigate the request. * Retry `429`, `500`, and `503` responses with exponential backoff. ## OpenAPI ````yaml /api/openapi/music/suno/post-new-persona.openapi.json POST /suno/persona/create openapi: 3.1.0 info: title: Create Persona API version: 1.0.0 servers: - url: https://api.deerapi.com security: - bearerAuth: [] paths: /suno/persona/create: post: summary: Create persona operationId: create_persona requestBody: required: true content: application/json: schema: type: object required: - root_clip_id - name - description - clips - is_public properties: root_clip_id: type: string default: example name: type: string default: example description: type: string default: example clips: type: array items: type: string default: - example is_public: type: boolean default: true default: root_clip_id: example name: example description: example clips: - example is_public: true examples: Default: summary: Default value: root_clip_id: 82294225-6537-4dfc-adcd-be3b5edaa46c name: Persona Title description: Persona description clips: - 54834687-5e79-4f08-8e14-cf188f15b598 is_public: true example: root_clip_id: 82294225-6537-4dfc-adcd-be3b5edaa46c name: Persona Title description: Persona description clips: - 54834687-5e79-4f08-8e14-cf188f15b598 is_public: true responses: '200': description: Successful Response content: application/json: schema: type: object required: - id - name - description - image_s3_id - root_clip_id - clip - user_display_name - user_handle - user_image_url - persona_clips - is_suno_persona - is_trashed - is_owned - is_public - is_public_approved - is_loved - upvote_count - clip_count properties: id: type: string name: type: string description: type: string image_s3_id: type: string root_clip_id: type: string clip: type: object required: - id - entity_type - video_url - audio_url - image_url - image_large_url - major_model_version - model_name - metadata - is_liked - user_id - display_name - handle - is_handle_updated - avatar_image_url - is_trashed - flag_count - display_tags - created_at - status - title - play_count - upvote_count - is_public - allow_comments properties: id: type: string entity_type: type: string video_url: type: string audio_url: type: string image_url: type: string image_large_url: type: string major_model_version: type: string model_name: type: string metadata: type: object required: - tags - prompt - type - duration - refund_credits - stream - can_remix - is_remix - priority properties: tags: type: string prompt: type: string type: type: string duration: type: integer refund_credits: type: boolean stream: type: boolean can_remix: type: boolean is_remix: type: boolean priority: type: integer is_liked: type: boolean user_id: type: string display_name: type: string handle: type: string is_handle_updated: type: boolean avatar_image_url: type: string is_trashed: type: boolean flag_count: type: integer display_tags: type: string created_at: type: string status: type: string title: type: string play_count: type: integer upvote_count: type: integer is_public: type: boolean allow_comments: type: boolean user_display_name: type: string user_handle: type: string user_image_url: type: string persona_clips: type: array items: type: object properties: clip: type: object required: - id - entity_type - video_url - audio_url - image_url - image_large_url - major_model_version - model_name - metadata - is_liked - user_id - display_name - handle - is_handle_updated - avatar_image_url - is_trashed - flag_count - display_tags - created_at - status - title - play_count - upvote_count - is_public - allow_comments properties: id: type: string entity_type: type: string video_url: type: string audio_url: type: string image_url: type: string image_large_url: type: string major_model_version: type: string model_name: type: string metadata: type: object required: - tags - prompt - type - duration - refund_credits - stream - can_remix - is_remix - priority properties: tags: type: string prompt: type: string type: type: string duration: type: integer refund_credits: type: boolean stream: type: boolean can_remix: type: boolean is_remix: type: boolean priority: type: integer is_liked: type: boolean user_id: type: string display_name: type: string handle: type: string is_handle_updated: type: boolean avatar_image_url: type: string is_trashed: type: boolean flag_count: type: integer display_tags: type: string created_at: type: string status: type: string title: type: string play_count: type: integer upvote_count: type: integer is_public: type: boolean allow_comments: type: boolean id: type: integer is_suno_persona: type: boolean is_trashed: type: boolean is_owned: type: boolean is_public: type: boolean is_public_approved: type: boolean is_loved: type: boolean upvote_count: type: integer clip_count: type: integer x-codeSamples: - lang: Shell label: cURL source: | curl https://api.deerapi.com/suno/persona/create \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $DEERAPI_KEY" \ -d '{ "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c", "name": "Persona Title", "description": "Persona description", "clips": [ "54834687-5e79-4f08-8e14-cf188f15b598" ], "is_public": true }' - lang: Python label: requests source: | import os import requests url = "https://api.deerapi.com/suno/persona/create" headers = { "Authorization": "Bearer " + os.environ["DEERAPI_KEY"], "Content-Type": "application/json", } payload = { "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c", "name": "Persona Title", "description": "Persona description", "clips": [ "54834687-5e79-4f08-8e14-cf188f15b598" ], "is_public": true } response = requests.post(url, headers=headers, json=payload) print(response.json()) - lang: JavaScript label: fetch source: > const response = await fetch("https://api.deerapi.com/suno/persona/create", { method: "POST", headers: { Authorization: `Bearer ${process.env.DEERAPI_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "root_clip_id": "82294225-6537-4dfc-adcd-be3b5edaa46c", "name": "Persona Title", "description": "Persona description", "clips": [ "54834687-5e79-4f08-8e14-cf188f15b598" ], "is_public": true }), }); console.log(await response.json()); components: securitySchemes: bearerAuth: type: http scheme: bearer description: Use a DeerAPI API Key as a Bearer token. ````