คีย์ API ที่เข้ากันได้กับ OpenAI: รับหนึ่งคีย์และส่งคำขอ
คีย์ API ที่เข้ากันได้กับ OpenAI คือโทเคน bearer ธรรมดาที่ทำงานกับ SDK ของ OpenAI ใดๆ ได้เมื่อคุณชี้ client ไปที่ base URL อื่น หน้าเว็บนี้แสดงวิธีรับคีย์สำหรับ API ข้อความที่โฮสต์บนเว็บไซต์นี้และทำการเรียกใช้งานที่ทำงานได้ในไม่กี่นาที
อัปเดตSpeech To Text API

คีย์คืออะไรกันแน่
"OpenAI compatible" อธิบายโครงสร้างของ HTTP API ไม่ใช่บริษัทที่อยู่เบื้องหลัง บริการนี้รับ body JSON เดียวกันบน POST /v1/chat/completions ที่ SDK ของ OpenAI ส่ง และอ่าน header Authorization: Bearer เดียวกัน ด้วยเหตุนี้ คีย์จากบริการนี้จึงสามารถนำไปใช้กับเครื่องมือใดๆ ก็ตามที่อนุญาตให้คุณตั้งค่า base URL และ API key ได้: ไลบรารี Python และ Node ทางการ, LangChain, curl ธรรมดา และไคลเอนต์แชทบนเดสก์ท็อปส่วนใหญ่
คีย์นี้ไม่ใช่คีย์ของ OpenAI และจะไม่ทำงานบน api.openai.com ในทางกลับกันก็เป็นจริงเช่นกัน: คีย์ของ OpenAI จะไม่ทำงานที่นี่ คีย์แต่ละอันเป็นของบริการใดบริการหนึ่ง และบริการนี้รันโมเดล open-weight model เดียว ซึ่งปรับแต่งมาให้ตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานของผู้ใหญ่ที่ถูกต้องตามกฎหมาย โดยโฮสต์โดยผู้ให้บริการอิสระ ไม่ใช่ API ทางการของผู้ขายโมเดลรายใดรายหนึ่ง และไม่ส่งต่อไปยังผู้ขายรายอื่น
สิ่งที่คุณต้องจำคือ base URL ของเว็บไซต์นี้คือ https://api.speechtotextapis.com/v1 model ID คือ uncensored คีย์คือสตริงใดๆ ก็ตามที่คุณได้รับหลังจาก sign up รายละเอียดด้านล่างคือการปรับแต่งจากค่าสามข้อนั้น
บริการนี้ใช้เฉพาะข้อความเท่านั้น จัดการ chat completions, streaming, tool calling และ JSON mode ไม่สร้างภาพหรือเสียง ไม่มี embeddings และไม่ได้ fine-tune โมเดล หากคุณมาที่นี่จาก speech pipeline งานทั่วไปคือขั้นตอนข้อความหลังการถอดความ: ทำความสะอาด transcript, แบ่งเป็นฉาก, เขียนใหม่หรือดึงข้อมูลที่มีโครงสร้าง คู่มือการประมวลผลสคริปต์เสียง ครอบคลุมด้านนั้นในรายละเอียดมากขึ้น
รับคีย์ของคุณในสี่ขั้นตอน
- ลงทะเบียน ใช้ Google หรือลงทะเบียนด้วยที่อยู่อีเมลและรหัสผ่าน
- เปิดหน้า API key มันอยู่ที่ หน้าคีย์ บนเว็บไซต์นี้ คีย์ของคุณจะถูกสร้างและแสดงที่นั่น
- รับเครดิตทดลองใช้ ปุ่มบนหน้าเดียวกันให้เครดิตทดลองใช้ $0.50 เพียงคลิกเดียว ใช้ได้หนึ่งครั้งต่อคน ใช้ได้ 7 วัน และไม่ต้องใช้บัตร
- คัดลอกคีย์ไปยังที่เก็บ secret environment variable เพียงพอสำหรับการทดสอบในเครื่อง สำหรับการใช้งานจริง ให้ใช้ secret manager ของโฮสต์ของคุณ
การทดลองใช้มีไว้เพื่อพิสูจน์ว่าการผสานรวมทำงานได้ก่อนที่คุณจะจ่ายเงิน ในราคาปัจจุบัน มันเพียงพอสำหรับคำขอสั้นๆ จำนวนมาก และส่วนค่าใช้จ่ายด้านล่างแสดงการคำนวณ เมื่อคุณพร้อมที่จะดำเนินการต่อ หน้า ราคา แสดงจำนวนการเติมเงินต่างๆ เครดิตเป็น prepaid credit ไม่มี subscription และเครดิตไม่หมดอายุ ดังนั้นจึงไม่มีแรงกดดันในการใช้การเติมเงินก่อนกำหนดเวลา
คีย์ทดลองมีขีดจำกัดแน่นหนากว่าคีย์เต็ม: คำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที เพียงพอสำหรับสคริปต์แรก หากคุณวางแผนที่จะกระจาย chunk ของ transcript หลายสิบชิ้นแบบขนาน คาดว่าจะชนขีดจำกัดจนกว่าจะย้ายไปยังบัญชีที่มีเงินทุน
การตั้งค่าสามอย่างที่ไคลเอนต์ทุกตัวถามหา
ไม่ว่าคุณจะใช้ซอฟต์แวร์ใด หน้าการตั้งค่าจะถามถึงสิ่งเดียวกันสามอย่างด้วยชื่อที่แตกต่างกันเล็กน้อย
| การตั้งค่า | ชื่อฟิลด์ทั่วไป | ค่า |
|---|---|---|
| เอนด์พอยต์ | Base URL, API base, host | https://api.speechtotextapis.com/v1 |
| ข้อมูลประจำตัว | API key, token, secret | คีย์ของคุณจากหน้าคีย์ |
| โมเดล | Model, model name, engine | uncensored |
รายละเอียดหนึ่งอย่างที่ทำให้คนสับสน: base URL ลงท้ายด้วย /v1 แล้ว SDK จะเพิ่ม /chat/completions ให้เอง ดังนั้นคุณไม่ควรเพิ่มมัน หากไคลเอนต์ของคุณถามหา URL เต็มของ endpoint chat แทน base URL ค่าคือ https://api.speechtotextapis.com/v1/chat/completions
หากเครื่องมือมีเพียง preset "OpenAI" ที่มี host ที่ hard-coded และไม่สามารถแก้ไขได้ มันไม่สามารถสื่อสารกับบริการนี้ได้ ให้มองหาตัวเลือก "custom", "OpenAI-compatible" หรือ "advanced" ที่เปิดเผยฟิลด์ base URL
คำขอครั้งแรกของคุณ
เริ่มด้วย curl เพราะมันตัดทุกชั้นที่คั่นระหว่างคุณกับ API ออก แทนที่ YOUR_KEY ด้วยคีย์ที่คุณคัดลอกมา
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
การตอบกลับที่สำเร็จคือวัตถุ JSON ที่มีอาร์เรย์ choices ข้อความอยู่ใน choices[0].message.content และบล็อก usage จะรายงานจำนวนโทเคนที่คุณถูกเรียกเก็บเงิน
การเรียกใช้เดียวกันด้วยไลบรารี Python ทางการมีลักษณะดังนี้ ค่า base_url และ api_key จะแตกต่างจากการตั้งค่า OpenAI มาตรฐาน
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
และใน Node โดยใช้แพ็กเกจเดียวกัน:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
คุณไม่จำเป็นต้องตั้งค่า max_tokens เมื่อละค่านี้ การสร้างข้อความสามารถใช้โทเคนที่เหลือจากหน้าต่าง 100,000 โทเคนหลังจากพรอมต์ของคุณได้ ตั้งค่าเองหากคุณต้องการกำหนดเพดานสูงสุดของต้นทุนต่อการเรียก
ตรวจสอบว่าคีย์ใช้งานได้โดยไม่ใช้โทเคน
ก่อนนำคีย์ไปเชื่อมต่อกับระบบที่ใหญ่ขึ้น ให้ทำการเรียกโมเดลเอนด์พอยต์หนึ่งครั้งที่มีค่าใช้จ่ายต่ำ การดำเนินการนี้จะยืนยันว่าคีย์ได้รับการยอมรับและ Base URL ถูกต้อง
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
แฟลก -i จะพิมพ์หัวข้อความตอบกลับ ซึ่ง API นี้รายงานสถานะที่มีประโยชน์ที่นั่น:
X-Request-Idระบุคำขอ ให้รวมค่านี้หากคุณติดต่อ ฝ่ายสนับสนุน เกี่ยวกับการเรียกเฉพาะรายการX-Balance-USDแสดงเครดิตคงเหลือในบัญชีX-RateLimit-Limit-RequestsและX-RateLimit-Limit-Concurrencyแสดงขีดจำกัดที่ใช้งานกับคีย์ของคุณ เพื่อให้คุณสามารถระบุได้ทันทีว่าคีย์นั้นมีขีดจำกัดแบบทดลองใช้หรือแบบเต็ม
การอ่านค่า X-Balance-USD ในโค้ดของคุณเองเป็นวิธีที่มีค่าใช้จ่ายต่ำในการแจ้งเตือนตัวเองก่อนที่เครดิตจะหมด หากต้องการหลีกเลี่ยงการแสดงผลที่รบกวน ให้บันทึกค่านี้เพียงครั้งเดียวต่องาน แทนที่จะบันทึกทุกคำขอ
ต้นทุนการใช้งานคีย์
การมีคีย์ไม่มีค่าใช้จ่าย คุณจ่ายสำหรับโทเคน: $0.15 ต่อ 1M โทเคนอินพุต และ $0.50 ต่อ 1M โทเคนเอาต์พุต ซึ่งหักจากเครดิตแบบเติมเงินล่วงหน้า คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน
ตัวอย่างการคำนวณพร้อมการเรียกทำความสะอาด transcript ข้างต้น สมมติว่าพรอมต์มี 1,000 โทเคน และข้อความที่ผ่านการทำความสะอาดแล้วมี 500 โทเคน
- อินพุต: 1,000 / 1,000,000 x $0.15 = $0.00015
- เอาต์พุต: 500 / 1,000,000 x $0.50 = $0.00025
- รวม: $0.0004 ต่อการเรียก
ดังนั้นเครดิตทดลอง $0.50 จึงครอบคลุมการเรียกประมาณ 1,250 ครั้งขนาดนั้น ($0.50 / $0.0004) ตัวเลขของคุณเองจะแตกต่างกันเพราะ transcript มีความยาวต่างกัน แต่วิธีการเหมือนกัน: นับโทเคนเข้า นับโทเคนออก คูณ
เมื่อคุณเติมเงิน ยอดจำนวนเต็มตั้งแต่ $20 ถึง $500 จะได้รับการยอมรับ การเติมเงินจำนวนมากขึ้นมีโบนัส: +5% จาก $50, +10% จาก $100 และ +15% จาก $200 ตัวอย่างเช่น การเติมเงิน $100 จะให้คุณได้เครดิต $110 คุณสามารถชำระเงินด้วยคริปโต (USDT บน TRC20, USDC บน Base)
การเก็บรักษาคีย์ให้ปลอดภัย
คีย์ API คือรหัสผ่านสำหรับเครดิตของคุณ ใครก็ตามที่มีคีย์นี้สามารถใช้จ่ายเครดิตของคุณได้ ดังนั้นให้ปฏิบัติต่อคีย์นี้เหมือนรหัสผ่าน
- เก็บคีย์นี้ให้พ้นจากการควบคุมเวอร์ชันของโค้ด อ่านค่าจากตัวแปรสภาพแวดล้อมหรือตัวจัดการความลับ
- อย่าส่งคีย์นี้ไปกับ JavaScript ในเบราว์เซอร์หรือแพ็กเกจแอปมือถือ ทุกอย่างที่ทำงานบนอุปกรณ์ของผู้ใช้สามารถตรวจสอบได้ ให้มีเซิร์ฟเวอร์ขนาดเล็กคั่นระหว่างส่วนหน้าและ API แล้วให้เซิร์ฟเวอร์เพิ่มเฮดเดอร์
- อย่าวางคีย์นี้ลงในภาพหน้าจอ บัตรงาน หรือข้อความแชท
- หากคุณคิดว่าคีย์ถูกเปิดเผย ให้หยุดใช้งานและติดต่อฝ่ายสนับสนุนทันทีแทนที่จะรอเพื่อดูว่าเกิดอะไรขึ้น
เกี่ยวกับความเป็นส่วนตัว: พรอมต์ที่ส่งไปยัง API จะไม่ถูกใช้ในการฝึกโมเดล นี่เป็นข้อเท็จจริงเกี่ยวกับบริการ ไม่ใช่เหตุผลที่จะส่งข้อมูลลับที่คุณไม่จำเป็นต้องส่ง ควรลบข้อมูลส่วนบุคคลออกจาก transcript เมื่องานนั้นไม่จำเป็นต้องใช้
เมื่อการเรียกใช้ล้มเหลว
ปัญหาส่วนใหญ่ที่เกิดขึ้นในวันแรกมาจากสาเหตุใดสาเหตุหนึ่งจากสี่สาเหตุ
Base URL ผิด
ข้อผิดพลาดสองอย่างที่เกิดขึ้นบ่อยคือ การขาด /v1 และการซ้ำ /chat/completions ให้เปรียบเทียบค่าของคุณทีละตัวอักษรกับค่าในตารางด้านบน
คีย์มีอักขระที่ไม่ต้องการ
การคัดลอกจากหน้าเว็บมักมีช่องว่างหรือบรรทัดใหม่ต่อท้าย ตัดค่าในโค้ดของคุณออก และตรวจสอบว่าหัวเรื่องอ่านว่า Bearer มีช่องว่างหนึ่งช่อง แล้วตามด้วยคีย์
ชื่อโมเดลไม่ใช่ uncensored
ไคลเอนต์มักตั้งค่าเริ่มต้นเป็นชื่อโมเดลอื่น ตั้งชื่อโมเดลอย่างชัดเจนในการเรียกใช้ทุกครั้ง
HTTP 429
มีสองประเภท และรหัสข้อผิดพลาดจะแยกความแตกต่าง rate_limited หมายถึงคุณส่งคำขอมากเกินไปต่อนาที concurrency หมายถึงมีคำขอที่กำลังดำเนินการมากเกินไปพร้อมกัน คำขอแบบสตรีมมิงจะครอบครองช่องการทำงานพร้อมกันไปจนกว่าสตรีมจะสิ้นสุด ดังนั้นผู้อ่านที่ช้าอาจทำให้เกิดข้อผิดพลาดนี้ได้แม้ที่อัตราคำขอต่ำก็ตาม 429 พร้อมหัวเรื่อง Retry-After: 5 หมายถึงบริการกำลังโหลดเกินชั่วคราว; รอห้าวินาทีแล้วลองใหม่ การปรับเวลาหน่วงแบบทวีคูณแบบสั้นๆ ในไคลเอนต์ของคุณจะจัดการทั้งสามกรณีนี้ได้
สำหรับรายการพารามิเตอร์ทั้งหมด รูปแบบสตรีมมิง และรายละเอียดการเรียกใช้เครื่องมือ ดู เอกสาร API
คู่มือเพิ่มเติม
ถาม-ตอบ
นี่เป็นคีย์เดียวกับ OpenAI หรือไม่
ไม่ใช่ รูปแบบคำขอเหมือนกัน ดังนั้น SDK ของ OpenAI จึงใช้งานได้ แต่คีย์นี้ถูกออกโดยบริการนี้และใช้งานได้เฉพาะกับ Base URL ของบริการนี้เท่านั้น
ฉันจำเป็นต้องใช้บัตรเครดิตเพื่อรับคีย์หรือไม่
ไม่ต้อง ลงทะเบียนด้วย Google หรืออีเมล แล้วรับเครดิตทดลองใช้ $0.50 ด้วยคลิกเดียวบนหน้าคีย์ การทดลองใช้ไม่ต้องใช้บัตรและใช้งานได้ 7 วัน
ควรใช้ชื่อโมเดลใด?
ใช้ uncensored ในฟิลด์โมเดล การเรียกใช้ GET /v1/models จะแสดงสิ่งที่คีย์สามารถเข้าถึงได้
คุณสามารถใช้คีย์เดียวกันจากเซิร์ฟเวอร์หลายเครื่องได้หรือไม่
ได้ แต่ขีดจำกัดใช้กับคีย์โดยรวม: คำขอพร้อมกัน 8 คำขอและคำขอ 300 คำขอต่อนาทีสำหรับคีย์เต็ม และ 2 และ 60 สำหรับคีย์ทดลอง
คีย์ใช้งานได้กับรูปภาพหรือเสียงหรือไม่
ไม่ใช่ API เป็นข้อความเท่านั้น ไม่สร้างหรือถอดความเสียงหรือรูปภาพ และไม่มี embeddings หรือ fine-tuning
คีย์ของคุณพร้อมใช้งานแล้ว เพียงกรอกแบบฟอร์มเท่านั้น
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน URL พื้นฐาน นั่นคือการตั้งค่าทั้งหมด