--- title: SDKs | RunAPI description: Ein typisiertes RunAPI-SDK installieren, es mit einem API-Schlüssel authentifizieren und den richtigen Task-Lebenszyklus für Ihre Anwendung auswählen. url: https://runapi.ai/de/docs/resources/sdks.md canonical: https://runapi.ai/de/docs/resources/sdks locale: de --- > HTML-Version: https://runapi.ai/de/docs/resources/sdks > Website-Index für KI-Agenten: https://runapi.ai/llms.txt # SDKs RunAPI SDKs stellen typisierte Clients für unterstützte Modellfamilien in JavaScript, Python, PHP, Java, Ruby und Go bereit. Wählen Sie das Sprachpaket für die Modellfamilie, die Ihre Anwendung aufruft. ## Ein Modell-SDK installieren Das Paket installieren, das zu Ihrer Sprache und Modellfamilie passt. Zum Beispiel das Suno JavaScript SDK installieren: ```shell npm install @runapi.ai/suno@0.6.0 ``` Dieselbe Modellfamilie ist über den Paketmanager für jede unterstützte Laufzeitumgebung verfügbar: ```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 ``` Fügen Sie für Java das Suno-Modul mit Gradle oder Maven hinzu: ```kotlin dependencies { implementation("ai.runapi:runapi-suno:0.5.0") } ``` ```xml ai.runapi runapi-suno 0.5.0 ``` ## Den Client authentifizieren Setzen Sie `RUNAPI_API_KEY` in der Umgebung, bevor Sie einen Client erstellen. Das SDK verwendet einen RunAPI-API-Schlüssel für denselben Kontokontext wie Ihre REST- Anfragen und den CLI-Workflow. ```shell export RUNAPI_API_KEY="runapi_..." ``` Erstellen und rotieren Sie Schlüssel im [Authentifizierungsleitfaden](https://runapi.ai/de/docs/guides/authentication.md). Bewahren Sie Schlüssel in Ihrem Secret-Manager auf, nicht im Quellcode der Anwendung. ## Mit Dateien und Uploads arbeiten Jeder Provider-Client stellt persistente `files`- und mehrteilige `uploads`-Ressourcen aus seinem Kernpaket bereit. Die vorhandene Methode `files.create` erstellt weiterhin eine temporäre URL; verwenden Sie `files.createFile` in JavaScript, Java und PHP, `files.create_file` in Python und Ruby oder `Files.CreateFile` in Go, um ein persistentes Datei-Objekt zu erstellen. ```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); ``` Verwende `uploads.create`, `addPart`, `complete` und `cancel`, wenn eine Anfrage in Parts aufgeteilt ist. Python und Ruby verwenden `add_part`; Go verwendet `AddPart`. Siehe [Files and Uploads](https://runapi.ai/de/docs/resources/files.md) für Limits, REST- Beispiele und den vollständigen Lebenszyklus. ## Audio synchron transkribieren Das OpenAI Transcription SDK lädt eine lokale Audiodatei hoch und gibt die abgeschlossene Transkription in derselben Anfrage zurück. JSON-Antwortformate geben ein sprachnatives Objekt zurück; Text-, SRT- und VTT-Formate geben den exakten Antwort-String zurück. ```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", }); ``` Siehe die [Audio-Transkriptions-API- Referenz](https://runapi.ai/de/docs/api/openai-transcription/speech-to-text.md) für Dateiformate, modellspezifische Felder und Antwortformate. ## Mit asynchronen Tasks arbeiten Viele Medienoperationen sind asynchron. Verwenden Sie `create`, um einen Task einzureichen und seine ID sofort zu erhalten, `get`, um seinen aktuellen Status abzurufen, oder `run`, um ihn einzureichen und zu pollen, bis er einen Endzustand erreicht. Bevorzugen Sie in einem Web-Request-Handler `create` mit einem Callback oder späterem `get`-Polling, damit der Request keinen Worker blockiert. ### 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() ); ``` ## Eine Style Persona wiederverwenden Erstellen Sie eine Style Persona aus einer öffentlichen Audio-URL und verwenden Sie die zurückgegebene `persona.id` dann mit den vier unterstützten Musikoperationen wieder. `persona_type: "style"` wendet wiederverwendbare Genre- und Stimmungsmerkmale an. Dies garantiert weder das Klonen der Stimme der Quellaufnahme noch die verlustfreie Beibehaltung ihres Stils oder eine bestimmte Ähnlichkeit mit dem Quell-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, }); ``` ## Den nächsten Workflow auswählen Verwende ein SDK, wenn deine Anwendung von typisierten Anfrage-Buildern und sprachnnativen Task-Helfern profitiert. Verwende die [RunAPI CLI](https://runapi.ai/de/docs/resources/cli.md) für Shell-Automatisierung, lokale Prüfungen und Callback-Debugging. Für genaue Anfrage-Felder, Task-Antworten und Fehler verwende die [API Reference](https://runapi.ai/de/docs/api/openai/chat-completions.md). ## Vidu Q4 Die Vidu-Pakete bieten Bild-zu-Video und Referenz-zu-Video Ressourcen mit Helfern zum Erstellen, Abrufen und asynchronen Aufgaben. Benutzen `vidu-q4-image-to-video` oder `vidu-q4-reference-to-video` für entsprechende Ressource. Paketnamen sind `@runapi.ai/vidu` für JavaScript, `runapi-vidu` für Python und Ruby, `runapi-ai/vidu` für PHP, `ai.runapi:runapi-vidu` für Java und `github.com/runapi-ai/vidu-sdk/go` für Go. Die Anforderungen für Referenzbilder und MP3-Dateien finden Sie in der [Task-API-Anleitung](https://runapi.ai/de/docs/guides/task-api/quickstart.md#generate-vidu-q4-videos)。 Siehe auch [Preise für Bild zu Video](https://runapi.ai/de/models/vidu/q4-image-to-video) · [Preise für Referenzen zu Video](https://runapi.ai/de/models/vidu/q4-reference-to-video)。 --- ## Mehr von RunAPI - [Startseite](https://runapi.ai/de/.md) - [Modellkatalog](https://runapi.ai/de/models.md) - [Preise](https://runapi.ai/de/pricing.md) - [Anbieter](https://runapi.ai/de/models) - [Dokumentation](https://runapi.ai/de/docs/guides) - [SDKs](https://runapi.ai/de/sdk.md) - [CLI](https://runapi.ai/de/cli.md) - [MCP Server](https://runapi.ai/de/mcp.md) - [x402](https://runapi.ai/de/x402.md) - [Claude Code vs Cursor](https://runapi.ai/de/claude-code-vs-cursor.md) - [Cursor API-Einrichtung](https://runapi.ai/de/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/de/openrouter-alternative.md) - [Enterprise](https://runapi.ai/de/contact.md) - [Kontakt](https://runapi.ai/de/contact.md) - [Bedingungen](https://runapi.ai/de/terms.md) - [Datenschutz](https://runapi.ai/de/privacy.md) - [Website-Index für KI-Agenten](https://runapi.ai/llms.txt) Kontakt: contact@runapi.ai ## Strukturierte Daten ```json [ { "@context": "https://schema.org", "inLanguage": "de", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/de", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/de/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "de", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/de", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/deicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "de", "@type": "TechArticle", "headline": "SDKs", "description": "Ein typisiertes RunAPI-SDK installieren, es mit einem API-Schlüssel authentifizieren und den richtigen Task-Lebenszyklus für Ihre Anwendung auswählen.", "url": "https://runapi.ai/de/docs/resources/sdks", "mainEntityOfPage": "https://runapi.ai/de/docs/resources/sdks" } ] ```