VocalStack Logo

Documentation

เรียกข้อมูลการแปลภาษา

เอาข้อมูลจากงานที่รอการตีพิมพ์หรืองานที่เสร็จสมบูรณ์ นี่รวมถึงเวลาในการแปล คำสำคัญ สรุป และส่วนของย่อหน้า

เขียนจากไมโครโฟนหรือ LiveStream

เขียนคำพูดสดจากไมโครโฟน หรือสตรีมสด เชื่อมต่อกับ Polyglot เพื่อสร้างลิงค์สาธารณะที่สามารถแบ่งปันได้สำหรับการแปลที่ผู้ใช้สามารถอ่านได้ในภาษาใดก็ได้

วาระการแปลภาษา

ติดตามและจัดการสถานะการแปลภาษาด้วยเซสชั่น การใช้วาระงาน คุณสามารถเชื่อมต่อกลับไปยังการเชื่อมต่อแบบไม่ซักซ้อมที่สร้างไว้ก่อนหน้านี้ได้

เปลี่ยนแปลการแปลเป็นภาษาอื่น

แปลข้อความที่บันทึกไว้เป็นภาษาอื่น สามารถทำได้สำหรับการแปลภาษาใด ๆ รวมถึงการแปลภาษาที่บันทึกไว้ล่วงหน้า การแปลภาษาสด หรือการแปลภาษาในเซสชั่น Polyglot

เขียนเสียงจากที่อยู่ URL

เขียนคำพูดจากเสียงที่บันทึกไว้ก่อนหน้านี้ใน URL เป็นข้อความธรรมดา รองรับรูปแบบแฟ้มหลักๆ เช่น MP3, WAV, FLAC และ OGG

ตัวยืนยันความถูกต้องด้านไคลเอนต์

คำขอและคำตอบการแปลภาษา

ตัวเลือกการร้องขอและคำตอบที่ใช้กันทั่วไปสำหรับปฏิบัติการแปลภาษาทั้งหมด ใช้ตัวเลือกเพื่อปรับแต่งการตั้งค่าการแปลภาษา

เขียนและนำเสนอวาระการทำงานหลายภาษาName

สร้างวาระการทำงานที่สามารถใช้ในการถ่ายทอดสด ผ่านลิงค์สาธารณะที่สามารถแบ่งปันได้ ผู้ใช้สามารถอ่านการแปลภาษาในภาษาที่พวกเขาชอบ และแม้แต่การแปลภาษาในอดีต เมื่อวาระงานของคุณไม่ทำงาน

ตัวยืนยันความถูกต้องด้านไคลเอนต์

แสดงเอกสาร
สร้างการตรวจสอบสิทธิ์ชั่วคราวสำหรับคำร้องขอด้านไคลเอนต์ ประมวลผลคำร้องขอ API อย่างปลอดภัยในเว็บเบราว์เซอร์โดยไม่เปิดเผยกุญแจ API ของคุณ.
เครื่องหมายการตรวจสอบสิทธิ์เป็นเครื่องมือที่สำคัญในการป้องกันในสภาพแวดล้อมของคลาวด์ ที่คุณต้องการบริการ VocalStack API คุณจะต้องใช้ตัวเลือกนี้เมื่อคุณต้องการใช้ API ในเบราว์เซอร์, แอพพลิเคชั่น หรือสภาพแวดล้อมสาธารณะอื่น ๆ.

กำลังสร้างโทเค็นการตรวจสอบสิทธิ์

ด้านเซิร์ฟเวอร์ เราสามารถใช้ SDK เพื่อสร้าง ตัวแทนการรับรอง โดยปริยาย ตัวเลือกสำหรับโทเค็นจะถูกจำกัด คุณอาจต้องการปรับปรุงให้เหมาะสมกับความต้องการของคุณ:
  • access: "อ่านเฉพาะ" หรือ "อ่าน- เขียน" ก่อนหน้านี้คุณสามารถเรียกใช้ API ที่ส่งข้อมูลกลับมาได้ ตัวที่2ทำให้คุณสามารถทำคำร้องขอ API ได้ด้วย ซึ่งรวมถึงการปฏิบัติการที่เกี่ยวข้องกับการแปลที่ต้องเสียค่าใช้จ่าย ค่าปริยายของตัวเลือกนี้คือ "อ่านได้เท่านั้น".
  • lifetime_s: ตัวเลขระหว่าง 1 และ 120 แสดงอายุของโต๊กเกอร์ในวินาที หลังจากช่วงเวลานี้ ตราสารจะหมดอายุ และจะไม่สามารถใช้ได้อีกต่อไป ข้อควรจำว่า นี่จะไม่ส่งผลต่อการร้องขอแบบไม่ติดตามเวลาที่เริ่มใช้โทเค็นนี้แล้ว (หมายความว่า เมื่อมีการเริ่มต้นคำร้องขอแบบไม่ซ้ำกันแล้ว มันจะทำงานจนเสร็จสมบูรณ์ แม้ว่า โต๊กเกอร์จะหมดอายุหลังจากที่คำร้องขอเริ่มต้นขึ้น ค่าปริยายสำหรับตัวเลือกนี้คือ 10 นาที.
  • one_time: บูลลี่ที่แสดงว่า API ตัวนี้จะใช้ได้เพียงครั้งเดียวหรือไม่ หากเป็นจริง เมื่อโทเค็นนี้ถูกใช้ในการร้องขอ API มันจะหมดอายุ ค่าปริยายของตัวเลือกนี้คือ จริง.
นี่คือสิ่งที่จะปรากฏบนเซิร์ฟเวอร์ของคุณ:
JavaScript
import { Security } from '@vocalstack/js-sdk';

const sdk = new Security({ apiKey: 'YOUR-API-KEY' });

const authToken = await sdk.generateToken({
  access: 'readwrite', // Optional: 'readonly' or 'readwrite'
  lifetime_s: 60, // Optional: 1-120 seconds
  one_time: true, // Optional: true or false
});

// Next, return the token to the client where API request will be made.
// Make sure to keep the token secure and do not expose it to the public.
คุณจะต้องจัดตั้งกลไก เพื่อให้บริการ API ของคุณ เซิร์ฟเวอร์สร้าง โต๊ะสำหรับลูกค้าของคุณ. มันขึ้นอยู่กับโครงสร้างพื้นฐานและเทคโนโลยีของคุณ ทำความแน่ใจว่าคุณได้ใช้วิธีการป้องกันที่ดีที่สุด ตัวอย่างเช่น คุณไม่ควรสร้างจุดสิ้นสุดของ API ที่ให้บริการ API ที่มีการสร้างเพื่อคำร้องขอที่ยังไม่ได้รับการตรวจสอบสิทธิ์.

ใช้ตัวยืนยันการเข้ารหัส

การใช้ API ของ VocalStack ในด้านคลาวด์ จะต้องใช้. authToken ตั้งค่าแทน apiKey.ยกตัวอย่างเช่น ลองพิจารณาเอกสารสำหรับ เขียนเสียงจากที่อยู่ URL.
ตัวอย่างนี้ใช้แทน:
{ apiKey: 'YOUR-API-KEY' } ด้วย { authToken: 'YOUR-AUTH-TOKEN' } 6
JavaScript
import { UrlTranscription } from '@vocalstack/js-sdk';

const authToken = await fetch('http://example.com/your-secured-api/authenticate')
  .then((response) => response.json())
  .then((data) => data.token);

const sdk = new UrlTranscription({ authToken });
const transcription = await sdk.connect({ url: 'http://example.com/speech.mp3' });

transcription.start();

ความปลอดภัย

เมื่อสร้างและให้บริการ ตัวแทนการตรวจสอบความถูกต้องของลูกค้า มันเป็นสิ่งสำคัญที่จะต้องใช้มาตรการความปลอดภัยที่เข้มงวด เพื่อป้องกันการเข้าถึง API ของคุณโดยไม่ได้รับอนุญาต เครื่องหมายเป็นเครื่องมือที่ทรงพลัง ในการเข้าถึงทรัพยากรและบริการ และถ้าพวกเขาไม่ได้รับการปกป้อง พวกเขาสามารถถูกใช้ผิด คุณต้องทำความแน่ใจว่า มีเพียงลูกค้าที่ได้รับอนุญาตเท่านั้น ที่สามารถขอและใช้โทเค็น และคุณไม่ควรเปิดเผยข้อมูลที่มีความเสี่ยง เช่นกุญแจ API ในสภาพแวดล้อมสาธารณะ หากไม่ทำเช่นนั้น อาจจะทำให้เกิดการละเมิดข้อมูล เข้าถึงทรัพยากรโดยไม่ได้รับอนุญาต หรือค่าใช้จ่ายที่ไม่คาดคิดสำหรับบริการที่ต้องชำระ.
เพื่อช่วยให้การปฏิบัติงานของคุณปลอดภัย โปรดพิจารณาวิธีการที่ดีที่สุดต่อไปนี้:
  • อย่าเปิดเผยกุญแจ API ของคุณในด้านไคลเอนต์: กุญแจ API จำเป็นต้องเป็นความลับ และเก็บไว้อย่างปลอดภัยบนเซิร์ฟเวอร์ ปล่อยให้พวกเขาอยู่ในโค้ดด้านคลาวด์ ท่าน แจ๊วสคริปต์, HTML) อาจนำไปสู่การเข้าถึง API ที่ไม่ได้รับอนุญาต.
  • ใช้การสร้างโทเค็นด้านเซิร์ฟเวอร์ที่ปลอดภัย: สร้างการตรวจสอบสิทธิ์บนเซิร์ฟเวอร์เสมอเพื่อป้องกันการเปิดเผยกุญแจ API ในโค้ดของคลาวด์.
  • คำขอการตรวจสอบสิทธิ์สำหรับโทเค็น: ทำให้แน่ใจว่ามีเพียงผู้ใช้หรือบริการที่ได้รับการตรวจสอบสิทธิ์เท่านั้นที่สามารถขอ API token โดยใช้กลไกการตรวจสอบสิทธิ์ (e. g. ท่าน , OAuth, การตรวจสอบวาระงาน).
  • ใช้ HTTPS: บริการโทเค็นผ่าน HTTPS เสมอเพื่อป้องกันการโจมตีของผู้คนในช่วงกลาง.
  • หลีกเลี่ยงการเปิดเผยตัวแทนในที่อยู่ URL: อย่าส่งสัญลักษณ์ในพารามิเตอร์คำถาม URL เพราะมันอาจจะถูกบันทึกในบันทึกของเซิร์ฟเวอร์ หรือถูกเปิดเผยในประวัติการค้นหา.
  • ขอบเขตการจำกัดของโทเค็น: จำกัดสิทธิ์ในการใช้งานของโต๊กเกอร์ให้อยู่ในระดับที่จำเป็นอย่างน้อย เช่น สิทธิ์อ่าน-เท่านั้น เว้นแต่ว่าสิทธิ์ในการเขียนจะถูกเรียกร้องอย่างชัดเจน.
  • ตั้งค่าเวลาหมดอายุของสัญลักษณ์: ใช้เวลาใช้งานที่สัมผัสได้ ลดความเสี่ยงในการใช้โทเค็นผิดๆ พิจารณาการจำกัดอายุของโทเค็น ขึ้นอยู่กับรูปแบบการใช้งานและความต้องการด้านความปลอดภัย.
  • เปิดใช้การใช้งานครั้งเดียว: หากเป็นไปได้ ให้ใช้ โต๊กเกอร์ สำหรับ กิจกรรมที่มีความอ่อนไหวอย่างยิ่ง เพื่อ ทำให้แน่ใจว่า พวกเขาจะไม่สามารถใช้ได้อีก.
Scroll Up