Crea canzoni in Grok

Grok documenta un percorso connettore MCP personalizzato per collegare strumenti esterni a una conversazione. Words into Music espone un endpoint MCP OAuth remoto per la generazione di canzoni. Questa guida mostra la configurazione documentata e i controlli da effettuare prima di spendere un credito canzone.

Abbiamo completato i test di produzione di canzoni in ChatGPT e Claude. Un test completo di canzoni di Words into Music in Grok è ancora in sospeso. I passaggi di Grok seguenti seguono la documentazione attuale di xAI; non sono presentati come una sessione di registrazione testata.

Aggiungi il connettore personalizzato sul web

Secondo la documentazione del connettore di xAI, apri Grok Connectors, scegli Nuovo Connettore, quindi Personalizzato. Inserisci questo URL del server pubblico:

https://mcp.wordsintomusic.com/mcp

Usa OAuth quando Grok ti chiede come autenticarti. Accedi a Words into Music e rivedi l'account, l'host di callback e i permessi. Non dovresti aver bisogno delle nostre chiavi del provider, dei cookie del tuo browser o di una password di Words into Music incollata nella chat.

Su Grok Business ed Enterprise, un amministratore potrebbe dover effettuare il provisioning del connettore nella console cloud prima che i membri possano usarlo. La disponibilità e le etichette possono cambiare. Se il tuo account non ha l'opzione Personalizzato, consulta la documentazione di xAI anziché inserire l'endpoint in un campo chiave API non correlato.

Controlla la connessione senza creare una canzone

Abilita il connettore per la tua conversazione se Grok offre un selettore di strumenti, quindi chiedi:

Usa Words into Music per controllare i miei crediti canzone disponibili e le lingue supportate. Non preparare o avviare una canzone.

Cerca una risposta effettiva dello strumento. Una risposta conversazionale che dice che può scrivere testi non è prova di una connessione musicale funzionante. I nomi degli strumenti previsti includono get_account_usage, prepare_song, start_song e get_song_job. La panoramica MCP spiega gli strumenti disponibili.

Se l'accesso o la scoperta falliscono, non continuare a creare nuovi connettori o ad approvare permessi inattesi. Disconnetti la connessione incompleta e invia il testo dell'errore, senza token o codici di callback, al supporto.

Prepara, rivedi, quindi genera

Una volta che il controllo di sola lettura funziona, prova un brief specifico:

Prepara un brano strumentale di 60 secondi con pianoforte dolce e batteria leggera per la lettura in una sera di pioggia. Controlla il mio saldo e mostra il brief e il costo di un credito. Attendi la mia approvazione prima di avviare esattamente una registrazione.

La canzone può durare da 60 a 180 secondi. Le lingue vocali sono inglese, spagnolo, tedesco, francese, portoghese brasiliano, italiano, olandese, polacco, svedese, giapponese e coreano. Indica esplicitamente la lingua se desideri le voci; la lingua della conversazione e la lingua della canzone possono differire.

Preparare il brief non costa crediti canzone. Avviarlo spende un credito esistente. I piani e i pacchetti di canzoni usano lo stesso portafoglio.

Dopo l'approvazione, chiedi a Grok di avviare la stessa richiesta preparata e controlla i progressi non più velocemente di ogni 15 secondi. Se una chiamata va in timeout, riprova con quell'ID preparato invece di fare una seconda richiesta. Un lavoro accettato continua dopo che hai lasciato la chat. Ascolta tramite il link privato di Words into Music quando è pronto.

Per gli sviluppatori che usano l'API di xAI

L'API è una configurazione separata dal sito web di Grok. Hai bisogno di una chiave API xAI per xAI e di un token di accesso OAuth di Words into Music ottenuto tramite il flusso OAuth autorizzato della tua applicazione. Non c'è un generatore di token personali nella nostra pagina Impostazioni. Non estrarre un token dalla tua sessione del browser.

La documentazione API MCP remota di xAI supporta un URL del server, l'autorizzazione e una lista di strumenti consentiti. Inizia con l'accesso in sola lettura. Questo esempio illustrativo compatibile con OpenAI verifica la connessione senza esporre gli strumenti di generazione:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)
response = client.responses.create(
    model=os.environ["XAI_MODEL"],
    input="Check my Words into Music song credits only.",
    tools=[{
        "type": "mcp",
        "server_label": "words_into_music",
        "server_url": "https://mcp.wordsintomusic.com/mcp",
        "authorization": "Bearer " + os.environ["WIM_ACCESS_TOKEN"],
        "allowed_tools": ["get_account_usage"],
    }],
)
print(response.output_text)

Usa un modello compatibile con MCP attualmente disponibile dal tuo account xAI. Mantieni entrambe le credenziali lato server e implementa il refresh e la revoca. I costi dell'API di xAI sono separati dai crediti canzone. Questo esempio non è stato eseguito su un account sviluppatore xAI finanziato.

Non esporre start_song a un modello non supervisionato senza un passaggio di approvazione a livello di applicazione. Il comportamento di approvazione dell'API differisce da quello del connettore web. Per la configurazione browser verificata più semplice oggi, segui Claude o ChatGPT. La guida di configurazione generale copre la disconnessione e gli errori comuni.

Se hai bisogno di crediti, chiedi all'assistente di mostrarti le offerte attuali. Dopo aver scelto, create_checkout_link apre il checkout di Stripe per il tuo account connesso senza un altro login al sito web. Completa il pagamento su Stripe, quindi chiedi all'assistente di controllare il tuo saldo e riprovare la richiesta di canzone salvata. L'assistente non può addebitarti automaticamente o modificare la tua sottoscrizione esistente.