Suno API: 1つのエンドポイントでプロンプトとスクリプト

認証とベースURL

当APIは標準的なOpenAI認証を使用します。APIキーのみが必要で、APIキーを取得ページで生成できます。電話番号やクレジットカードは不要で、新規アカウントには7日間有効な$0.50の無料トライアルクレジットが付与されます。

クライアント設定でベースURLをhttps://api.sunoapis.com/v1に設定してください。すべてのリクエストで送信する必要があるモデル識別子はuncensoredです。これは当社のGPUサーバーでホストされているオープンスウェイトモデルで、主要プロバイダー特有の拒否なしに、法的な成人向けおよびクリエイティブ用途向けにチューニングされています。

• ベースURL: https://api.sunoapis.com/v1
• モデルID: uncensored
• 認証ヘッダー: Authorization: Bearer YOUR_API_KEY

最初のリクエスト

標準的なチャット完了リクエストですぐに開始できます。エンドポイントは、システムプロンプト、ユーザー指示、テキストから映像やAI音楽パイプラインに必要なメタデータを含むJSONペイロードを受け入れます。

これはテキスト専用のAPIです。音声、映像、画像は生成せず、それらのツールを駆動するテキスト指示を生成します。このエンドポイントを使用して、シーンの脚本を作成、歌詞を書く、またはクリエイティブアセットから構造化データを抽出します。

Copycurl https://api.sunoapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

公式のOpenAI SDKを使用して、PythonアプリケーションにAPIを統合します。当社はOpenAI互換であるため、ベースURLとAPIキーを変更するだけで既存のコードを再利用できます。

このアプローチは、映像生成ツール用のスクリプト生成や音楽API用のメタデータ作成に役立ちます。次のセクションで説明するストリーミングと関数呼び出しの機能に対応するため、SDKのバージョンが最新であることを確認してください。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK

JavaScript/TypeScript開発者向けに、@anthropic-ai/sdkまたは公式のopenaiパッケージは、わずかな設定調整で動作します。クライアントをベースURLにポイントし、uncensoredモデルIDを使用してください。

これにより、クリエイティブアプリ用のサーバーサイドテキスト生成を構築できます。ユーザー入力の前処理や、音声や映像生成エンドポイントに送信する前に生成されたスクリプトの後処理に使用できます。APIは最新のWebフレームワークと互換性のある標準的なJSONレスポンスを返します。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

ストリーミングレスポンス

長いスクリプトや詳細なメタデータには、Server-Sent Events (SSE) を使用してトークンをリアルタイムで受信してください。リクエストボディにstream: trueを設定します。APIはチャンクの連続を送信し、生成されたテキストを表示できます。

これは、ユーザーがプロンプトが書かれているのを見ることを望むインタラクティブなクリエイティブツールに特に役立ちます。各チャンクには差分テキストのみが含まれるため、完全なレスポンスを再構築するには断片を連結する必要があります。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

制限、エラー、コンテキスト

各アカウントにはAPIキーが1つまで制限されており、いつでも再生成できます（古いキーは無効化されます）。キーごとに1分あたり300リクエストまで許可され、最大リクエストボディサイズは8 MBです。

一般的なエラーには、無効なキーの場合の401、前払いクレジットが不足している場合の402、レート制限の場合の429があります。モデルは入出力合わせて100,000トークンのコンテキストウィンドウをサポートしています。

コンテンツ注記: モデルは論争の的となる話題や成人向けトピックを拒否しませんが、すべてのリクエストで未成年者を含む性的コンテンツを厳格にブロックします。