Zasoby dla deweloperów

Zestawy SDK

Zainstaluj typowany SDK RunAPI, uwierzytelnij go za pomocą klucza API i wybierz odpowiedni cykl życia zadania dla swojej aplikacji.

Zobacz Markdown

Zestawy SDK RunAPI udostępniają typowane klienty dla obsługiwanych rodzin modeli w językach JavaScript, Python, PHP, Java, Ruby i Go. Wybierz pakiet językowy odpowiedni dla rodziny modeli używanej przez Twoją aplikację.

Instalacja SDK modelu

Zainstaluj pakiet odpowiadający Twojemu językowi i rodzinie modeli. Na przykład zainstaluj Suno JavaScript SDK:

SHELL

npm install @runapi.ai/[email protected]

Ta sama rodzina modeli jest dostępna za pośrednictwem menedżera pakietów dla każdego obsługiwanego środowiska uruchomieniowego:

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/[email protected]

W przypadku Javy dodaj moduł Suno przy użyciu Gradle lub Maven:

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>

Uwierzytelnianie klienta

Ustaw RUNAPI_API_KEY w środowisku przed utworzeniem klienta. Zestaw SDK używa klucza API RunAPI dla tego samego kontekstu konta co Twoje żądania REST i przepływ pracy CLI.

SHELL

export RUNAPI_API_KEY="runapi_..."

Twórz i rotuj klucze, korzystając z Przewodnika po uwierzytelnianiu. Przechowuj klucze w menedżerze sekretów, a nie w kodzie źródłowym aplikacji.

Praca z plikami i przesyłaniem danych

Każdy klient dostawcy (Provider Client) udostępnia trwałe zasoby files i wieloczęściowe uploads ze swojego pakietu podstawowego. Istniejąca metoda files.create nadal tworzy tymczasowy adres URL; użyj files.createFile w JavaScript, Java i PHP, files.create_file w Python i Ruby lub Files.CreateFile w Go, aby utworzyć trwały obiekt 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);

Użyj uploads.create, addPart, complete i cancel, gdy żądanie jest podzielone na Parts. Python i Ruby używają add_part; Go używa AddPart. Zobacz Files and Uploads, aby poznać limity, przykłady REST i pełny cykl życia.

Synchroniczna transkrypcja audio

Pakiet SDK OpenAI Transcription przesyła lokalny plik audio i zwraca ukończoną transkrypcję w tym samym żądaniu. Formaty odpowiedzi JSON zwracają obiekt natywny dla danego języka; formaty tekstu, SRT i VTT zwracają dokładny ciąg odpowiedzi.

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",
});

Zapoznaj się z dokumentacją interfejsu API transkrypcji audio , aby uzyskać informacje o formatach plików, polach specyficznych dla modelu i formatach odpowiedzi.

Praca z asynchronicznymi zadaniami

Wiele operacji multimedialnych jest asynchronicznych. Użyj create, aby przesłać zadanie i natychmiast otrzymać jego identyfikator, get, aby pobrać jego bieżący stan, lub run, aby przesłać i odpytywać do momentu osiągnięcia stanu końcowego. W procedurze obsługi żądań internetowych preferuj create z wywołaniem zwrotnym lub późniejszym odpytywaniem get, aby żądanie nie blokowało wątku roboczego.

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

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

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

Ponowne użycie Style Persona

Utwórz Style Persona z publicznego adresu URL audio, a następnie wykorzystaj ponownie zwrócone persona.id z czterema obsługiwanymi operacjami muzycznymi. persona_type: "style" stosuje wielokrotnie używalne cechy gatunku i nastroju. Nie gwarantuje to klonowania głosu z nagrania źródłowego, bezstratnego zachowania jego stylu ani żadnego szczególnego podobieństwa do źródłowego 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,
});

Wybierz następny przepływ pracy

Używaj SDK, gdy Twoja aplikacja korzysta z typowanych konstruktorów żądań i natywnych dla języka pomocników Zadań (Task). Używaj RunAPI CLI do automatyzacji powłoki, lokalnych testów i debugowania wywołań zwrotnych. W przypadku dokładnych pól żądania, odpowiedzi Zadań (Task) i błędów skorzystaj z Dokumentacji interfejsu API.

Vidu Q4

Pakiety Vidu zapewniają przetwarzanie obrazu na wideo i odniesienie do wideo zasoby z pomocnikami tworzenia, pobierania i asynchronicznych zadań. Użyj vidu-q4-image-to-video lub vidu-q4-reference-to-video dla odpowiedni zasób. Nazwy pakietów to @runapi.ai/vidu dla JavaScript, runapi-vidu dla Python i Ruby, runapi-ai/vidu dla PHP, ai.runapi:runapi-vidu dla Java i github.com/runapi-ai/vidu-sdk/go dla Go.

Wymagania dotyczące obrazów referencyjnych i plików MP3 znajdziesz w przewodniku API zadań。 Zobacz również Cennik obrazu na film · Cennik referencji na film。