--- title: Zestawy SDK | RunAPI description: Zainstaluj typowany SDK RunAPI, uwierzytelnij go za pomocą klucza API i wybierz odpowiedni cykl życia zadania dla swojej aplikacji. url: https://runapi.ai/pl/docs/resources/sdks.md canonical: https://runapi.ai/pl/docs/resources/sdks locale: pl --- > Wersja HTML: https://runapi.ai/pl/docs/resources/sdks > Indeks witryny dla agentów: https://runapi.ai/llms.txt # Zestawy SDK Zestawy SDK RunAPI udostępniają typowane klienty dla obsługiwanych rodzin modeli w językach JavaScript, Python, PHP, Java, Ruby i Go. Wybierz pakiet językowy odpowiedni dla rodziny modeli używanej przez Twoją aplikację. ## Instalacja SDK modelu Zainstaluj pakiet odpowiadający Twojemu językowi i rodzinie modeli. Na przykład zainstaluj Suno JavaScript SDK: ```shell npm install @runapi.ai/suno@0.6.0 ``` Ta sama rodzina modeli jest dostępna za pośrednictwem menedżera pakietów dla każdego obsługiwanego środowiska uruchomieniowego: ```shell pip install runapi-suno==0.6.0 composer require runapi-ai/suno:0.4.0 gem install runapi-suno --version 0.6.0 go get github.com/runapi-ai/suno-sdk/go@v0.6.0 ``` W przypadku Javy dodaj moduł Suno przy użyciu Gradle lub Maven: ```kotlin dependencies { implementation("ai.runapi:runapi-suno:0.5.0") } ``` ```xml ai.runapi runapi-suno 0.5.0 ``` ## Uwierzytelnianie klienta Ustaw `RUNAPI_API_KEY` w środowisku przed utworzeniem klienta. Zestaw SDK używa klucza API RunAPI dla tego samego kontekstu konta co Twoje żądania REST i przepływ pracy CLI. ```shell export RUNAPI_API_KEY="runapi_..." ``` Twórz i rotuj klucze, korzystając z [Przewodnika po uwierzytelnianiu](https://runapi.ai/pl/docs/guides/authentication.md). Przechowuj klucze w menedżerze sekretów, a nie w kodzie źródłowym aplikacji. ## Praca z plikami i przesyłaniem danych Każdy klient dostawcy (Provider Client) udostępnia trwałe zasoby `files` i wieloczęściowe `uploads` ze swojego pakietu podstawowego. Istniejąca metoda `files.create` nadal tworzy tymczasowy adres URL; użyj `files.createFile` w JavaScript, Java i PHP, `files.create_file` w Python i Ruby lub `Files.CreateFile` w Go, aby utworzyć trwały obiekt File. ```javascript const file = await client.files.createFile({ file: new Blob([fileBytes], { type: "application/pdf" }), filename: "knowledge.pdf", purpose: "user_data", }); const bytes = await client.files.content(file.id); await client.files.deleteFile(file.id); ``` Użyj `uploads.create`, `addPart`, `complete` i `cancel`, gdy żądanie jest podzielone na Parts. Python i Ruby używają `add_part`; Go używa `AddPart`. Zobacz [Files and Uploads](https://runapi.ai/pl/docs/resources/files.md), aby poznać limity, przykłady REST i pełny cykl życia. ## Synchroniczna transkrypcja audio Pakiet SDK OpenAI Transcription przesyła lokalny plik audio i zwraca ukończoną transkrypcję w tym samym żądaniu. Formaty odpowiedzi JSON zwracają obiekt natywny dla danego języka; formaty tekstu, SRT i VTT zwracają dokładny ciąg odpowiedzi. ```javascript import { OpenaiTranscriptionClient } from "@runapi.ai/openai-transcription"; const client = new OpenaiTranscriptionClient(); const transcript = await client.speechToText.run({ file: new Blob([audioBytes], { type: "audio/mpeg" }), filename: "interview.mp3", response_format: "json", }); ``` Zapoznaj się z [dokumentacją interfejsu API transkrypcji audio ](https://runapi.ai/pl/docs/api/openai-transcription/speech-to-text.md), aby uzyskać informacje o formatach plików, polach specyficznych dla modelu i formatach odpowiedzi. ## Praca z asynchronicznymi zadaniami Wiele operacji multimedialnych jest asynchronicznych. Użyj `create`, aby przesłać zadanie i natychmiast otrzymać jego identyfikator, `get`, aby pobrać jego bieżący stan, lub `run`, aby przesłać i odpytywać do momentu osiągnięcia stanu końcowego. W procedurze obsługi żądań internetowych preferuj `create` z wywołaniem zwrotnym lub późniejszym odpytywaniem `get`, aby żądanie nie blokowało wątku roboczego. ### JavaScript ```javascript import { SunoClient } from "@runapi.ai/suno"; const client = new SunoClient(); const result = await client.textToMusic.run({ model: "suno-v5", vocal_mode: "auto_lyrics", prompt: "A short piano theme", }); console.log(result.audios[0].audio_url); ``` ### Python ```python from runapi.suno import SunoClient client = SunoClient() result = client.text_to_music.run( model="suno-v4.5-plus", vocal_mode="auto_lyrics", prompt="A short piano theme", ) print(result.audios[0].audio_url) ``` ### PHP ```php textToMusic->run([ 'model' => 'suno-v5.5', 'vocal_mode' => 'auto_lyrics', 'prompt' => 'A short piano theme', ]); print_r($result->toArray()); ``` ### Ruby ```ruby require "runapi/suno" client = RunApi::Suno::Client.new result = client.text_to_music.run( model: "suno-v4.5-plus", vocal_mode: "auto_lyrics", prompt: "A short piano theme" ) puts result.dig("audios", 0, "audio_url") ``` ### Go ```go package main import ( "context" "fmt" "log" "os" "github.com/runapi-ai/core-sdk/go/option" "github.com/runapi-ai/suno-sdk/go/suno" ) func main() { client, err := suno.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } result, err := client.TextToMusic.Run(context.Background(), suno.TextToMusicParams{ SunoBaseParams: suno.SunoBaseParams{Model: suno.ModelV45Plus}, VocalMode: suno.VocalModeAutoLyrics, Prompt: "A short piano theme", }) if err != nil { log.Fatal(err) } fmt.Println(result.ID) } ``` ### Java ```java import ai.runapi.suno.SunoClient; import ai.runapi.suno.types.CompletedTextToMusicResponse; import ai.runapi.suno.types.TextToMusicModel; import ai.runapi.suno.types.TextToMusicParams; SunoClient client = SunoClient.builder() .apiKey(System.getenv("RUNAPI_API_KEY")) .build(); CompletedTextToMusicResponse result = client.textToMusic().run( TextToMusicParams.builder() .model(TextToMusicModel.SUNO_V5) .vocalMode("auto_lyrics") .prompt("A short piano theme") .build() ); ``` ## Ponowne użycie Style Persona Utwórz Style Persona z publicznego adresu URL audio, a następnie wykorzystaj ponownie zwrócone `persona.id` z czterema obsługiwanymi operacjami muzycznymi. `persona_type: "style"` stosuje wielokrotnie używalne cechy gatunku i nastroju. Nie gwarantuje to klonowania głosu z nagrania źródłowego, bezstratnego zachowania jego stylu ani żadnego szczególnego podobieństwa do źródłowego audio. ```javascript import { SunoClient } from "@runapi.ai/suno"; const client = new SunoClient(); const referenceAudioUrl = "https://cdn.runapi.ai/public/samples/music.mp3"; const sampled = await client.addSamples.run({ model: "suno-v5", audio_url: referenceAudioUrl, start_seconds: 0, end_seconds: 30, }); const sourceAudioId = sampled.audios?.[0]?.id; if (!sourceAudioId) throw new Error("The sample Task did not return an audio ID"); const { persona } = await client.generatePersona.run({ task_id: sampled.id, audio_id: sourceAudioId, name: "Studio Style", description: "A warm and expressive acoustic pop style.", }); const textToMusic = await client.textToMusic.run({ model: "suno-v5", vocal_mode: "auto_lyrics", prompt: "An uplifting acoustic pop song about a rainy city night", persona_id: persona.id, persona_type: "style", }); const coverAudio = await client.coverAudio.run({ model: "suno-v5", upload_url: referenceAudioUrl, vocal_mode: "auto_lyrics", prompt: "Rework the reference track as acoustic pop", persona_id: persona.id, persona_type: "style", }); const createMashup = await client.createMashup.run({ model: "suno-v5", upload_url_list: [ referenceAudioUrl, "https://cdn.runapi.ai/public/samples/audio-2.mp3", ], vocal_mode: "auto_lyrics", prompt: "Blend both tracks into an energetic acoustic pop mashup", persona_id: persona.id, persona_type: "style", }); const extendMusic = await client.extendMusic.run({ model: "suno-v5", upload_url: referenceAudioUrl, parameter_mode: "custom", instrumental: false, prompt: "Continue the arrangement with a brighter chorus", style: "Acoustic pop with warm piano", title: "Brighter Chorus", continue_at: 60, persona_id: persona.id, persona_type: "style", }); console.log({ textToMusic: textToMusic.audios[0]?.audio_url, coverAudio: coverAudio.audios[0]?.audio_url, createMashup: createMashup.audios[0]?.audio_url, extendMusic: extendMusic.audios[0]?.audio_url, }); ``` ## Wybierz następny przepływ pracy Używaj SDK, gdy Twoja aplikacja korzysta z typowanych konstruktorów żądań i natywnych dla języka pomocników Zadań (Task). Używaj [RunAPI CLI](https://runapi.ai/pl/docs/resources/cli.md) do automatyzacji powłoki, lokalnych testów i debugowania wywołań zwrotnych. W przypadku dokładnych pól żądania, odpowiedzi Zadań (Task) i błędów skorzystaj z [Dokumentacji interfejsu API](https://runapi.ai/pl/docs/api/openai/chat-completions.md). ## Vidu Q4 Pakiety Vidu zapewniają przetwarzanie obrazu na wideo i odniesienie do wideo zasoby z pomocnikami tworzenia, pobierania i asynchronicznych zadań. Użyj `vidu-q4-image-to-video` lub `vidu-q4-reference-to-video` dla odpowiedni zasób. Nazwy pakietów to `@runapi.ai/vidu` dla JavaScript, `runapi-vidu` dla Python i Ruby, `runapi-ai/vidu` dla PHP, `ai.runapi:runapi-vidu` dla Java i `github.com/runapi-ai/vidu-sdk/go` dla Go. Wymagania dotyczące obrazów referencyjnych i plików MP3 znajdziesz w [przewodniku API zadań](https://runapi.ai/pl/docs/guides/task-api/quickstart.md#generate-vidu-q4-videos)。 Zobacz również [Cennik obrazu na film](https://runapi.ai/pl/models/vidu/q4-image-to-video) · [Cennik referencji na film](https://runapi.ai/pl/models/vidu/q4-reference-to-video)。 --- ## Więcej od RunAPI - [Strona główna](https://runapi.ai/pl/.md) - [Katalog modeli](https://runapi.ai/pl/models.md) - [Cennik](https://runapi.ai/pl/pricing.md) - [Dostawcy](https://runapi.ai/pl/models) - [Dokumentacja](https://runapi.ai/pl/docs/guides) - [SDK](https://runapi.ai/pl/sdk.md) - [CLI](https://runapi.ai/pl/cli.md) - [Serwer MCP](https://runapi.ai/pl/mcp.md) - [x402](https://runapi.ai/pl/x402.md) - [Claude Code vs Cursor](https://runapi.ai/pl/claude-code-vs-cursor.md) - [Konfiguracja Cursor API](https://runapi.ai/pl/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pl/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pl/contact.md) - [Kontakt](https://runapi.ai/pl/contact.md) - [Regulamin](https://runapi.ai/pl/terms.md) - [Prywatność](https://runapi.ai/pl/privacy.md) - [Indeks witryny dla agentów](https://runapi.ai/llms.txt) Kontakt: contact@runapi.ai ## Dane strukturalne ```json [ { "@context": "https://schema.org", "inLanguage": "pl", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pl", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pl/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pl", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/plicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pl", "@type": "TechArticle", "headline": "Zestawy SDK", "description": "Zainstaluj typowany SDK RunAPI, uwierzytelnij go za pomocą klucza API i wybierz odpowiedni cykl życia zadania dla swojej aplikacji.", "url": "https://runapi.ai/pl/docs/resources/sdks", "mainEntityOfPage": "https://runapi.ai/pl/docs/resources/sdks" } ] ```