Twórz piosenki w Grok

Grok dokumentuje niestandardową ścieżkę konektora MCP do łączenia narzędzi zewnętrznych z konwersacją. Words into Music udostępnia zdalny punkt końcowy OAuth MCP do generowania piosenek. Ten przewodnik przedstawia udokumentowaną konfigurację i czynności, które należy wykonać przed wydaniem kredytu na piosenkę.

Ukończyliśmy testy pełnowartościowych piosenek w ChatGPT i Claude. Pełny test piosenek Words into Music w Grok jest nadal w toku. Poniższe kroki dla Grok są zgodne z aktualną dokumentacją xAI; nie są przedstawione jako przetestowana sesja nagraniowa.

Dodaj niestandardowy konektor na stronie internetowej

Zgodnie z dokumentacją konektora xAI, otwórz Grok Connectors, wybierz Nowy konektor, a następnie Niestandardowy. Wprowadź ten publiczny adres URL serwera:

https://mcp.wordsintomusic.com/mcp

Użyj OAuth, gdy Grok zapyta, jak się uwierzytelnić. Zaloguj się w Words into Music i przejrzyj konto, hosta zwrotnego oraz uprawnienia. Nie powinieneś potrzebować naszych kluczy dostawcy, plików cookie przeglądarki ani hasła Words into Music wklejonego do czatu.

W Grok Business i Enterprise administrator może potrzebować udostępnić konektor w konsoli chmurowej, zanim członkowie będą mogli go używać. Dostępność i etykiety mogą ulec zmianie. Jeśli Twoje konto nie ma opcji Niestandardowy, sprawdź dokumentację xAI, zamiast wprowadzać punkt końcowy w niepowiązanym polu klucza API.

Sprawdź połączenie bez tworzenia piosenki

Włącz konektor dla swojej konwersacji, jeśli Grok oferuje selektor narzędzi, a następnie zapytaj:

Użyj Words into Music, aby sprawdzić moje dostępne kredyty na piosenki i obsługiwane języki piosenek. Nie przygotowuj ani nie rozpoczynaj piosenki.

Szukaj rzeczywistej odpowiedzi narzędzia. Odpowiedź konwersacyjna mówiąca, że może napisać teksty, nie jest dowodem działającego połączenia muzycznego. Oczekiwane nazwy narzędzi to get_account_usage, prepare_song, start_song i get_song_job. Przegląd MCP wyjaśnia dostępne narzędzia.

Jeśli logowanie lub wykrywanie nie powiedzie się, nie twórz nowych konektorów ani nie zatwierdzaj nieoczekiwanych uprawnień. Odłącz niekompletne połączenie i wyślij tekst błędu, bez tokenów ani kodów zwrotnych, do wsparcia.

Przygotuj, przejrzyj, a następnie wygeneruj

Gdy kontrola tylko do odczytu zadziała, wypróbuj precyzyjny brief:

Przygotuj 60-sekundowy utwór instrumentalny z łagodnym pianinem i miękkimi bębnami do czytania w deszczowy wieczór. Sprawdź moje saldo i pokaż brief oraz koszt jednego kredytu. Poczekaj na moją zgodę przed rozpoczęciem dokładnie jednego nagrania.

Piosenka może trwać od 60 do 180 sekund. Języki wokalne to angielski, hiszpański, niemiecki, francuski, brazylijski portugalski, włoski, holenderski, polski, szwedzki, japoński i koreański. Podaj język wyraźnie, jeśli chcesz wokale; język konwersacji i język piosenki mogą się różnić.

• Przygotowanie briefu nie kosztuje kredytów na piosenki.
• Rozpoczęcie jej zużywa jeden istniejący kredyt.
• Plany i pakiety piosenek korzystają z tego samego portfela.

Po zatwierdzeniu poproś Grok o rozpoczęcie tego samego przygotowanego żądania i sprawdzaj postęp nie częściej niż co 15 sekund. Jeśli połączenie przekroczy limit czasu, ponów próbę z tym przygotowanym ID zamiast tworzyć drugie żądanie. Zaakceptowane zadanie kontynuuje się po opuszczeniu czatu. Posłuchaj przez prywatny link Words into Music, gdy będzie gotowe.

Dla deweloperów korzystających z API xAI

API to oddzielna konfiguracja od strony internetowej Grok. Potrzebujesz klucza API xAI dla xAI oraz tokena dostępu OAuth Words into Music uzyskanego przez własny autoryzowany przepływ OAuth Twojej aplikacji. Na naszej stronie Ustawienia nie ma generatora osobistych tokenów. Nie wyodrębniaj tokena z sesji przeglądarki.

Referencja API zdalnego MCP xAI obsługuje adres URL serwera, autoryzację i listę dozwolonych narzędzi. Zacznij od dostępu tylko do odczytu. Ten ilustracyjny przykład zgodny z OpenAI sprawdza połączenie bez udostępniania narzędzi generowania:

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)

Użyj aktualnie dostępnego modelu obsługującego MCP z Twojego konta xAI. Przechowuj oba poświadczenia po stronie serwera i zaimplementuj odświeżanie oraz odwoływanie. Opłaty API xAI są oddzielne od kredytów na piosenki. Ten przykład nie został uruchomiony na opłaconym koncie deweloperskim xAI.

Nie udostępniaj start_song modelowi bez nadzoru bez kroku zatwierdzenia na poziomie aplikacji. Zachowanie zatwierdzania API różni się od konektora internetowego. Aby uzyskać najłatwiejszą zweryfikowaną konfigurację przeglądarki, postępuj zgodnie z instrukcjami dla Claude lub ChatGPT. Ogólny przewodnik konfiguracji obejmuje rozłączanie i typowe błędy.

Jeśli potrzebujesz kredytów, poproś asystenta o wyświetlenie aktualnych ofert. Po dokonaniu wyboru, create_checkout_link otwiera płatność Stripe dla Twojego połączonego konta bez ponownego logowania na stronie. Dokończ płatność na Stripe, a następnie poproś asystenta o sprawdzenie salda i ponowienie zapisanego żądania piosenki. Asystent nie może automatycznie obciążyć Cię opłatą ani zmienić Twojej istniejącej subskrypcji.