ข้ามไปยังเนื้อหาหลัก

การถอดเสียงอัตโนมัติสำหรับเอเจนต์และสคริปต์

การถอดเสียงอัตโนมัติเปลี่ยนเสียงที่บันทึกไว้เป็นข้อความที่แก้ไขได้ แอปเตรียมเสียงจากวิดีโอบนอุปกรณ์ของคุณ เอเจนต์ส่งเสียงที่เตรียมไว้ผ่าน REST หรือ MCP ได้

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

การถอดเสียงอัตโนมัติทำงานอย่างไร

  1. เตรียมไฟล์บันทึก ใช้ไฟล์เสียง นำเข้าลิงก์เสียงที่รองรับ หรือบันทึกเสียงของคุณในแอปบนเบราว์เซอร์ สำหรับวิดีโอ ให้เลือกไฟล์บนอุปกรณ์เพื่อให้แอปเตรียมเสียงบนอุปกรณ์ของคุณ
  2. ส่งไฟล์และรอข้อความถอดเสียง แอปจัดการการอัปโหลดและสถานะ เอเจนต์อัปโหลดเสียงที่เตรียมไว้เป็นส่วนๆ ผ่าน REST API หรือใช้เครื่องมือ MCP ตามขอบเขตสิทธิ์ แล้วตรวจสอบงานจนข้อความถอดเสียงพร้อม
  3. ตรวจทานและส่งออก แก้ไขข้อความถอดเสียงและป้ายกำกับผู้พูดในแอป หรือดึงข้อความผ่าน API โทเคนของเอเจนต์ส่งออกข้อความถอดเสียงได้ตามขอบเขตสิทธิ์ที่ได้รับด้วย

ซอฟต์แวร์ถอดเสียงอัตโนมัติสำหรับเสียงและวิดีโอ

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

การถอดเสียงวิดีโออัตโนมัติใช้ขั้นตอนทำงานกับข้อความแบบเดียวกัน หลังแอปแยกหรือแปลงเสียงบนอุปกรณ์ ตัวอย่างการอัปโหลดผ่าน REST ด้านล่างเริ่มจากเสียงที่เตรียมไว้ หากต้องการส่งไฟล์วิดีโอบนอุปกรณ์ให้แอปแทน ให้ใช้ขั้นตอนบนเบราว์เซอร์ที่หน้าถอดข้อความจากวิดีโอ

ทดลองถอดเสียงอัตโนมัติฟรีได้ไหม?

ได้ ตัวอย่างสาธารณะถอดเสียงได้สูงสุดห้านาทีจากไฟล์หนึ่งไฟล์ ลิงก์เสียงที่รองรับ หรือการบันทึกเสียงในเบราว์เซอร์ก่อนเข้าสู่ระบบ วิดีโอบนอุปกรณ์ก็ใช้ได้เมื่อเบราว์เซอร์เตรียมเสียงแล้ว การถอดเสียงฉบับเต็มต้องมีบัญชี บัญชีส่วนตัวที่มีสิทธิ์ได้รับ 30 นาทีฟรีหลังยืนยันบัตร (ดูวิธีการที่หน้าราคา) ส่วนบัญชีสำหรับระบบอัตโนมัติไม่มีนาทีต้อนรับ และเริ่มต้นด้วยแพ็กเกจที่ซื้อเมื่อสมัคร

ใช้ API หรือ MCP ทำงานกับข้อความถอดเสียงแบบอัตโนมัติ

แอปบนเบราว์เซอร์ใช้ทำงานกับไฟล์บันทึกโดยตรง สำหรับงานอัตโนมัติ REST API และเซิร์ฟเวอร์ MCP ให้เอเจนต์อัปโหลดเสียงที่เตรียมไว้ ตรวจสอบงาน ดึงข้อความถอดเสียง และส่งออกผลลัพธ์ได้ เอเจนต์เปิดบัญชีของตัวเองด้วยขั้นตอนชำระเงินก่อนโดยไม่ต้องมีบุคคลเป็นเจ้าของบัญชีได้ แต่หน้าชำระเงินที่ผู้ให้บริการโฮสต์ยังต้องใช้เบราว์เซอร์ และผู้ออกบัตรอาจกำหนดขั้นตอนยืนยันตัวตน ผู้ใช้ทั่วไปเลือกสร้างโทเคนที่กำหนดขอบเขตสิทธิ์จากบัญชีที่มีอยู่ในแอปแทนได้ คู่มือนี้อธิบายบัญชีสำหรับระบบอัตโนมัติตั้งแต่สมัครจนถึงเปลี่ยนข้อมูลรับรอง

สมัคร

POST /v1/agent/accounts เริ่มการสมัครแบบไม่ต้องมีหน้าจอผู้ใช้ ขั้นนี้ยังไม่มีบัญชี ไม่มีคุกกี้ และไม่มีโทเคน มีเพียงการซื้อที่รอดำเนินการ

curl -X POST https://api.hushscript.com/v1/agent/accounts \
  -H "Content-Type: application/json" \
  -d '{
    "contact_email": "ops@example-agent.dev",
    "pack_id": "300min",
    "accept_terms_version": "2026-10-20",
    "agent": {
      "name": "research-crawler",
      "platform": "langgraph",
      "contact_url": "https://example-agent.dev/bots/research-crawler"
    }
  }'
{
  "signup_id": "hsr1:eu:4c3a1f9e7b2d4e6f8a0c1b2d3e4f5061",
  "claim_secret": "cs_9f3d2a1b7e6c4f5a8b9d0e1f2a3b4c5d",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_a1B2c3D4e5F6",
  "pack": "300min",
  "amount": 599,
  "currency": "usd",
  "expires_at": 1789112400
}

contact_email ใช้สำหรับใบเสร็จและการแจ้งเตือนเท่านั้น ไม่ใช้เข้าสู่ระบบ pack_id เป็นหนึ่งใน 45min, 300min, 900min, 1800min, 6000min ห้ามส่ง amount หรือ currency เอง เซิร์ฟเวอร์คำนวณทั้งสองค่าจากแพ็กเกจ ซื้อได้เฉพาะสองแพ็กเกจเล็กสุดคือ 45min และ 300min เมื่อสมัคร pack_id ที่ใหญ่กว่านั้นจะถูกปฏิเสธ โดยคำตอบมี details.allowed_packs ระบุแพ็กเกจที่บัญชีซื้อได้ในขณะนั้น ผู้เรียกจึงลองใหม่ได้โดยไม่ต้องเดา แพ็กเกจที่เหลือจะปลดล็อกตามเวลาที่ผ่านไป ไม่ใช่ปริมาณการซื้อ ดูหัวข้อ บัญชีใหม่ซื้ออะไรได้บ้าง ด้านล่าง accept_terms_version ต้องตรงกับเวอร์ชันนโยบายปัจจุบันของเซิร์ฟเวอร์ทุกตัวอักษร มิฉะนั้นคำขอจะล้มเหลวด้วย policy_version_stale ซึ่งระบุค่าปัจจุบันในเนื้อหาคำตอบ ค่า data_region ที่เลือกส่งได้จะมีผลเฉพาะเมื่อตรงกับภูมิภาคที่ตำแหน่งเครือข่ายของคุณบ่งชี้อยู่แล้ว การส่ง dry_run: true เป็นตัวเลือกที่ตรวจสอบทุกอย่างโดยไม่สร้างเซสชัน Stripe และไม่เรียกเก็บเงิน signup_id ของการทดสอบนี้ขึ้นต้นด้วย dry_ และไม่สามารถนำไปเปิดใช้งานบัญชีได้

claim_secret แสดงเพียงครั้งเดียวในคำตอบนี้ Hushscript เก็บเฉพาะค่าแฮช หากทำหายก่อนเรียกเปิดใช้งานบัญชี การสมัครนั้นจะใช้ต่อไม่ได้ ไม่มีวิธีกู้คืนรหัสลับนี้ การสมัครที่ชำระเงินแล้วแต่ยังไม่เปิดใช้งานจะเข้าสู่กระบวนการคืนเงินที่อธิบายด้านล่าง ไม่สามารถกู้คืนผ่านการค้นหาได้

ชำระเงินให้เสร็จในเบราว์เซอร์ของคุณ

checkout_url คือหน้า Stripe Checkout ที่ Stripe โฮสต์ การสมัครต้องใช้เบราว์เซอร์ในขั้นนี้ แต่ไม่จำเป็นต้องเป็นเบราว์เซอร์ของบุคคล เอเจนต์ใช้ระบบอัตโนมัติของตัวเองควบคุมได้ (กรอกข้อมูลบัตร ส่งข้อมูล และตามการเปลี่ยนเส้นทาง) ไม่ว่าจะใช้วิธีใด Hushscript ไม่เห็นรายละเอียดบัตร มีเพียง Stripe ที่เห็น ต้องชำระเงินให้เสร็จแล้วเปิดใช้งานบัญชีภายใน 30 นาที ตามค่า expires_at ด้านบน

กระบวนการตรวจสอบรายชั่วโมงตรวจการสมัครที่ชำระเงินแล้วแต่ยังไม่เปิดใช้งาน หลังพ้นช่วงเปิดใช้งาน 30 นาทีและช่วงผ่อนผันอีกหนึ่งชั่วโมง โดยพยายามคืนเงินเต็มจำนวน เพราะนาทีจะเข้าบัญชีเมื่อเปิดใช้งานเท่านั้น หากคืนเงินไม่สำเร็จจะลองใหม่ และอาจต้องดำเนินการด้วยคน ไม่มีการรับประกันว่าเงินคืนจะมาถึงในเวลาใดเวลาหนึ่ง

เปิดใช้งานบัญชี

POST /v1/agent/accounts/{signup_id}/claim เปลี่ยนการสมัครที่ชำระเงินแล้วแต่ยังไม่เปิดใช้งานให้เป็นบัญชีจริงในคำขอเดียว

curl -X POST https://api.hushscript.com/v1/agent/accounts/hsr1:eu:4c3a1f9e7b2d4e6f8a0c1b2d3e4f5061/claim \
  -H "Content-Type: application/json" \
  -d '{"claim_secret": "cs_9f3d2a1b7e6c4f5a8b9d0e1f2a3b4c5d"}'
{
  "user_id": "usr_7d1a2b3c4d5e6f708192a3b4c5d6e7f8",
  "pat": "hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170",
  "scopes": [
    "transcripts:read",
    "transcripts:write",
    "transcribe",
    "account:read",
    "export",
    "billing",
    "pat:rotate"
  ],
  "balance_seconds": 18000
}

การเปิดใช้งานสร้างบัญชีเพียงหนึ่งบัญชีด้วยตัวตนสำหรับเข้าสู่ระบบที่สร้างขึ้นและไม่มีที่อยู่จริงให้ติดต่อ และมอบแพ็กเกจที่ชำระเงินแล้วเพียงครั้งเดียว ไม่ว่าจะส่งคำขอซ้ำกี่ครั้งก็ตาม โดยออก PAT หนึ่งตัว คือค่า pat ด้านบน

หากคำตอบหายไป ให้เรียกซ้ำด้วย claim_secret เดิม ภายในหนึ่งชั่วโมงหลังการเปิดใช้งาน และตราบใดที่โทเคนที่ออกให้ยังไม่เคยถูกใช้ การเรียกซ้ำจะได้ 201 สำหรับบัญชีเดิม ด้วยโครงสร้างคำตอบเดียวกัน และได้ pat ใหม่ โทเคนที่หายไปจะใช้ไม่ได้อีก หลังจากโทเคนถูกใช้ครั้งแรก หรือเมื่อพ้นหนึ่งชั่วโมงนั้น การเรียกซ้ำจะได้ agent_claim_invalid การเรียกซ้ำที่ซ้อนกับการเปิดใช้งานที่ยังทำงานอยู่อาจได้ 429 rate_limited พร้อมเฮดเดอร์ Retry-After ให้เรียกซ้ำหลังพ้นระยะเวลานั้น

โทเคนแรกนี้ถอดเสียง อ่านและแก้ไขข้อความถอดเสียง ส่งออก อ่านยอดคงเหลือในบัญชี ซื้อนาที และเปลี่ยนตัวเองได้ แต่ไม่ได้รับขอบเขตสิทธิ์สำหรับ Insights, context, organization หรือ settings-write เซิร์ฟเวอร์ MCP มีเฉพาะเครื่องมือที่อยู่ในขอบเขตสิทธิ์ของโทเคน

รหัสลับผิด signup_id ที่ไม่รู้จัก การสมัครที่คืนเงินแล้ว หรือหมดอายุแล้ว และการเปิดใช้งานซ้ำที่โทเคนถูกใช้ไปแล้วหรือพ้นหนึ่งชั่วโมงแล้ว ล้วนได้รับข้อผิดพลาด agent_claim_invalid แบบเดียวกัน ผู้เรียกแยกกรณีเหล่านี้จากคำตอบไม่ได้ตามที่ออกแบบไว้ สถานะการชำระเงินจะถูกตรวจสอบหลังรหัสลับถูกต้องแล้วเท่านั้น Checkout Session ที่ยังชำระเงินไม่เสร็จจะได้รับ wrong_state แทน

balance_seconds ด้านบนคือยอดคงเหลือเริ่มต้นทั้งหมด บัญชีเอเจนต์ไม่มีโบนัสต้อนรับและไม่มีนาทีฟรีจากการยืนยันบัตรเหมือนบัญชีแรกของบุคคลทั่วไป มีเพียงแพ็กเกจที่ชำระเงินไว้เท่านั้น นี่เป็นการออกแบบโดยตั้งใจ เพราะชำระเงินสำหรับบัญชีนี้ไปแล้วก่อนที่จะมีบัญชีเสียอีก

ซื้อนาทีเพิ่ม

จากขั้นนี้ บัญชีใช้เส้นทาง /v1/ ที่ /developers อธิบายไว้อย่างครบถ้วน

curl -X POST https://api.hushscript.com/v1/billing/purchase \
  -H "Authorization: Bearer hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170" \
  -H "Content-Type: application/json" \
  -d '{
    "pack": "300min",
    "quick_payment_method_id": "pm_1PqR2sT3uV4wX5yZ",
    "idempotency_key": "purchase-2026-09-11-01"
  }'
{
  "balance_seconds": 36000
}

คำขอนี้ต้องมีขอบเขต billing ซึ่งคำตอบการเปิดใช้งานด้านบนให้ไว้แล้ว การเปิดใช้งานยังเปิดสิทธิ์เรียกเก็บเงินให้ทั้งโทเคนและบัญชีด้วย ส่วนโทเคนที่บุคคลสร้างต้องมีขอบเขต billing และเปิดสวิตช์การเรียกเก็บเงินทั้งสองตัว คำขอเรียกเก็บเงินผ่าน PAT ใช้ขีดจำกัดที่เข้มกว่าร่วมกัน คือ 60 คำขอต่อนาทีต่อบัญชี ครอบคลุมเส้นทางเรียกเก็บเงินที่เรียก Stripe โดยตรวจสอบก่อนส่งคำขอไปยัง Stripe

บัญชีใหม่ซื้ออะไรได้บ้าง

ขนาดแพ็กเกจปลดล็อกตามเวลาที่ผ่านไปนับจากการชำระเงินเสร็จ ไม่ใช่ยอดใช้จ่ายของบัญชี การซื้อจะนับเข้าขั้นถัดไปเมื่อผ่านไปแล้ว 7 วัน นับจากวันชำระเงินของการซื้อนั้น บัญชีใหม่จึงไม่สามารถซื้อถี่ๆ เพื่อไปถึงแพ็กเกจใหญ่ได้

การชำระเงินที่เสร็จแล้วและผ่านไปเกิน 7 วัน แพ็กเกจที่ซื้อได้
ยังไม่มี รวมถึงบัญชีที่เพิ่งเปิดใช้งาน 45min, 300min
อย่างน้อยมูลค่า 45 นาที เพิ่ม 900min, 1800min
อย่างน้อยมูลค่า 15 ชั่วโมง เพิ่ม 6000min

การซื้อที่ถูกปฏิเสธระบุชุดแพ็กเกจปัจจุบันใน details.allowed_packs แทนที่จะล้มเหลวโดยไม่มีข้อมูล คำขอสมัครใช้แถวแรกของตารางเสมอ ตัวอย่างด้านบนจึงซื้อ 300min แทนแพ็กเกจใหญ่กว่า นอกจากลำดับการปลดล็อกนี้ ยังมีเพดานการใช้ในช่วง 24 ชั่วโมงย้อนหลังที่จำกัดความเร็วในการใช้ยอดคงเหลือที่ยังไม่พ้นช่วงโต้แย้งการชำระเงิน การซื้อเมื่อสมัครนับรวมในเพดานการพยายามซื้อสามครั้งของบัญชีในช่วง 24 ชั่วโมงย้อนหลังด้วย ความพยายามที่ถูกปฏิเสธหลังสำรองการซื้อก็นับเช่นกัน

ถอดเสียง

การอัปโหลดและถอดเสียงใช้ขั้นตอนแบบแบ่งส่วนเหมือนบัญชีอื่น ตัวอย่าง API ส่งเสียงที่เตรียมไว้ ไม่ได้อัปโหลดไฟล์วิดีโอต้นฉบับบนอุปกรณ์

curl -X POST https://api.hushscript.com/v1/uploads \
  -H "Authorization: Bearer hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170" \
  -H "Content-Type: application/json" \
  -d '{
    "size_bytes": 48213504,
    "duration_seconds": 1860,
    "title": "weekly-standup-2026-09-11",
    "idempotency_key": "upload-2026-09-11-01"
  }'
{
  "job_id": "job_3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d",
  "part_urls": [
    { "n": 1, "url": "https://r2.hushscript.com/uploads/job_3a2b1c0d.../part-1?X-Amz-Signature=..." }
  ]
}

PUT แต่ละส่วนไปยัง URL ที่ลงลายเซ็นไว้ล่วงหน้า แล้ว POST ไปยัง /complete ของงานเดียวกัน พร้อม n และ etag ของทุกส่วนที่ส่งด้วยวิธีนั้น จากนั้นตรวจสอบสถานะงานเป็นระยะ:

curl https://api.hushscript.com/v1/jobs/job_3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d \
  -H "Authorization: Bearer hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170"
{
  "id": "job_3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d",
  "state": "done",
  "transcript_id": "trs_6f5e4d3c2b1a0908f7e6d5c4b3a29180"
}
curl https://api.hushscript.com/v1/transcripts/trs_6f5e4d3c2b1a0908f7e6d5c4b3a29180 \
  -H "Authorization: Bearer hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170"
{
  "id": "trs_6f5e4d3c2b1a0908f7e6d5c4b3a29180",
  "language": "en",
  "duration_seconds": 1860,
  "body": "..."
}

เปลี่ยนข้อมูลรับรอง

บัญชีสำหรับระบบอัตโนมัติไม่มีรหัสผ่านและไม่มีกล่องจดหมายที่ใช้ได้ จึงไม่มีขั้นตอน “ลืมรหัสผ่าน” หาก PAT รั่วไหลหรือจำเป็นต้องเปลี่ยน การเปลี่ยนข้อมูลรับรองคือวิธีจัดการกรณีนี้

curl -X POST https://api.hushscript.com/v1/agent/credentials/rotate \
  -H "Authorization: Bearer hsr1:eu:pat.k3n2j1.8f7e6d5c4b3a29180716253443526170"
{
  "pat": "hsr1:eu:pat.p9q8r7.1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
  "pat_id": "p9q8r7",
  "scopes": [
    "transcripts:read",
    "transcripts:write",
    "transcribe",
    "account:read",
    "export",
    "billing",
    "pat:rotate"
  ],
  "expires_at": null
}

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

โทเคนเก่าจะไม่ถูกเพิกถอนทันที หลังเปลี่ยนแล้ว โทเคนเก่าใช้ทำได้อย่างเดียวคือเรียกเปลี่ยนซ้ำ ซึ่งคงอยู่จนกว่าโทเคนใหม่จะส่งคำขอสำเร็จครั้งแรก หรือพ้นหนึ่งชั่วโมง แล้วแต่อย่างใดจะถึงก่อน ในเส้นทางอื่นทั้งหมด โทเคนเก่าจะได้ 401 ทันที

หากคำตอบที่มีโทเคนใหม่หายไป ให้เรียกเปลี่ยนซ้ำด้วยโทเคนเก่าตราบใดที่โทเคนใหม่ยังไม่ถูกใช้ จะได้รหัสลับใหม่สำหรับ pat_id เดิม และรหัสลับใหม่ก่อนหน้าจะใช้ไม่ได้อีก

เก็บโทเคนเก่าไว้จนกว่าโทเคนใหม่จะใช้งานได้หนึ่งครั้ง จากนั้นให้เรียกด้วยโทเคนใหม่ทันทีหนึ่งครั้ง เช่น GET /v1/account คำขอแรกที่สำเร็จนั้นจะยกเลิกโทเคนเก่าถาวร

ข้อผิดพลาด

สถานะ รหัส Slug ความหมาย
401 2000 unauthorized ไม่มีโทเคนแบบ bearer หรือโทเคนไม่ถูกต้อง
403 2023 pat_scope_missing โทเคนไม่มีขอบเขตสิทธิ์ที่คำขอนี้ต้องใช้ หรือบัญชีปิดการเรียกเก็บเงินอยู่
403 4021 pat_purchase_requires_app ไม่ได้ระบุบัตรที่บันทึกไว้ หรือการเรียกเก็บเงินถูกปฏิเสธ ไม่มีการเรียกเก็บเงิน
403 4023 pat_purchase_requires_authentication ผู้ออกบัตรต้องการขั้นตอนยืนยันตัวตนที่ผู้เรียกดำเนินการไม่ได้ ตัวบัตรเองไม่มีปัญหา
402 3001 insufficient_balance ยอดคงเหลือไม่พอสำหรับรับงาน
429 5000 rate_limited คำขอมากเกินไป รอตามส่วนหัว Retry-After

ข้อผิดพลาดเหล่านี้ครอบคลุมการควบคุมการสมัครและการซื้อของเอเจนต์ เพดานการซื้อยังใช้กับการซื้อผ่าน PAT บนบัญชีบุคคลด้วย แต่การซื้อผ่านเซสชันของบุคคลได้รับการยกเว้น

สถานะ รหัส Slug ความหมาย
409 4035 agent_signup_pending การสมัครสำหรับ contact_email นี้ยังเปิดอยู่ รอให้เปิดใช้งาน คืนเงิน หรือหมดอายุ หรือใช้อีเมลอื่น
401 4036 agent_claim_invalid รหัสลับผิด การสมัครที่ไม่รู้จัก คืนเงินแล้ว หมดอายุแล้ว หรือเปิดใช้งานแล้วที่โทเคนถูกใช้ไปแล้วหรือพ้นหนึ่งชั่วโมงแล้ว ตั้งใจให้ได้รับข้อผิดพลาดเดียวกัน
403 4037 agent_pack_locked ขั้นของบัญชีนี้ยังไม่อนุญาตแพ็กเกจนั้น มี details.allowed_packs ให้ลองใหม่ด้วยรายการในนั้น
429 4038 agent_purchase_capped พยายามซื้อ 3 ครั้งในช่วง 24 ชั่วโมงย้อนหลัง รวมกรณีล้มเหลวหลังสำรองการซื้อและการซื้อเมื่อสมัครบัญชีเอเจนต์ นับต่อบัญชีรวมทุกข้อมูลรับรอง การเปลี่ยนโทเคนจึงไม่รีเซ็ตตัวนับ มี details.retry_after_seconds แนบมาด้วย

เมื่อรหัสลับสำหรับเปิดใช้งานถูกต้องแล้ว Checkout Session ที่ยังไม่ชำระเงินจะได้รับ wrong_state (4001) แทน agent_claim_invalid รายการทั้งหมดอยู่ในเอกสาร OpenAPI

ขีดจำกัด

คำขอถูกจำกัดไว้ที่ 1,200 ครั้งต่อนาที สำหรับบัญชีเอเจนต์ โควตาเป็นของบัญชี ไม่ใช่โทเคนแต่ละตัว ข้อมูลรับรองทุกตัวที่สืบต่อกันจากการเปลี่ยนโทเคนใช้โควตาเดียวกัน การเปลี่ยน PAT จึงไม่ได้ให้โควตาใหม่แก่โทเคนตัวถัดไป คำขอเรียกเก็บเงินผ่าน PAT ที่เรียก Stripe ใช้ขีดจำกัดที่เข้มกว่าร่วมกัน คือ 60 ครั้งต่อนาทีต่อบัญชี ครอบคลุมการตั้งค่าและการซื้อ การเปลี่ยนบัตรเริ่มต้นและการลบบัตร รวมถึงการเรียกรายการบัตรเมื่อไม่มีข้อมูลในแคช โดยตรวจสอบก่อนเรียก Stripe เพดานการซื้อในช่วง 24 ชั่วโมงด้านบนก็นับต่อบัญชีเช่นกัน ไม่ใช่ต่อข้อมูลรับรอง

ดูเพิ่มเติม

หน้านี้ครอบคลุมวงจรชีวิตบัญชี ตั้งแต่เปิดบัญชี เติมเงิน และดูแลข้อมูลรับรองให้ใช้ได้ สำหรับสิ่งที่บัญชีทำได้หลังจากนั้น ดูREST API รวมถึงเอกสาร OpenAPI ฉบับเต็ม หรือเซิร์ฟเวอร์ MCP เพื่อใช้บัญชีเดียวกันผ่านเครื่องมือแทน HTTP โดยตรง

ถอดเสียงในแอป หรือให้เอเจนต์มีบัญชีของตัวเอง

บัญชีส่วนบุคคลที่มีสิทธิ์สามารถรับ 30 นาทีฟรีหนึ่งครั้งหลังยืนยันบัตรสำเร็จ หรือพร้อมการซื้อครั้งแรกหากยังไม่ได้รับสิทธิ์นี้ บัญชีเอเจนต์เริ่มต้นด้วยแพ็กเกจนาทีที่ซื้อเมื่อสมัคร

รับ 30 นาทีฟรี