Giriş
API Endpoint
https://api.linguo.app/v1/
Linguo API kullanmak için ihtiyaç duyacağınız bilgileri bu dökümanda sizler için topladık. Navigasyon bölmesinden bilgi almak istediğiniz servislere gidebilir örnek istekleri, cevapları ve istek parametrelerini detaylıca görebilirsiniz. Servisin size dönmüş olduğu cevaptaki ilgili nesneyi cevaplar kısmında nesnenin ismine tıklayarak detaylı bir şekilde inceleyebilir her bir özelliğiyle ilgili detaylı açıklamalar bulabilirsiniz.
API ile ilgili tüm sorularınız için bizimle linguo@adresgezgini.com adresimiz üzerinden iletişime geçebilirsiniz. Sizlere yardımcı olmaktan mutluluk duyarız.
Create
İşlenmesini istediğiniz ses dosyanızı bu method yardımı ile gönderebilirsiniz :
https://api.linguo.app/v1/create
//Örnek Çıktı :
{
"status": 1,
"request_id": "kwwpzmm2znkclwd2gqytg776"
}
Headers Parametreleri
| Header | Value |
|---|---|
| authorization | <api key> |
| Content-type | application/x-www-form-urlencoded |
Body Parametreleri
| Field | Açıklama |
|---|---|
| file | Ses dosyasının url adresi |
| customID (Opsiyonel) | Manuel ID Gönderilebilir. |
| speaker_diarization (Opsiyonel Default : 0) | 1 => Konuşmacı Güncesi Çıktı Üretir, 0 => Konuşmacı Güncesi Çıkartmaz |
Get
# Örnek Sorgu
curl -X POST \
https://api.linguo.app/v1/get \
-H 'authorization: 49eas3e006dab8d28exxxxaff8e5b0b929c04ba' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'request_id=kwwpzmm2znkclwd2gqytg776&esto=1'
#GET
import requests
url = 'https://api.linguo.app/v1/get'
payload = {
'request_id': 'kwwpzmm2znkclwd2gqytg776',
'esto' : 1
}
headers = {
'authorization': "49eas3e006dab8d28exxxxaff8e5b0b929c04ba",
'content-type': "application/x-www-form-urlencoded",
'cache-control': "no-cache"
}
response = requests.post(url, headers=headers, data=payload)
print(response.text)
Gönderilen ses dosyasının create methodunda geri gönderilen request_id ile sorgulanması:
https://api.linguo.app/v1/get
//GET Örnek Çıktı
{
"metadata": {
"request_id": "kwwpzmm2znkclwd2gqytg776",
"custom_id": null,
"file_url": "https://panel.linguo.app/uploads/requestsMp3/q4jin053gxdwrf4vf66mt0.mp3",
"duration": 63.565,
"speech_duration": 63.565,
"sampling_rate": 16000,
"status": "Done"
},
"response": {
"@type": "linguo.app.wav2vec2.20220111.v1",
"result": [
{
"alternatives": [
{
"transcript": "edilen bir bakgal vardı hemen hemen hiç odada durmaz koridorda jandarmalarla ahbaplık ederdi hasta olmadığı ve uzun zamandır burda yattığı için hademeler ve jandarmalarla arası peki iydi ve günlük esrarını tedarikte hiç sıkıntı çekmiyordu onu netesinde rüşfet ve yolsuzluktan iki buçuk seneye mahkum eski icra memuru süleyman efendi yatıyordı hastadığı zatürreydi fakat ihtiyarlığına rağmen tehlikeye atlatmış görünüyordu genç dahili müteassısı sabahları vizit ede gülerek sırtını orkuşuyor ve yakayı kurtırıyorsun bey baba diyordu diğer iki hasta adam vurmaktan 15 er seneye mahkum iki köylüydü biri hasmını öteki su meselesinden tarla komşusunu öldürmüştü her ikisi de bi türlü iyi olmayan bi barsak astalığı çekiyorlerdi mütis zayıflıkları ve sapserı yüzleri onları insanı şaşırtıcak kadar birbirine benzetiyordu oda "
}
]
}
]
}
}
//GET ESTO Örnek Çıktı
{
"metadata": {
"request_id": "kwwpzmm2znkclwd2gqytg776",
"custom_id": null,
"file_url": "https://panel.linguo.app/uploads/requestsMp3/q4jin053gxdwrf4vf66mt0.mp3",
"duration": 63.565,
"speech_duration": 63.565,
"sampling_rate": 16000,
"status": "Done"
},
"response": {
"@type": "linguo.app.wav2vec2.20220111.v1",
"result": [
{
"alternatives": [
{
"transcript": "edilen bir bakgal vardı hemen hemen hiç odada durmaz koridorda jandarmalarla ahbaplık ederdi hasta olmadığı ve uzun zamandır burda yattığı için hademeler ve jandarmalarla arası peki iydi ve günlük esrarını tedarikte hiç sıkıntı çekmiyordu onu netesinde rüşfet ve yolsuzluktan iki buçuk seneye mahkum eski icra memuru süleyman efendi yatıyordı hastadığı zatürreydi fakat ihtiyarlığına rağmen tehlikeye atlatmış görünüyordu genç dahili müteassısı sabahları vizit ede gülerek sırtını orkuşuyor ve yakayı kurtırıyorsun bey baba diyordu diğer iki hasta adam vurmaktan 15 er seneye mahkum iki köylüydü biri hasmını öteki su meselesinden tarla komşusunu öldürmüştü her ikisi de bi türlü iyi olmayan bi barsak astalığı çekiyorlerdi mütis zayıflıkları ve sapserı yüzleri onları insanı şaşırtıcak kadar birbirine benzetiyordu oda ",
"sentences": [
{
"start_time": 0,
"end_time": 1.085,
"text": "edilen bir bakgal vardı "
},
{
"start_time": 2.233,
"end_time": 6.407,
"text": "hemen hemen hiç odada durmaz koridorda jandarmalarla ahbaplık ederdi "
},
{
"start_time": 7.452,
"end_time": 13.095,
"text": "hasta olmadığı ve uzun zamandır burda yattığı için hademeler ve jandarmalarla arası peki iydi "
},
{
"start_time": 13.805,
"end_time": 17.255,
"text": "ve günlük esrarını tedarikte hiç sıkıntı çekmiyordu "
},
{
"start_time": 18.686,
"end_time": 25.467,
"text": "onu netesinde rüşfet ve yolsuzluktan iki buçuk seneye mahkum eski icra memuru süleyman efendi yatıyordı "
},
{
"start_time": 26.352,
"end_time": 27.621,
"text": "hastadığı zatürreydi "
},
{
"start_time": 28.338,
"end_time": 31.707,
"text": "fakat ihtiyarlığına rağmen tehlikeye atlatmış görünüyordu "
},
{
"start_time": 32.638,
"end_time": 37.489,
"text": "genç dahili müteassısı sabahları vizit ede gülerek sırtını orkuşuyor ve "
},
{
"start_time": 38.359,
"end_time": 39.948,
"text": "yakayı kurtırıyorsun bey baba "
},
{
"start_time": 40.491,
"end_time": 40.841,
"text": "diyordu "
},
{
"start_time": 41.925,
"end_time": 46.308,
"text": "diğer iki hasta adam vurmaktan 15 er seneye mahkum iki köylüydü "
},
{
"start_time": 47.211,
"end_time": 51.496,
"text": "biri hasmını öteki su meselesinden tarla komşusunu öldürmüştü "
},
{
"start_time": 52.337,
"end_time": 55.864,
"text": "her ikisi de bi türlü iyi olmayan bi barsak astalığı çekiyorlerdi "
},
{
"start_time": 56.748,
"end_time": 62.376,
"text": "mütis zayıflıkları ve sapserı yüzleri onları insanı şaşırtıcak kadar birbirine benzetiyordu "
},
{
"start_time": 63.477,
"end_time": 63.565,
"text": "oda "
}
]
}
]
}
]
}
Headers Parametreleri
| Header | Value |
|---|---|
| authorization | <api key> |
| Content-type | application/x-www-form-urlencoded |
Body Parametreleri
| Field | Açıklama |
|---|---|
| request_id | Sorgu ID |
| esto (Opsiyonel Default : 0) | 1 => Zaman Damgalı Çıktı Üretir, 0 => Zaman Damgasız Çıktı |
| speaker_diarization (Opsiyonel Default : 0) | 1 => Konuşmacı Güncesi Çıktı İle Gelir, 0 => Konuşmacı Güncesi Çıkarmaz |
LIST
# Örnek Sorgu
curl -X POST \
https://api.linguo.app/v1/list \
-H 'authorization: 49eas3e006dab8d28exxxxaff8e5b0b929c04ba' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'start_date=2022-01-1%2000%3A00%3A00&end_date=2022-03-14%2023%3A59%3A59&esto=1'
#LIST
url = 'https://api.linguo.app/v1/list'
payload = {
'start_date': '2022-01-01',
'end_date': '2022-01-02',
'esto': 1
}
headers = {
'authorization': "49eas3e006dab8d28exxxxaff8e5b0b929c04ba",
'content-type': "application/x-www-form-urlencoded",
'cache-control': "no-cache"
}
response = requests.post(url, headers=headers, data=payload)
print(response.text)
İstenilen tarihler arasında işlenmiş olan verilerin çekimi için kullanılacak metoddur.
https://api.linguo.app/v1/list
//LIST
{
"totalResponse": 2,
"page": 1,
"results": [
{
"metadata": {
"request_id": "6ebvo3grpi3cknn4gqvk867p",
"custom_id": null,
"file_url": "https://panel.linguo.app/uploads/requestsMp3/alm2gklsyt3vf88ky.mp3",
"duration": 70.597,
"speech_duration": 70.597,
"sampling_rate": 16000,
"status": "Done"
},
"response": {
"@type": "linguo.app.wav2vec2.20220111.v1",
"result": [
{
"alternatives": [
{
"transcript": "direr taşının üstüne oturup beklemeye ve itrafımıza bakınmaya başladık kamyonun durduğu yerin biraz ilersinde yolun kenarında iki çadır ve bunların etrafında bikaç kaz makürekle bi el arabası vardı daha uzak tersa tashkurmakla vekuom taşımakla meşgul bir miktar yolameresi görülüyordu güneş arkanızıdaki sırta gömirti küçe karşı taraftaki tepeğin üzerine serbirmiş bulunan çamağaçlarına git gide kırmızılaşan bir ışık yoluyor badeyy su ratle rtan biloşlağ terk ediyordu selim bi ilkbahar günüydü ve orta yerde hakan küçük dermarıltıya benzerseslerini duyurmaya başlıyordu yoldan birkaç araba ve otomobil delip geçti bizim kamyonun yanında biraz durdular ve şofere bişi lazım mı diye sordular içerisinde boş yer bulunan bikamiyon vakit geçtikçe telaşları artan mütema diyen şoföre söylenen bizim yolculardan iki kadına aldı konya ya götürdü diğer yolcular grup grup oturmuşlar bişiyler anlatıyorlardı "
}
]
}
]
}
},
{
"metadata": {
"request_id": "kwwpzmm2znkclwd2gqytg776",
"custom_id": null,
"file_url": "https://panel.linguo.app/uploads/requestsMp3/q4jin053gxdwrf4vf66mt0.mp3",
"duration": 63.565,
"speech_duration": 63.565,
"sampling_rate": 16000,
"status": "Done"
},
"response": {
"@type": "linguo.app.wav2vec2.20220111.v1",
"result": [
{
"alternatives": [
{
"transcript": "edilen bir bakgal vardı hemen hemen hiç odada durmaz koridorda jandarmalarla ahbaplık ederdi hasta olmadığı ve uzun zamandır burda yattığı için hademeler ve jandarmalarla arası peki iydi ve günlük esrarını tedarikte hiç sıkıntı çekmiyordu onu netesinde rüşfet ve yolsuzluktan iki buçuk seneye mahkum eski icra memuru süleyman efendi yatıyordı hastadığı zatürreydi fakat ihtiyarlığına rağmen tehlikeye atlatmış görünüyordu genç dahili müteassısı sabahları vizit ede gülerek sırtını orkuşuyor ve yakayı kurtırıyorsun bey baba diyordu diğer iki hasta adam vurmaktan 15 er seneye mahkum iki köylüydü biri hasmını öteki su meselesinden tarla komşusunu öldürmüştü her ikisi de bi türlü iyi olmayan bi barsak astalığı çekiyorlerdi mütis zayıflıkları ve sapserı yüzleri onları insanı şaşırtıcak kadar birbirine benzetiyordu oda ",
"sentences": [
{
"start_time": 0,
"end_time": 1.085,
"text": "edilen bir bakgal vardı "
},
{
"start_time": 2.233,
"end_time": 6.407,
"text": "hemen hemen hiç odada durmaz koridorda jandarmalarla ahbaplık ederdi "
},
{
"start_time": 7.452,
"end_time": 13.095,
"text": "hasta olmadığı ve uzun zamandır burda yattığı için hademeler ve jandarmalarla arası peki iydi "
},
{
"start_time": 13.805,
"end_time": 17.255,
"text": "ve günlük esrarını tedarikte hiç sıkıntı çekmiyordu "
},
{
"start_time": 18.686,
"end_time": 25.467,
"text": "onu netesinde rüşfet ve yolsuzluktan iki buçuk seneye mahkum eski icra memuru süleyman efendi yatıyordı "
},
{
"start_time": 26.352,
"end_time": 27.621,
"text": "hastadığı zatürreydi "
},
{
"start_time": 28.338,
"end_time": 31.707,
"text": "fakat ihtiyarlığına rağmen tehlikeye atlatmış görünüyordu "
},
{
"start_time": 32.638,
"end_time": 37.489,
"text": "genç dahili müteassısı sabahları vizit ede gülerek sırtını orkuşuyor ve "
},
{
"start_time": 38.359,
"end_time": 39.948,
"text": "yakayı kurtırıyorsun bey baba "
},
{
"start_time": 40.491,
"end_time": 40.841,
"text": "diyordu "
},
{
"start_time": 41.925,
"end_time": 46.308,
"text": "diğer iki hasta adam vurmaktan 15 er seneye mahkum iki köylüydü "
},
{
"start_time": 47.211,
"end_time": 51.496,
"text": "biri hasmını öteki su meselesinden tarla komşusunu öldürmüştü "
},
{
"start_time": 52.337,
"end_time": 55.864,
"text": "her ikisi de bi türlü iyi olmayan bi barsak astalığı çekiyorlerdi "
},
{
"start_time": 56.748,
"end_time": 62.376,
"text": "mütis zayıflıkları ve sapserı yüzleri onları insanı şaşırtıcak kadar birbirine benzetiyordu "
},
{
"start_time": 63.477,
"end_time": 63.565,
"text": "oda "
}
]
}
]
}
]
}
}
]
}
Headers Parametreleri
| Header | Value |
|---|---|
| authorization | <api key> |
| Content-type | application/x-www-form-urlencoded |
Body Parametreleri
| Field | Açıklama |
|---|---|
| start_date | Başlangıç tarihi |
| end_date | Bitiş tarihi |
| page_number | Sayfa Numarası |
| filter (Opsiyonel Default : 0) | 1 => Sadece request_id'ler döner , 0 => Tüm Sonuçlar Döner |
| esto (Opsiyonel Default : 0) | 1 => Zaman Damgalı Çıktı Üretir, 0 => Zaman Damgasız Çıktı |
| speaker_diarization (Opsiyonel Default : 0) | 1 => Konuşmacı Güncesi Çıktı İle Gelir, 0 => Konuşmacı Güncesi Çıkarmaz |
Delete
# Örnek Sorgu
curl -X POST \
https://api.linguo.app/v1/delete \
-H 'authorization: 49eas3e006dab8d28exxxxaff8e5b0b929c04ba' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d request_id=kwwpzmm2znkclwd2gqytg776
#DELETE
url = 'https://api.linguo.app/v1/delete'
payload = {
'request_id': 'kwwpzmm2znkclwd2gqytg776'
}
headers = {
'authorization': "49eas3e006dab8d28exxxxaff8e5b0b929c04ba",
'content-type': "application/x-www-form-urlencoded",
'cache-control': "no-cache"
}
response = requests.post(url, headers=headers, data=payload)
print(response.text)
İşlenmiş bir verinin silinmesi durumunda kullanılacak methoddur.
https://api.linguo.app/v1/delete
//Örnek Çıktı :
{
"status": 1,
"desc": "Ses veriniz silinmiştir!"
}
Headers Parametreleri
| Header | Value |
|---|---|
| authorization | <api key> |
| Content-type | application/x-www-form-urlencoded |
Body Parametreleri
| Field | Açıklama |
|---|---|
| request_id | Sorgu ID |