Transkripsi audio
Berikan audio base64 di input_audio.data dan format aslinya.
Di halaman ini
https://api.shareai.now/api/v1/audio/transcriptionsTranskripsi audio
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
Berikan audio base64 dalam input_audio.data dan durasi sebenarnya format. Bahasa yang didukung, prompt, format respons, dan opsi penanda waktu bergantung pada model. Endpoint JSON ini tidak menerima unggahan file multipart. Respons berisi transkripsi dan laporan penggunaan.
Sebelum Anda memulai#
Atur SHAREAI_API_KEY di server Anda dan ganti placeholder model dengan model yang saat ini diaktifkan. Jangan pernah mengekspos kunci API dalam kode browser. Model, akun, kredensial, dan penyedia semuanya harus mengizinkan operasi ini. Pengaturan opsional di bawah ini memerlukan dukungan model; batas keamanan API bukanlah janji bahwa setiap model mendukung setiap nilai.
Kirim permintaan#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/transcriptions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_TRANSCRIPTION_MODEL',
'input_audio': {'data': 'UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
'format': 'wav'}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/transcriptions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/audio/transcriptions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
"input_audio": {
"data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"format": "wav"
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Contoh ini berisi file WAV kecil tanpa suara hanya untuk menunjukkan transportasi base64 yang valid. Ganti input_audio.data dengan base64 standar dari file audio Anda sendiri; untuk Python gunakan base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). Jangan tempelkan URL audio ke dalam bidang ini.
Bidang permintaan#
| Bidang | Tipe | Makna dan batasan |
|---|---|---|
model diperlukan | string | Pengidentifikasi model publik yang diaktifkan secara tepat. Harus mendeklarasikan operasi ini dan diizinkan oleh kredensial Anda. |
input_audio diperlukan | objek | Data dan format yang diperlukan. data adalah base64 standar dari byte audio sebenarnya; format harus sesuai. Hanya JSON; multipart tidak didukung. Tarif durasi memerlukan WAV, MP3, atau FLAC dengan timebase yang diketahui, dengan durasi gabungan maksimal 600 detik. |
language | string | Kode bahasa opsional yang didukung model. |
prompt | string | Konteks transkripsi opsional yang didukung model; bukan prompt untuk menghasilkan audio. |
response_format | string | Format respons yang didukung model, maksimal 100 karakter. Operasi menentukan apakah hasilnya berupa JSON atau biner. |
timestamp_granularities | array | Nilai granularitas penanda waktu opsional yang didukung model. Ketersediaan bergantung pada format respons dan model. |
provider | objek | Preferensi routing penyedia opsional. Gunakan provider.only untuk tag penyedia yang diterima, bukan awalan dalam ID model. Pembatasan akun dan kredensial tetap berlaku. |
Baca hasilnya#
Keberhasilan mengembalikan HTTP 200 dengan JSON. Berikan audio base64 dalam input_audio.data dan durasi sebenarnya format. Bahasa yang didukung, prompt, format respons, dan opsi penanda waktu bergantung pada model. Endpoint JSON ini tidak menerima unggahan file multipart. Respons berisi transkripsi dan laporan penggunaan.
Unit penagihan#
Transkripsi menggunakan durasi yang dipublikasikan model dan/atau tarif token. Detik dan token yang dilaporkan oleh Provider tetap menjadi pengukuran terpisah. Panjang base64 bukanlah durasi audio atau jumlah token. Tarif durasi input memerlukan WAV, MP3, atau FLAC yang dapat mendeskripsikan dirinya sendiri dengan durasi gabungan maksimal 600 detik; timebase PCM mentah atau tidak diketahui tidak diterima untuk penetapan harga durasi.
Pilih pengidentifikasi model yang diaktifkan secara tepat dari Console. Operasi yang dideklarasikan dan kemampuan input/output-nya harus sesuai dengan endpoint ini; model chat teks tidak dapat diganti untuk operasi lain. Pembatasan kredensial, penyedia, dan akun Anda tetap berlaku.
Harga dan penggunaan#
Tarif diterbitkan dalam kredit AI EUR untuk model, penyedia, unit, dan varian yang dipilih. Hanya dimensi dalam tarif aktifnya yang dikenakan biaya. Perkiraan akan memesan kredit sebelum eksekusi; biaya akhir menggunakan penggunaan yang terukur. Harga dapat bergantung pada resolusi, format output, atau rentang penggunaan. Periksa Penggunaan di Console untuk debit ShareAI akhir. Bidang biaya hulu dan byte media tidak diubah menjadi jumlah token yang diciptakan.
Akses dan kesalahan#
Gunakan inference untuk inferensi biaya jaringan yang disetujui atau monetization_gateway untuk markup Builder yang disetujui dan ketentuan penagihan yang diterima. Akses hanya identitas tidak mengizinkan pengeluaran. Validasi, otorisasi model, kredit yang tidak mencukupi, batasan tarif, dan kegagalan eksekusi mengembalikan struktur error. Setelah batas waktu atau pengiriman yang tidak pasti, periksa Penggunaan atau pekerjaan video sebelum membuat permintaan lain yang mungkin berbayar.
Terakhir diperbarui 3 November 2026