--- title: حزم SDK | RunAPI description: ثبّت RunAPI SDK مكتوباً بأنواع، وصادق عليه بمفتاح API، واختر دورة حياة المهمة المناسبة لتطبيقك. url: https://runapi.ai/ar/docs/resources/sdks.md canonical: https://runapi.ai/ar/docs/resources/sdks locale: ar --- > نسخة HTML: https://runapi.ai/ar/docs/resources/sdks > فهرس الموقع للوكلاء: https://runapi.ai/llms.txt # حزم SDK توفر حزم RunAPI SDKs عملاء مكتوبين لعائلات النماذج المدعومة في JavaScript وPython وPHP وJava وRuby وGo. اختر حزمة اللغة المناسبة لعائلة النماذج التي يستدعيها تطبيقك. ## تثبيت SDK نموذج ثبّت الحزمة التي تتوافق مع لغتك وعائلة النموذج. على سبيل المثال، ثبّت Suno JavaScript SDK: ```shell npm install @runapi.ai/suno@0.6.0 ``` تتوفر عائلة النماذج ذاتها عبر مدير الحزم لكل وقت تشغيل مدعوم: ```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 ``` في Java، أضف وحدة Suno باستخدام Gradle أو Maven: ```kotlin dependencies { implementation("ai.runapi:runapi-suno:0.5.0") } ``` ```xml ai.runapi runapi-suno 0.5.0 ``` ## مصادقة العميل عيِّن `RUNAPI_API_KEY` في البيئة قبل إنشاء عميل. تستخدم حزمة SDK مفتاح API الخاص بـ RunAPI لنفس سياق الحساب الخاص بطلبات REST وسير عمل CLI. ```shell export RUNAPI_API_KEY="runapi_..." ``` أنشئ المفاتيح ودوّرها في [دليل المصادقة ](https://runapi.ai/ar/docs/guides/authentication.md). احتفظ بالمفاتيح في مدير الأسرار الخاص بك بدلاً من الاحتفاظ بها في شيفرة المصدر للتطبيق. ## العمل مع الملفات والتحميلات يكشف كل Provider Client عن موارد `files` الدائمة وموارد `uploads` متعددة الأجزاء من حزمته الأساسية. لا يزال الأسلوب `files.create` الحالي يُنشئ عنوان URL مؤقتاً؛ استخدم `files.createFile` في JavaScript وJava وPHP، و`files.create_file` في Python وRuby، أو `Files.CreateFile` في Go لإنشاء كائن 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); ``` استخدم `uploads.create` و`addPart` و`complete` و`cancel` عندما يكون الطلب مقسمًا إلى Parts. يستخدم Python وRuby `add_part`؛ ويستخدم Go `AddPart`. راجع [Files and Uploads](https://runapi.ai/ar/docs/resources/files.md) للاطلاع على الحدود والأمثلة بـ REST ودورة الحياة الكاملة. ## نسخ الصوت بشكل متزامن يرفع OpenAI Transcription SDK ملف صوتي محليًا ويُعيد النسخ المكتمل في الطلب ذاته. تُعيد تنسيقات استجابة JSON كائنًا أصيلاً للغة، فيما تُعيد تنسيقات text وSRT وVTT سلسلة الاستجابة عينها. ```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", }); ``` راجع [مرجع Audio Transcription API ](https://runapi.ai/ar/docs/api/openai-transcription/speech-to-text.md) للاطلاع على تنسيقات الملفات والحقول الخاصة بكل نموذج وتنسيقات الاستجابة. ## العمل مع المهام غير المتزامنة كثير من عمليات الوسائط غير متزامنة. استخدم `create` لإرسال مهمة واستقبال معرّفها فورًا، و`get` لاسترداد حالتها الحالية، أو `run` للإرسال والاستطلاع حتى تبلغ حالة نهائية. في معالج طلبات الويب، يُفضَّل استخدام `create` مع callback أو استطلاع `get` لاحقًا حتى لا يظل الطلب محتجزًا لعامل. ### 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() ); ``` ## إعادة استخدام Style Persona أنشئ Style Persona من رابط صوتي عام، ثم أعد استخدام `persona.id` المُعاد مع عمليات الموسيقى الأربع المدعومة. يطبّق `persona_type: "style"` خصائص النوع والمزاج القابلة لإعادة الاستخدام. ولا يضمن استنساخ صوت التسجيل المصدر، أو الحفاظ على أسلوبه بلا فقدان، أو أي تشابه معين مع الصوت المصدر. ```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, }); ``` ## اختر سير العمل التالي استخدم SDK عندما تستفيد تطبيقاتك من منشئي الطلبات المكتوبة بأنواع ومساعدي Task الأصليين للغة. استخدم [RunAPI CLI](https://runapi.ai/ar/docs/resources/cli.md) لأتمتة shell والفحوصات المحلية وتصحيح عمليات الاستدعاء. للاطلاع على حقول الطلب الدقيقة واستجابات Task والأخطاء، استخدم [مرجع API](https://runapi.ai/ar/docs/api/openai/chat-completions.md). ## Vidu Q4 توفر حزم Vidu تحويل الصورة إلى فيديو والإشارة إلى الفيديو الموارد مع مساعدي المهام في الإنشاء والاسترداد وغير المتزامنين. استخدم `vidu-q4-image-to-video` أو `vidu-q4-reference-to-video` لـ الموارد المقابلة. أسماء الحزم هي `@runapi.ai/vidu` لـ JavaScript، `runapi-vidu` لـ Python وRuby، `runapi-ai/vidu` لـ PHP، `ai.runapi:runapi-vidu` لـ Java و `github.com/runapi-ai/vidu-sdk/go` ل Go. راجع المتطلبات الخاصة بالصور المرجعية وملفات MP3 في [دليل واجهة برمجة تطبيقات المهام](https://runapi.ai/ar/docs/guides/task-api/quickstart.md#generate-vidu-q4-videos)。 راجع أيضًا [أسعار الصورة إلى الفيديو](https://runapi.ai/ar/models/vidu/q4-image-to-video) · [أسعار المراجع إلى الفيديو](https://runapi.ai/ar/models/vidu/q4-reference-to-video)。 --- ## المزيد من RunAPI - [الرئيسية](https://runapi.ai/ar/.md) - [كتالوج النماذج](https://runapi.ai/ar/models.md) - [الأسعار](https://runapi.ai/ar/pricing.md) - [مزودو الخدمة](https://runapi.ai/ar/models) - [التوثيق](https://runapi.ai/ar/docs/guides) - [حزم SDK](https://runapi.ai/ar/sdk.md) - [CLI](https://runapi.ai/ar/cli.md) - [خادم MCP](https://runapi.ai/ar/mcp.md) - [x402](https://runapi.ai/ar/x402.md) - [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md) - [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md) - [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md) - [المؤسسات](https://runapi.ai/ar/contact.md) - [اتصل بنا](https://runapi.ai/ar/contact.md) - [الشروط](https://runapi.ai/ar/terms.md) - [الخصوصية](https://runapi.ai/ar/privacy.md) - [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt) التواصل: contact@runapi.ai ## البيانات المنظمة ```json [ { "@context": "https://schema.org", "inLanguage": "ar", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ar", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ar", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ar", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/aricon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ar", "@type": "TechArticle", "headline": "حزم SDK", "description": "ثبّت RunAPI SDK مكتوباً بأنواع، وصادق عليه بمفتاح API، واختر دورة حياة المهمة المناسبة لتطبيقك.", "url": "https://runapi.ai/ar/docs/resources/sdks", "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/sdks" } ] ```