Download da API Suno - Download do código-fonte da API Suno

API Suno

Outro código-fonte

v1.0.7

Baixar

API Suno AI?

Biblioteca de API Python para Suno AI – Crie música com IA generativa!

- Disponível como biblioteca Python e API REST -

Biblioteca Python · Canal de atualização

A Biblioteca API SunoAI é um cliente Python não oficial para interagir com o gerador de música do Suno AI . Esta biblioteca facilita a geração de música usando o modelo Chirp v3 da Suno e inclui funções principais do Suno AI com um downloader de música integrado. Ele pode ser implantado como uma API REST usando FastAPI, Local, Docker, em um provedor PaaS como Heroku.

Características

Cliente Python? : Interaja facilmente com Suno AI.
Geração de Canção? : Utilize o modelo Chirp v3 para gerar música.
Recuperar informações da música por ID? : acesse informações detalhadas sobre qualquer música no Suno AI.
Baixador de música? : Funcionalidade integrada para baixar qualquer música diretamente no Suno AI.
Implantação de API REST : implantável como API REST na plataforma PasS, VPS ou local.
Documentação abrangente : inclui exemplos detalhados e guias de uso.
Suporte Docker? : permite a implantação em contêineres com Docker para maior flexibilidade.
Implantação de PaaS ☁️: Facilita a implantação em plataformas como Heroku para acessibilidade conveniente.

? Pré-requisitos

? Antes de usar a biblioteca ou API REST, você deve se cadastrar no site suno.ai e obter seu cookie conforme mostrado nesta captura de tela.

Você pode encontrar o cookie nas Ferramentas do desenvolvedor do navegador da Web -> Guia Rede

Clique para visualizar - Captura de tela

Basta clicar com o botão direito e abrir Inspecionar. Filtro: _clerk_js_version

Defina este cookie como variável de ambiente SUNO_COOKIE ou inicialize a biblioteca conforme mostrado abaixo.

 from suno import Suno , ModelVersions
client = Suno (
  cookie = 'YOUR_COOKIE_HERE' ,
  model_version = ModelVersions . CHIRP_V3_5 )

? Instalação

Instale a biblioteca usando pip:

pip install SunoAI

Implantação – API REST

Implantar no PasS

Defina SUNO_COOKIE como uma variável ambiental antes da implantação. - Instruções

Implantar em local ou VPS

 export SUNO_COOKIE= " YOUR_COOKIE_HERE "
git clone [email protected]:Malith-Rukshan/Suno-API.git
pip3 install -r requirements.txt
cd Suno-API
fastapi run api.py --port 8080

? Disponível em: http://127.0.0.1:8080

Uso

⚡️ Início rápido:

 from suno import Suno , ModelVersions
client = Suno (
  cookie = 'YOUR_COOKIE_HERE' ,
  model_version = ModelVersions . CHIRP_V3_5 )

# Generate a song
songs = client . generate ( prompt = "A serene landscape" , is_custom = False , wait_audio = True )

# Download generated songs
for song in songs :
    file_path = client . download ( song = song )
    print ( f"Song downloaded to: { file_path } " )

Métodos de biblioteca

Suno() <- Inicializando

Argumentos :
- cookie (Opcional[str]): Opcional. O cookie de autenticação para a API Suno. Se não for fornecido, utilizará o cookie da variável de ambiente SUNO_COOKIE.
- model_version (str): Opcional. A versão do modelo a ser usada para gerar áudio. Modelos disponíveis: chirp-v3-5 , chirp-v3-0 , chirp-v2-0 o padrão é chirp-v3-5 . | Visualização detalhada

generate()

Argumentos :
- prompt (str): Descrição ou letra da música.
- is_custom (bool): Determina se deve usar uma letra personalizada (True) ou uma descrição (False).
- tags (opcional[str]): Descreve o tipo ou características de voz desejadas.
- title (Opcional[str]): Título da música gerada.
- make_instrumental (Optional[bool]): Gera uma versão instrumental se True.
- wait_audio (bool): espera até que os URLs de áudio estejam prontos se for True.
- model_version (Opcional[str]): A versão do modelo a ser usada para gerar áudio. O padrão é o valor de inicialização, se não for fornecido.
Retorna : uma lista de objetos Clip contendo dados de música com IDs.

Exemplo:

Por descrição

 clips = client . generate (
  prompt = "A peaceful melody reflecting a serene landscape" ,
  is_custom = False ,
  wait_audio = True
)
print ( clips )

Por Letra - Personalizado

 clips = client . generate (
  prompt = "I found a love, for me n Darling, just dive right in and follow my lead n Well, I found a girl, beautiful and sweet n Oh, I never knew you were the someone waiting for me..." ,
  tags = "English men voice" ,
  title = "Perfect by Malith-Rukshan/Suno-API" ,
  make_instrumental = False ,
  is_custom = True ,
  wait_audio = True
)
print ( clips )

✍️ Nota de uso:

Ao definir is_custom como True , certifique-se de que o parâmetro prompt contém a letra da música que você deseja gerar. Por outro lado, se is_custom estiver definido como False , forneça um prompt descritivo detalhando a essência da música desejada.
Quando wait_audio estiver definido como True , a solicitação demorará mais enquanto aguarda que os URLs de áudio estejam prontos. Se não for definido, a resposta retornará sem audio_url , mas com IDs de áudio. Nesses casos, você precisará chamar o método get_songs ou get_song após um curto intervalo para recuperar a resposta com o audio_url incluído, assim que o processo de geração for concluído.

get_songs()

Argumentos :
- song_ids (opcional[str]): uma lista de IDs de músicas para buscar músicas específicas.
Retorna : uma lista de objetos Clip que representam as músicas recuperadas.

Exemplo:

 songs = client . get_songs ( song_ids = "123,456" )
print ( songs )

set_visibility()

Argumentos :
- song_id (str): O ID da música a ser atualizada.
- is_public (bool): Uma string indicando se a música deve ser pública (True) ou privada (False).
Retorna (bool): Status de visibilidade pública da música. True se a música for pública, False se for privada.
Exemplo :

 response = client . set_visibility ( song_id = "uuid-type-songid-1234" , is_public = False )
print ( response )

get_credits()

Retorna: informações atuais de cobrança e créditos como um objeto CreditsInfo .

Exemplo:

 credits_info = client . get_credits ()
print ( credits_info )

download()

Argumentos:
- música (str | Clip): A música a ser baixada. Pode ser o ID da música como uma string ou um objeto Clip contendo os metadados da música.
- path (str): O caminho do diretório onde a música será salva. Se não for especificado, o padrão é "./downloads".
Retorna: str - O caminho completo da música baixada.
Aumenta:
- TypeError: se o argumento da música não for um ID de string nem um objeto Clip.
- Exceção: se o download falhar devido a problemas como URL inválido ou erros de rede.

Exemplo:

 # Using a song ID
file_path = client . download ( song = "uuid-type-songid-1234" )
print ( f"Song downloaded to: { file_path } " )

# Using a Clip object
clip = client . get_song ( "uuid-type-songid-1234" )
file_path = client . download ( song = clip )
print ( f"Song downloaded to: { file_path } " )

Modelos Suno AI disponíveis:

Modelos fornecidos pela Suno AI para gerar música.

CHIRP_V3_5 - chirp-v3-5 : Modelo mais recente, melhor estrutura de música, máximo de 4 minutos.
CHIRP_V3_0 - chirp-v3-0 : amplo, versátil, no máximo 2 minutos.
CHIRP_V2_0 - chirp-v2-0 : modelo Suno vintage, máximo de 1,3 minutos.

Exemplo de como usar:

 from suno import Suno , ModelVersions

client = Suno ( model_version = ModelVersions . CHIRP_V3_5 )

ou

 from suno import Suno

client = Suno ( model_version = 'chirp-v3-5' )

Respostas da biblioteca

Modelo de clipe:
A classe Clip encapsula os detalhes de uma faixa de música gerada pelo Suno AI. Cada atributo desta classe fornece informações específicas sobre a trilha:
- id (str): identificador exclusivo do clipe.
- video_url (str): URL da versão em vídeo da música, se disponível.
- audio_url (str): URL onde a faixa de áudio pode ser transmitida ou baixada.
- image_url (str): URL da imagem da capa da música.
- image_large_url (str): URL de uma versão maior da imagem da capa da música.
- is_video_pending (bool): Indica se o vídeo da música ainda está em processamento.
- major_model_version (str): A versão principal do modelo usado para gerar a música.
- model_name (str): Nome do modelo utilizado para gerar a trilha.
- metadados (ClipMetadata): metadados adicionais relacionados ao clipe, incluindo tags, prompts e outras informações.
- is_liked (bool): Indica se a música foi curtida pelo usuário.
- user_id (str): ID do usuário da pessoa que criou ou solicitou a música.
- display_name (str): Nome de exibição do usuário associado à música.
- handle (str): identificador ou nome de usuário do usuário.
- is_handle_updated (bool): Especifica se o identificador do usuário foi atualizado.
- is_trashed (bool): Indica se o clipe foi marcado como lixo.
- reação (dict): Reações dos usuários à música, se houver.
- criado_at (str): Timestamp indicando quando a música foi criada.
- status (str): Status atual da música (por exemplo, em processamento, concluída).
- título (str): Título da música.
- play_count (int): Quantas vezes a música foi tocada.
- upvote_count (int): Número de votos positivos que a música recebeu.
- is_public (bool): Indica se a música está acessível publicamente.
Modelo de informações de créditos:
A classe CreditsInfo fornece informações sobre o saldo de crédito e o uso do usuário no sistema Suno AI.
- credits_left (int): O número de créditos restantes para o usuário.
- período (int): O período atual de cobrança dos créditos, representado em alguma forma de data ou período.
- mensal_limit (int): O número total de créditos alocados ao usuário no mês atual.
- mensal_usage (int): A quantidade de créditos utilizados pelo usuário durante o mês atual.

Uso da API REST

1. Gere música

POST /generate

Corpo da solicitação:

{
  "prompt" : " A serene melody about the ocean " ,
  "is_custom" : false ,
  "tags" : " relaxing, instrumental " ,
  "title" : " Ocean Waves " ,
  "make_instrumental" : true ,
  "model_version" : " chirp-v3-5 " ,
  "wait_audio" : true
}

Resposta:

Clique para ver

[
    {
        "id" : " 124b735f-7fb0-42b9-8b35-761aed65a7f6 " ,
        "video_url" : " " ,
        "audio_url" : " https://audiopipe.suno.ai/item_id=124b735f-7fb0-42b9-8b35-761aed65a7f6 " ,
        "image_url" : " https://cdn1.suno.aiimage_124b735f-7fb0-42b9-8b35-761aed65a7f6.png " ,
        "image_large_url" : " https://cdn1.suno.aiimage_large_124b735f-7fb0-42b9-8b35-761aed65a7f.png " ,
        "is_video_pending" : False,
        "major_model_version" : " v3 " ,
        "model_name" : " chirp-v3 " ,
        "metadata" : {
            "tags" : " English men voice " ,
            "prompt" : " I found a love, for me n Darling,just dive right in and follow mylead n Well, I found a girl, beautiful andsweet n Oh, I never knew you were thesomeone waiting for me nn ′Cause we werejust kids when we fell in love n Not knowingwhat it was n I will not give you up thistime n But darling, just kiss me slow n Yourheart is all I own n And in your eyes,you're holding mine nn Baby, I′m dancing inthe dark n With you between myarms n Barefoot on the grass n Listening toour favourite song n When you said youlooked a mess n I whispered underneath mybreath n But you heard it n Darling, you lookperfect tonight " ,
            "gpt_description_prompt" : None,
            "audio_prompt_id" : None,
            "history" : None,
            "concat_history" : None,
            "type" : " gen " ,
            "duration" : None,
            "refund_credits" : None,
            "stream" : True,
            "error_type" : None,
            "error_message" : None
        },
        "is_liked" : False,
        "user_id" : " 2340653f-32cb-4343-artb-09203ty749e9 " ,
        "display_name" : " Snonymous " ,
        "handle" : " anonymous " ,
        "is_handle_updated" : False,
        "is_trashed" : False,
        "reaction" : None,
        "created_at" : " 2024-05-05T11:54:09.356Z " ,
        "status" : " streaming " ,
        "title" : " Perfect by Malith-Rukshan/Suno-API " ,
        "play_count" : 0 ,
        "upvote_count" : 0 ,
        "is_public" : False
    }
]

2. Recuperar músicas

POST /songs

Corpo da solicitação:

{
  "song_ids" : " uuid-format-1234,4567-abcd "
}

Resposta: Matriz de clipes - Igual a /generate Response

3. Obtenha uma música específica

POST /get_song

Corpo da solicitação:
```
{
  "song_id" : " uuid-song-id "
}
```
Resposta: Resposta Just Clip - O mesmo que /generate Response, mas apenas Clip

POST /set_visibility

Corpo da solicitação:

{
  "song_id" : " uuid-song-id " ,
  "is_public" : true
}

Resposta:
```
{
  "is_public" : true
}
```

4. Recuperar informações de crédito

GET /credits

Resposta:

{
  "credits_left" : 50 ,
  "period" : " 2024-05 " ,
  "monthly_limit" : 100 ,
  "monthly_usage" : 25
}

De acordo com Suno.ai Cada geração de música consome 5 créditos, portanto, é necessário um total de 10 créditos para cada chamada bem-sucedida.

? Contribuindo

As contribuições são o que tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.

Créditos e outros

Todo o conteúdo e música gerados por meio desta biblioteca são creditados à Suno AI. Esta API não oficial fornece uma maneira conveniente de interagir com os serviços da Suno AI, mas não reivindica qualquer propriedade ou direito sobre a música gerada. Respeite os termos de serviço da Suno AI ao usar sua plataforma ❤️.

Esta biblioteca destina-se principalmente a fins educacionais e de desenvolvimento. O objetivo é aprimorar e simplificar o acesso aos recursos de geração de música da Suno AI. Se você gosta da música gerada, considere apoiar diretamente o Suno AI. Crédito do logotipo: @ rejaul43

⚖️ Licença

Este projeto é distribuído sob a licença MIT. Esta licença permite que todos usem, modifiquem e redistribuam o código. No entanto, ele não oferece garantias quanto à sua funcionalidade. Para mais detalhes, consulte o arquivo LICENSE no repositório.