---
title: SDK | RunAPI
description: 型付き RunAPI SDK をインストールし、API キーで認証して、アプリケーションに適したタスクライフサイクルを選択します。
url: https://runapi.ai/ja/docs/resources/sdks.md
canonical: https://runapi.ai/ja/docs/resources/sdks
locale: ja
---

> HTML 版: https://runapi.ai/ja/docs/resources/sdks
> エージェント向けサイトインデックス: https://runapi.ai/llms.txt

# SDK

RunAPI SDKは、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の場合は、GradleまたはMavenでSunoモジュールを追加してください：

```kotlin
dependencies {
  implementation("ai.runapi:runapi-suno:0.5.0")
}
```

```xml
<dependency>
  <groupId>ai.runapi</groupId>
  <artifactId>runapi-suno</artifactId>
  <version>0.5.0</version>
</dependency>
```

## クライアントを認証する

クライアントを作成する前に、環境変数に`RUNAPI_API_KEY`を設定してください。SDKはRESTリクエストおよびCLIワークフローと同じアカウントコンテキスト用のRunAPI APIキーを使用します。

```shell
export RUNAPI_API_KEY="runapi_..."
```

[認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)でキーを作成・ローテーションします。キーはアプリケーションのソースコードではなく、シークレットマネージャーに保管してください。

## ファイルとアップロードの操作

すべてのProvider Clientは、コアパッケージから永続的な`files`とマルチパート`uploads`リソースを公開しています。既存の`files.create`メソッドは引き続き一時URLを作成します。永続的なFileオブジェクトを作成するには、JavaScriptとJavaとPHPでは`files.createFile`、PythonとRubyでは`files.create_file`、Goでは`Files.CreateFile`を使用してください。

```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);
```

リクエストをPartに分割する場合は、`uploads.create`、`addPart`、`complete`、`cancel` を使用してください。PythonおよびRubyでは `add_part`、Goでは `AddPart` を使用します。
制限事項、RESTの例、およびライフサイクル全体については、[Files and Uploads](https://runapi.ai/ja/docs/resources/files.md) を参照してください。

## 音声を同期的にトランスクライブ

OpenAI Transcription SDKはローカルの音声ファイルをアップロードし、同じリクエスト内で完成したトランスクリプションを返します。JSONレスポンス形式は言語ネイティブのオブジェクトを返し、テキスト、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",
});
```

ファイル形式、モデル固有のフィールド、およびレスポンス形式については、[音声文字起こしAPIリファレンス](https://runapi.ai/ja/docs/api/openai-transcription/speech-to-text.md)を参照してください。

## 非同期タスクの操作

多くのメディア操作は非同期です。`create`を使用してタスクを送信し、そのidを即座に受け取ります。`get`で現在の状態を取得するか、`run`で送信してから終端状態に達するまでポーリングします。Webリクエストハンドラーでは、ワーカーを占有しないよう、`create`とコールバック、または後からの`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
<?php

use RunApi\Suno\SunoClient;

$client = new SunoClient();
$result = $client->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()
);
```

## スタイルペルソナを再利用する

公開オーディオ URL からスタイルペルソナを作成し、返された `persona.id` を 4 つのサポートされている音楽操作で再利用します。`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,
});
```

## 次のワークフローを選択する

アプリケーションが型付きリクエストビルダーや言語ネイティブのTaskヘルパーの恩恵を受ける場合はSDKを使用してください。シェルの自動化、ローカル確認、コールバックのデバッグには [RunAPI CLI](https://runapi.ai/ja/docs/resources/cli.md) を使用してください。正確なリクエストフィールド、Taskレスポンス、エラーについては、[API Reference](https://runapi.ai/ja/docs/api/openai/chat-completions.md) を参照してください。

## Vidu Q4

Vidu パッケージは、画像からビデオへの変換および参照からビデオへの変換を提供します。
作成、取得、および非同期タスク ヘルパーを備えたリソース。使用する `vidu-q4-image-to-video` または `vidu-q4-reference-to-video` 対応するリソース。パッケージ名は `@runapi.ai/vidu` です。
JavaScript、Python および Ruby の場合は `runapi-vidu` 、PHP の場合は `runapi-ai/vidu` 、
Java、および `github.com/runapi-ai/vidu-sdk/go` の場合は `ai.runapi:runapi-vidu` Go用。

参照画像と MP3 の要件は次のガイドを確認してください。 [タスク API ガイド](https://runapi.ai/ja/docs/guides/task-api/quickstart.md#generate-vidu-q4-videos)。 料金は次のページを確認してください。 [画像から動画の料金](https://runapi.ai/ja/models/vidu/q4-image-to-video) · [参照画像から動画の料金](https://runapi.ai/ja/models/vidu/q4-reference-to-video)。

---

## RunAPI のその他の情報

- [ホーム](https://runapi.ai/ja/.md)
- [モデルカタログ](https://runapi.ai/ja/models.md)
- [料金](https://runapi.ai/ja/pricing.md)
- [プロバイダー](https://runapi.ai/ja/models)
- [ドキュメント](https://runapi.ai/ja/docs/guides)
- [SDK](https://runapi.ai/ja/sdk.md)
- [CLI](https://runapi.ai/ja/cli.md)
- [MCP Server](https://runapi.ai/ja/mcp.md)
- [x402](https://runapi.ai/ja/x402.md)
- [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md)
- [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md)
- [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md)
- [エンタープライズ](https://runapi.ai/ja/contact.md)
- [お問い合わせ](https://runapi.ai/ja/contact.md)
- [利用規約](https://runapi.ai/ja/terms.md)
- [プライバシー](https://runapi.ai/ja/privacy.md)
- [エージェント向けサイトインデックス](https://runapi.ai/llms.txt)

お問い合わせ: contact@runapi.ai

## 構造化データ

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ja",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ja",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/jaicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "TechArticle",
    "headline": "SDK",
    "description": "型付き RunAPI SDK をインストールし、API キーで認証して、アプリケーションに適したタスクライフサイクルを選択します。",
    "url": "https://runapi.ai/ja/docs/resources/sdks",
    "mainEntityOfPage": "https://runapi.ai/ja/docs/resources/sdks"
  }
]
```