OpenAI Transcription API
Whisper-1 ve GPT Transcribe ile ses transkripsiyonu ve konuşmadan metne dönüşüm için OpenAI uyumlu API erişimi.
curl -X POST https://runapi.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "whisper-1",
"audio_url": "https://cdn.runapi.ai/public/samples/voice.mp3"
}'
import { OpenaiTranscriptionClient } from "@runapi.ai/openai-transcription";
const client = new OpenaiTranscriptionClient();
const result = await client.speechToText.run({
model: "whisper-1",
audio_url: "https://cdn.runapi.ai/public/samples/voice.mp3",
});
require "runapi/openai_transcription"
client = RunApi::OpenaiTranscription::Client.new
result = client.speech_to_text.run(
model: "whisper-1",
audio_url: "https://cdn.runapi.ai/public/samples/voice.mp3"
)
npx skills add runapi-ai/openai-transcription -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
OpenAI Transcription, yüklenen ses dosyalarını senkron bir multipart endpoint'i üzerinden metne dönüştürür. Whisper-1 altyazı ve zaman damgası çıktısını, GPT Transcribe ise çok dilli sesler için anahtar kelime ve dil ipuçlarını destekler.
- Farklı hız / kalite seviyeleri için birden çok varyant
- Model skill dokümanları, şemaları ve kurulum notlarını içerir
- Uygulama odaklı kodlama workflow’larıyla çalışır
- Başarısız üretimler ücretlendirilmez
Tüm API varyantlarını karşılaştırın
Uygulama geliştirme için OpenAI Transcription skill’ini kurun
Model dokümanlarını, şemaları, fiyat notlarını ve kurulum adımlarını kod workspace’inize yükleyin.
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-transcription -g
Install the OpenAI Transcription skill for this app: 1. Add runapi-ai/openai-transcription 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.
Model skill’den ilk sonuca dört adımda
Modeli seçin
Çıktı tipi, kalite eşiği ve gecikme hedefinize uygun model ve varyantı seçin.
Yapılandır
RunAPI anahtarınızı ayarlayın ve model skill’i kod workspace’inize kurun.
Geliştirin
Skill talimatlarını kullanarak model özelliğini uygulamanızın içine ekleyin.
Al
Task ID ile sorgulayın, destekleniyorsa stream edin veya webhook callback’i işleyin.
OpenAI Transcription API nedir?
OpenAI Transcription; toplantı notları, altyazılar, aranabilir medya ve çok dilli transkriptler için konuşmadan metne modelleri sunar. Her iki varyant da OpenAI uyumlu ses transkripsiyonu istek yapısını kullanır.
OpenAI Transcription API neden RunAPI üzerinden kullanılmalı
Tek kimlik doğrulama, tüm sağlayıcılar
Tek bir RunAPI anahtarı tüm kataloğu açar. Ayrı hesap yok, her entegrasyon için anahtar döndürme yok.
Birleşik fiyatlandırma ve faturalandırma
USD bazında çağrı başı fiyatlandırma, aylık faturalandırılır. Başarısız üretimler ücretlendirilmez.
Şemalı skill
Tipli şemalar ve kurulum notları model skill içinde paketlenir; uygulama doğru kontrattan başlar.
Sık sorulan sorular
Whisper-1 ile GPT Transcribe arasındaki fark nedir?
Whisper-1; JSON, düz metin, altyazı, ayrıntılı JSON ve zaman damgalı çıktıyı destekler. GPT Transcribe, JSON veya düz metne odaklanır ve anahtar kelime ile birden fazla dil ipucunu kabul eder.
Hangi ses dosyalarını yazıya dökebilirim?
Endpoint, 25 MB'a kadar FLAC, MP3, MP4, MPEG, MPGA, M4A, OGG, WAV ve WebM yüklemelerini kabul eder.
API altyazı ve kelime zaman damgaları oluşturabilir mi?
Whisper-1, SRT veya VTT altyazılarını ve ayrıntılı JSON üzerinden kelime ya da segment düzeyinde zaman damgalarını döndürebilir. Bu çıktı modları GPT Transcribe ile kullanılamaz.
GPT Transcribe çok dilli kayıtları destekliyor mu?
Evet. Tek bir dil ipucu veya olası dillerin listesini, ayrıca adlar ve alana özgü terimler için anahtar kelime ipuçlarını sağlayabilirsiniz.
Ses transkripsiyonu senkron mu?
Evet. Başarılı bir istek, ayrı bir görev durumu sorgulama endpoint'i olmadan tamamlanmış transkripti doğrudan döndürür.
Hangi varyantla başlamalıyım?
Kalite beklentinizi karşılayan en uygun fiyatlı varyantı seçin. Çoğu ekip hızlı varyantla başlar ve üretimde pro sürüme geçer.
Ücretsiz bir katman var mı?
Yeni hesaplar her modelde ilk çağrıları ücretsiz alır. Sonrasında çağrı başına ödeme yaparsınız.
Sonuçları streaming olarak sunuyor musunuz?
Streaming desteklendiğinde RunAPI uçtan uca streaming sağlar.
Başarısız işlemler nasıl ücretlendirilir?
Başarısız üretimler ücretlendirilmez.
Çıktılar önbelleğe alınıyor mu?
Üretilen çıktılar saklanır ve görev ID’siyle geri alınabilir. Girdiler önbelleğe alınmaz.
Ticari kullanım yapabilir miyim?
Evet — bir model lisansı bunu açıkça kısıtlamadıkça ticari kullanım tüm varyantlarda dahildir; kısıtlamalar varyant sayfasında belirtilir.
Oran limitleri ne durumda?
Anahtar bazlı oran limitleri kullanım kademesine göre ölçeklenir. Güncel limitler için fiyatlandırma sayfasına bakın.
Sorunları nereye bildirebilirim?
Herkese açık GitHub reposunda bir issue açın veya destek ekibine e-posta gönderin.