Transcrie audio
Furnizează audio în format base64 în input_audio.data și în formatul său real.
Pe această pagină
https://api.shareai.now/api/v1/audio/transcriptionsTranscrie audio
- URL de bază
https://api.shareai.now- Autentificare
- Cheie API Bearer sau token de acces OAuth aprobat
- Scop necesar
inferenceormonetization_gateway
Furnizează audio în format base64 în input_audio.data și în formatul său real format. Limbile suportate, comenzile, formatele de răspuns și opțiunile de timestamp depind de model. Acest endpoint JSON nu acceptă încărcări de fișiere multipart. Răspunsul conține transcrierea și utilizarea raportată.
Înainte de a începe#
Setează SHAREAI_API_KEY pe serverul tău și înlocuiește placeholder-ul modelului cu un model activat în prezent. Nu expune niciodată cheia API în codul browserului. Modelul, contul, acreditivul și providerul trebuie să permită această operațiune. Setările opționale de mai jos necesită suportul modelului; limitele de siguranță ale API-ului nu garantează că fiecare model suportă fiecare valoare.
Trimite o cerere#
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);Exemplul conține un fișier WAV mic și silențios doar pentru a demonstra transportul valid în format base64. Înlocuiește input_audio.data cu base64 standard al propriului fișier audio; pentru Python folosește base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). Nu lipi un URL audio în acest câmp.
Câmpuri cerere#
| Câmp | Tip | Semnificație și limite |
|---|---|---|
model necesar | șir | Identificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău. |
input_audio necesar | obiect | Câmpuri necesare pentru date și format. data este base64 standard al octeților audio reali; formatul trebuie să corespundă. Doar JSON; multipart nu este suportat. Tarifele pe durată necesită WAV, MP3 sau FLAC cu o bază de timp cunoscută, de cel mult 600 de secunde combinate. |
language | șir | Cod opțional pentru limbile suportate de model. |
prompt | șir | Context opțional de transcriere suportat de model; nu este o comandă pentru generarea audio. |
response_format | șir | Format de răspuns suportat de model, de cel mult 100 de caractere. Operațiunea determină dacă rezultatul este JSON sau binar. |
timestamp_granularities | array | Valori opționale pentru granularitatea timestamp-urilor suportate de model. Disponibilitatea depinde de formatul răspunsului și de model. |
provider | obiect | Preferințe opționale de rutare ale providerului. Utilizează provider.only pentru tag-uri de provider acceptate, nu un prefix în ID-ul modelului. Restricțiile contului și acreditivului se aplică în continuare. |
Citește rezultatul#
Succesul returnează HTTP 200 cu JSON. Furnizează audio în format base64 în input_audio.data și în formatul său real format. Limbile suportate, comenzile, formatele de răspuns și opțiunile de timestamp depind de model. Acest endpoint JSON nu acceptă încărcări de fișiere multipart. Răspunsul conține transcrierea și utilizarea raportată.
Unități de facturare#
Transcrierea utilizează durata publicată a modelului și/sau tariful pe token. Secundele și tokenii raportați de Provider rămân măsurători separate. Lungimea base64 nu reprezintă o durată audio sau un număr de tokeni. Tarifele pe durata de intrare necesită WAV, MP3 sau FLAC auto-descriptive cu o durată combinată de cel mult 600 de secunde; bazele de timp necunoscute sau PCM brute nu sunt acceptate pentru tarifarea pe durată.
Alege identificatorul exact al modelului activat din Console. Operațiunea declarată și capacitățile de intrare/ieșire trebuie să se potrivească cu acest endpoint; un model de chat text nu poate fi substituit pentru o altă operațiune. Restricțiile acreditivului, providerului și contului tău se aplică în continuare.
Prețuri și utilizare#
Tarifele sunt publicate în credite AI EUR pentru modelul, providerul, unitățile și variantele selectate. Sunt taxate doar dimensiunile din tariful său activ. O estimare rezervă credite înainte de execuție; taxele finale utilizează utilizarea măsurată. Prețurile pot depinde de rezoluție, formatul de ieșire sau un interval de utilizare. Verifică Console Usage pentru debitul final ShareAI. Câmpurile de cost upstream și byte-urile media nu sunt convertite în număr de token inventat.
Acces și erori#
Utilizează inference pentru inferență aprobată cu costuri de rețea sau monetization_gateway pentru un adaos aprobat de Builder și termeni de facturare acceptați. Accesul doar pe bază de identitate nu autorizează cheltuieli. Validarea, autorizarea modelului, creditele insuficiente, limitele de rată și eșecurile de execuție returnează un error. După un timeout sau o trimitere incertă, inspectează Usage sau job-ul video înainte de a crea o altă cerere potențial plătită.
Ultima actualizare noiembrie 3, 2026