--- title: SDKs | RunAPI description: Instale un SDK de RunAPI con tipos, autentíquelo con una clave de API y elija el ciclo de vida de Task adecuado para su aplicación. url: https://runapi.ai/es/docs/resources/sdks.md canonical: https://runapi.ai/es/docs/resources/sdks locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/sdks > Índice del sitio para agentes: https://runapi.ai/llms.txt # SDKs Los SDKs de RunAPI proporcionan clientes tipados para las familias de modelos compatibles en JavaScript, Python, PHP, Java, Ruby y Go. Elija el paquete del lenguaje correspondiente a la familia de modelos que utiliza su aplicación. ## Instalar un SDK de modelo Instale el paquete que coincida con su idioma y familia de modelos. Por ejemplo, instale el SDK de JavaScript de Suno: ```shell npm install @runapi.ai/suno@0.6.0 ``` La misma familia de modelos está disponible a través del gestor de paquetes para cada entorno de ejecución compatible: ```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 ``` Para Java, agregue el módulo Suno con Gradle o Maven: ```kotlin dependencies { implementation("ai.runapi:runapi-suno:0.5.0") } ``` ```xml ai.runapi runapi-suno 0.5.0 ``` ## Autenticar el cliente Establezca `RUNAPI_API_KEY` en el entorno antes de crear un cliente. El SDK utiliza una Clave de API de RunAPI para el mismo contexto de cuenta que sus solicitudes REST y el flujo de trabajo de la CLI. ```shell export RUNAPI_API_KEY="runapi_..." ``` Cree y rote claves en la [Guía de Autenticación](https://runapi.ai/es/docs/guides/authentication.md). Guarde las claves en su administrador de secretos en lugar del código fuente de la aplicación. ## Trabajar con archivos y cargas Cada cliente de proveedor expone los recursos `files` persistentes y `uploads` multiparte desde su paquete principal. El método `files.create` existente sigue creando una URL temporal; use `files.createFile` en JavaScript, Java y PHP, `files.create_file` en Python y Ruby, o `Files.CreateFile` en Go para crear un objeto File persistente. ```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); ``` Usa `uploads.create`, `addPart`, `complete` y `cancel` cuando una solicitud se divida en Parts. Python y Ruby usan `add_part`; Go usa `AddPart`. Consulta [Files and Uploads](https://runapi.ai/es/docs/resources/files.md) para conocer los límites, los ejemplos REST y el ciclo de vida completo. ## Transcribir audio de forma síncrona El SDK de transcripción de OpenAI sube un archivo de audio local y devuelve la transcripción completada en la misma solicitud. Los formatos de respuesta JSON devuelven un objeto nativo del lenguaje; los formatos de texto, SRT y VTT devuelven la cadena de respuesta exacta. ```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", }); ``` Consulte la [referencia de la API de Transcripción de audio ](https://runapi.ai/es/docs/api/openai-transcription/speech-to-text.md) para conocer los formatos de archivo, los campos específicos de cada modelo y los formatos de respuesta. ## Trabajar con tareas asíncronas Muchas operaciones de medios son asíncronas. Use `create` para enviar una Tarea y recibir su id inmediatamente, `get` para recuperar su estado actual, o `run` para enviar y sondear hasta que alcance un estado terminal. En un controlador de solicitudes web, prefiera `create` más una devolución de llamada o un sondeo posterior con `get` para que la solicitud no mantenga un trabajador abierto. ### 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() ); ``` ## Reutilizar un Style Persona Crea un Style Persona a partir de una URL de audio pública y reutiliza el `persona.id` devuelto con las cuatro operaciones de música compatibles. `persona_type: "style"` aplica características reutilizables de género y estado de ánimo. No garantiza la clonación de la voz de la grabación original, la preservación sin pérdidas de su estilo ni ninguna similitud particular con el audio fuente. ```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, }); ``` ## Elegir el siguiente flujo de trabajo Usa un SDK cuando tu aplicación se beneficie de constructores de solicitudes tipadas y helpers de Task nativos del lenguaje. Usa la [RunAPI CLI](https://runapi.ai/es/docs/resources/cli.md) para automatización de shell, comprobaciones locales y depuración de devoluciones de llamada. Para conocer los campos exactos de solicitud, las respuestas de Task y los errores, usa la [Referencia de la API](https://runapi.ai/es/docs/api/openai/chat-completions.md). ## Vidu Q4 Los paquetesViduproporcionan recursos de imagen a video y de referencia a video con asistentes de creación, recuperación y tareas asincrónicas. Utilice `vidu-q4-image-to-video` o `vidu-q4-reference-to-video` para el recurso correspondiente. Los nombres de los paquetes son `@runapi.ai/vidu` paraJavaScript, `runapi-vidu` paraPythonyRuby, `runapi-ai/vidu` paraPHP, `ai.runapi:runapi-vidu` paraJavay `github.com/runapi-ai/vidu-sdk/go` porGo. Consulta los requisitos de imágenes de referencia y MP3 en la [guía de la API de tareas](https://runapi.ai/es/docs/guides/task-api/quickstart.md#generate-vidu-q4-videos)。 Consulta también [Precios de imagen a vídeo](https://runapi.ai/es/models/vidu/q4-image-to-video) · [Precios de referencias a vídeo](https://runapi.ai/es/models/vidu/q4-reference-to-video)。 --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [x402](https://runapi.ai/es/x402.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "SDKs", "description": "Instale un SDK de RunAPI con tipos, autentíquelo con una clave de API y elija el ciclo de vida de Task adecuado para su aplicación.", "url": "https://runapi.ai/es/docs/resources/sdks", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/sdks" } ] ```