Audio & Music · OpenAI

OpenAI TTS API

Dostęp do API OpenAI TTS do syntezy mowy o niskich opóźnieniach i wysokiej jakości, z plikiem MP3 zarządzanym przez RunAPI.

Operacyjny · 2 variants · od $0.040

Wypróbuj w playground Dokumentacja API →

runapi.ai

curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tts-1-hd",
  "text": "Zamień ten skrypt wprowadzający użytkownika do produktu na wyraźne, naturalne nagranie lektorskie do samouczka w aplikacji."
}'

import { OpenaiTtsClient } from "@runapi.ai/openai-tts";

const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
    model: "tts-1-hd",
    text: "Zamień ten skrypt wprowadzający użytkownika do produktu na wyraźne, naturalne nagranie lektorskie do samouczka w aplikacji.",
});

require "runapi/openai_tts"

client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
    model: "tts-1-hd",
    text: "Zamień ten skrypt wprowadzający użytkownika do produktu na wyraźne, naturalne nagranie lektorskie do samouczka w aplikacji."
)

npx skills add runapi-ai/openai-tts -g

# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor

@runapi.ai/openai-tts v1

OVERVIEW

OpenAI TTS zamienia tekst na mowę przez synchroniczny endpoint RunAPI. Wybierz tts-1 do aplikacji, w których liczą się niskie opóźnienia, albo tts-1-hd do narracji o wyższej jakości; oba zwracają zarządzany adres URL pliku MP3.

Wiele wariantów dla różnych poziomów szybkości i jakości
Model skill zawiera dokumentację, schematy i notatki setupu
Działa z workflow kodowania aplikacji
Nie płacisz za nieudane generacje

VARIANTS

Porównaj wszystkie warianty API

Variant	Billing	From
tts-1	1K UTF-8 bytes	$0.040	Zobacz →
tts-1-hd	1K UTF-8 bytes	$0.080	Zobacz →

SKILLS

Zainstaluj skill OpenAI TTS do tworzenia aplikacji

Wczytaj dokumentację modelu, schematy, notatki cenowe i kroki setupu do workspace kodu.

# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -g

Installs docs, schemas, pricing context, and setup notes into your developer workspace.

Or use this setup request in your coding tool:

Install the OpenAI TTS skill for this app:

1. Add runapi-ai/openai-tts with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.

JAK TO DZIAŁA

Od model skilla do pierwszego wyniku w czterech krokach

Wybierz model

Wybierz model i wariant pasujące do typu wyjścia, progu jakości i celu opóźnienia.

Konfiguracja

Ustaw klucz RunAPI i zainstaluj model skill w workspace kodu.

Implementacja

Użyj instrukcji skilla, aby dodać funkcję modelu w swojej aplikacji.

Odbiór

Odpytuj po task ID, streamuj gdy wspierane albo obsłuż callback webhook.

CONTEXT

Czym jest API OpenAI TTS?

OpenAI TTS oferuje wyspecjalizowane modele syntezy mowy do interaktywnego odtwarzania i dopracowanych nagrań lektorskich. W RunAPI oba warianty mają tę samą strukturę żądania i zwracają metadane zarządzanego pliku audio.

Provider

OpenAI

Modality

Audio & Music

DLACZEGO RUNAPI

Dlaczego używać API OpenAI TTS przez RunAPI

Jedno uwierzytelnienie, wszyscy providerzy

Jeden klucz RunAPI odblokowuje cały katalog. Bez osobnych kont i rotacji kluczy dla każdej integracji.

Ujednolicony cennik i rozliczenia

Rozliczanie za wywołanie w USD, fakturowane co miesiąc. Nieudane generacje nie są naliczane.

Skill ze schematami

Typowane schematy i notatki setupu są spakowane w model skill, więc implementacja startuje od właściwego kontraktu.

FAQ

Najczęstsze pytania

Czym różnią się tts-1 i tts-1-hd?

tts-1 jest zoptymalizowany pod kątem niskich opóźnień w interaktywnym odtwarzaniu, a tts-1-hd zapewnia wyższą jakość dźwięku w narracji i gotowych materiałach.

Jaki format audio zwraca OpenAI TTS?

Oba warianty zwracają plik audio MP3 oraz metadane formatu, typu MIME i rozmiaru w bajtach w odpowiedzi RunAPI.

Czy RunAPI przechowuje wygenerowany plik audio?

Tak. RunAPI weryfikuje plik audio i zwraca zarządzany adres URL, nie ujawniając tymczasowego adresu URL źródła.

Czy mogę wybrać własny głos lub szybkość?

Początkowy endpoint korzysta z opublikowanych domyślnych ustawień głosu i szybkości. Własne ustawienia głosu i szybkości nie są częścią kontraktu tego endpointu.

Czy zamiana tekstu na mowę jest synchroniczna?

Tak. Pomyślne żądanie zwraca bezpośrednio gotowy wynik audio, bez osobnego endpointu do odpytywania o wynik.

Od jakiego wariantu powinienem zacząć?

Wybierz najtańszy wariant, który spełnia Twoje wymagania jakościowe. Większość zespołów zaczyna od szybkiego wariantu, a do produkcji przechodzi na pro.

Czy jest darmowy plan?

Nowe konta otrzymują darmowe pierwsze wywołania dla każdego modelu. Później płacisz za każde wywołanie.

Czy streamujecie wyniki?

Tam, gdzie streaming jest dostępny, RunAPI streamuje end-to-end.

Jak są rozliczane nieudane próby?

Nieudane generacje nie są obciążane opłatą.

Czy wyniki są buforowane?

Wygenerowane wyniki są zapisywane i można je pobrać po ID zadania. Dane wejściowe nie są buforowane.

Czy mogę używać komercyjnie?

Tak — użycie komercyjne jest dostępne dla każdego wariantu, chyba że licencja modelu wyraźnie to ogranicza; informacja taka jest podana na stronie wariantu.

A co z limitami zapytań?

Limity na klucz rosną wraz z poziomem wykorzystania. Aktualne limity znajdziesz na stronie cennika.

Gdzie mogę zgłosić problem?

Otwórz zgłoszenie w publicznym repozytorium GitHub albo napisz do supportu.