ความช่วยเหลือ GenderAPI.io V2
คำถามที่พบบ่อย
คำตอบเกี่ยวกับคำขอ V2 ค่าความเชื่อมั่น ผลลัพธ์ที่ไม่ทราบ เครดิต ความเป็นส่วนตัว และบัญชี หากคุณดูแลการเชื่อมต่อที่สร้างด้วยเวอร์ชันก่อนหน้า ให้ดูเอกสาร V1
ผลลัพธ์และค่าความเชื่อมั่น
ทำความเข้าใจผลการคาดการณ์และข้อจำกัด
บริบทประเทศ ค่าความเชื่อมั่น และผลลัพธ์ที่ไม่ทราบใน API V2
ผลลัพธ์จาก GenderAPI ยืนยันเพศของบุคคลหรือไม่?
ไม่ GenderAPI คาดการณ์เพศจากสัญญาณที่เกี่ยวกับชื่อ หรือจากสัญญาณของชื่อเล่นเมื่อเปิดตัวเลือกนั้น ผลการคาดการณ์ไม่ใช่ข้อเท็จจริงส่วนบุคคลที่ผ่านการยืนยัน ควรเก็บความไม่แน่นอนไว้ เคารพอัตลักษณ์ที่บุคคลระบุด้วยตนเอง และอย่าใช้การคาดการณ์นี้เพียงอย่างเดียวในการตัดสินใจที่มีผลกระทบสูง
บริบทประเทศมีผลต่อผลลัพธ์อย่างไร?
รหัสประเทศ ISO ตัวพิมพ์ใหญ่ที่ส่งเพิ่มได้ตามต้องการจะให้บริบทของภูมิภาคแก่คำขอ ส่งเฉพาะเมื่อประเทศเกี่ยวข้องและทราบแน่ชัด ชื่อเดียวกันอาจใช้ต่างกันในแต่ละภูมิภาค ประเทศที่ส่งคืนแสดงความเชื่อมโยงกับชื่อเท่านั้น ไม่ใช่หลักฐานของสัญชาติหรือถิ่นที่อยู่
ค่าความเชื่อมั่นใน V2 หมายถึงอะไร?
confidence เป็นค่าตั้งแต่ 0 ถึง 1 หรือเป็น null เมื่อไม่มีค่า ให้อ่านคู่กับ confidence_kind โดย observed_frequency คือจำนวนของกลุ่มที่พบมากที่สุดในชุดข้อมูลหารด้วยจำนวนทั้งหมด ส่วน model_reported คือคะแนนที่ AI รายงาน ค่าเหล่านี้ไม่ใช่ความน่าจะเป็นที่ปรับเทียบแล้วเกี่ยวกับบุคคล และไม่ใช่ความแม่นยำของผลิตภัณฑ์ที่วัดได้ ควรกำหนดเกณฑ์การตรวจสอบด้วยข้อมูลที่เป็นตัวแทน
gender: null หมายถึงอะไร และถูกหักเครดิตหรือไม่?
ผลลัพธ์ V2 ที่ดำเนินการสำเร็จและมี gender: null หมายความว่าสัญญาณที่มีอยู่ไม่เพียงพอที่จะระบุเพศ ค่านี้เป็นค่า null ดั้งเดิมของ JSON ไม่ใช่สตริง "null" ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิตตามอัตราของโหมดที่เลือก ให้เก็บไว้เป็นผลลัพธ์ที่ไม่ทราบ ส่วนความล้มเหลวของผู้ให้บริการหรือคำขอเป็นข้อผิดพลาดแยกต่างหาก
ส่งชื่อในระบบอักษรต่าง ๆ ได้หรือไม่?
ได้ ส่งชื่อเป็น Unicode โดยคงตัวอักษรเดิมและเครื่องหมายกำกับเสียงที่มีความหมายไว้ ชื่อภาษาไทยส่งเป็นอักษรไทยได้โดยตรง ความครอบคลุมและค่าความเชื่อมั่นขึ้นอยู่กับชื่อ ภูมิภาค และสัญญาณที่มี จึงควรทดสอบด้วยตัวอย่างที่เป็นตัวแทนของระบบอักษรและประเทศที่แอปพลิเคชันของคุณรองรับ
API และ AI
เลือกประเภทคำขอและตัวเลือก AI
ประเภทคำขอ V2 คำขอแบบกลุ่ม การทำงานของ AI และขีดจำกัดการใช้งาน
วิเคราะห์ชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ในคำขอแบบกลุ่มเดียวได้หรือไม่?
ได้ POST /api/v2/gender/batch รับได้สูงสุด 50 รายการเมื่อใช้คีย์ API และสูงสุด 10 รายการเมื่อใช้การทดลองใช้ตาม IP แต่ละรายการกำหนด type, value, country (ไม่บังคับ) และการตั้งค่า AI ของตัวเองได้ รายการในคำขอแบบกลุ่มปิด AI ไว้ตามค่าเริ่มต้น ควรตรวจสอบผลลัพธ์ทีละรายการ เพราะคำขอแบบกลุ่มอาจส่งคืน HTTP 200 แม้บางรายการล้มเหลว เครดิตจะถูกหักตามรายการที่ดำเนินการสำเร็จ รวมถึงผลลัพธ์ที่ไม่ทราบ
คำขอด้วยที่อยู่อีเมลทำงานอย่างไร?
ใช้ type: email กับที่อยู่ที่ถูกต้อง API จะค้นหาสัญญาณชื่อที่ใช้ได้ในส่วนหน้าเครื่องหมาย @ โดเมนไม่ได้บ่งบอกตัวตนหรือประเทศของบุคคล กล่องจดหมายที่ใช้ร่วมกันหรือที่อยู่ที่ไม่มีสัญญาณชื่ออาจได้ผลลัพธ์ที่ไม่ทราบ คำขอเดี่ยวจะใช้ AI สำรองตามค่าเริ่มต้นเมื่อชุดข้อมูลระบุเพศไม่ได้
คำขอด้วยชื่อผู้ใช้ทำงานอย่างไร?
ใช้ type: username การค้นหาปกติจะหาชื่อที่จดจำได้ในชื่อผู้ใช้หรือชื่อที่แสดง นามแฝงที่เป็นนามธรรมอาจได้ผลลัพธ์ที่ไม่ทราบ หากต้องการให้ AI ที่ตีความชื่อเล่นทำงานหลังจากชุดข้อมูลระบุเพศไม่ได้ ให้เปิด forceToGenderize ซึ่งอาจได้ผลเป็นเพศแม้จะดึงชื่อจริงออกมาไม่ได้
V2 ใช้ AI เมื่อใด?
คำขอเดี่ยวใช้ options.ai_mode: fallback เป็นค่าเริ่มต้น ระบบจะค้นหาในชุดข้อมูลก่อน แล้วใช้ AI หากยังระบุเพศไม่ได้ โดยรวมเป็น 1 เครดิต off ใช้เฉพาะชุดข้อมูลในราคา 1 เครดิต ส่วน always ข้ามชุดข้อมูลและใช้ AI ในราคา 2 เครดิต รายการในคำขอแบบกลุ่มใช้ off เป็นค่าเริ่มต้นและเปิด AI ได้ทีละรายการ ไม่มีโหมดใดรับประกันว่าผลลัพธ์จะไม่เป็น null
forceToGenderize ทำอะไร?
แฟล็กที่ใช้ได้ตามต้องการนี้ทำงานกับข้อมูลนำเข้าประเภทชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ รวมถึงรายการแต่ละรายการในคำขอแบบกลุ่ม ผลที่ชุดข้อมูลระบุเพศได้ใช้ 1 เครดิต หากระบุไม่ได้ ระบบจะใช้ AI ที่ตีความชื่อเล่นและรวมเป็น 2 เครดิต แม้ผลลัพธ์ที่ดำเนินการสำเร็จจะยังเป็นผลลัพธ์ที่ไม่ทราบก็ตาม ไม่จำเป็นต้องมีชื่อจริง ให้ละ ai_mode หรือใช้ fallback หากใช้แฟล็กนี้ร่วมกับ off หรือ always ระบบจะส่งคืน 422
V2 หักเครดิตอย่างไร?
ดูเครดิตที่ถูกหักจริงของงานได้ที่ meta.usage.charged_credits และดูว่าการหักเครดิตได้รับการยืนยันแล้วหรือไม่ที่ billing_status การคาดการณ์ปกติจากชุดข้อมูลและการคาดการณ์ในโหมด fallback ใช้ 1 เครดิตต่อรายการที่สำเร็จ ส่วน always และ AI ที่ตีความชื่อเล่นใช้ 2 เครดิต การตรวจสอบหมายเลขโทรศัพท์ที่เสร็จสมบูรณ์ใช้ 1 เครดิตแม้ผลจะไม่ถูกต้อง ยอดคงเหลือเริ่มต้นที่เป็นบวกก็เพียงพอ ยอดคงเหลือจึงอาจติดลบหลังการหักเครดิตครั้งสุดท้าย การคาดการณ์ที่ล้มเหลวจะได้รับเครดิตคืน และการหักเครดิตที่ยังไม่ยืนยันต้องให้ทีมช่วยเหลือตรวจสอบ
V2 มีขีดจำกัดคำขอหรือไม่?
มี ค่าเริ่มต้นปัจจุบันคือ 120 คำขอต่อนาทีต่อบัญชี 600 คำขอต่อนาทีต่อ IP และงานพร้อมกัน 2 งานต่อบัญชี ความจุที่ใช้ร่วมกันของบริการก็มีผลด้วย เนื้อหาคำขอ POST จำกัดที่ 64 KiB และคำขอแบบกลุ่มรับได้ 50 รายการเมื่อใช้คีย์ หรือ 10 รายการเมื่อใช้การทดลองใช้ตาม IP อย่าคาดว่าคำขอที่อยู่ในขีดจำกัดเหล่านี้จะได้รับการยอมรับเสมอ ให้รองรับ HTTP 429 และ Retry-After
ส่งคำขอที่ล้มเหลวหรือหมดเวลาซ้ำได้หรือไม่?
คำขอคาดการณ์ทุกครั้งเป็นงานใหม่และคิดค่าใช้จ่ายตามปกติ การหมดเวลาหรือผลลัพธ์ที่สูญหายไม่ได้พิสูจน์ว่าไม่มีการหักเครดิต ให้ตรวจสอบ billing_status ก่อนส่งซ้ำ หากการหักเครดิตยังไม่ได้รับการยืนยัน ให้ติดต่อทีมช่วยเหลือพร้อม request_id สำหรับคำขอแบบกลุ่มที่ล้มเหลวบางส่วน ให้ส่งซ้ำเฉพาะรายการที่ล้มเหลวหลังจากยืนยันการหักเครดิตแล้ว สำหรับผลลัพธ์ 429 ให้ปฏิบัติตาม Retry-After
ตัวอย่างโค้ดและเครื่องมือของ V2 อยู่ที่ไหน?
คู่มือ V2 มีตัวอย่างใน cURL, JavaScript, Python, PHP, Java, C# และ Go ส่วน Swagger และ Postman ใช้สัญญา V2 เดียวกัน เลือกประเภทข้อมูลนำเข้า และเก็บคีย์ API ไว้ในการตั้งค่าฝั่งเซิร์ฟเวอร์
ยังใช้ V1 ต่อได้หรือไม่?
ได้ การเชื่อมต่อ V1 ที่มีอยู่ยังคงใช้ endpoint และรูปแบบผลลัพธ์เดิม V1 และ V2 ใช้คีย์ API และยอดคงเหลือเดียวกัน แต่ฟิลด์ของคำขอ ผลลัพธ์ และข้อผิดพลาดแตกต่างกัน ใช้เอกสาร V1 แยกต่างหากเพื่อดูแลไคลเอนต์เดิม และใช้คู่มือการย้ายระบบเมื่อพร้อมเปลี่ยนไปใช้ V2
ความเป็นส่วนตัวและไฟล์
ทำความเข้าใจการจัดการข้อมูล
แหล่งข้อมูลล่าสุดเกี่ยวกับการประมวลผล การเก็บรักษา และการลบข้อมูล
GenderAPI จัดเก็บคำขอที่ดำเนินการสำเร็จหรือไม่?
นโยบายความเป็นส่วนตัวอธิบายว่าข้อมูลคำขอ บันทึกการดำเนินงาน และบันทึกด้านความปลอดภัยใดบ้างที่อาจถูกเก็บรักษา ประมวลผลเพื่อวัตถุประสงค์ใด และลบอย่างไร ตรวจสอบรายละเอียดเหล่านี้ให้เหมาะกับการเชื่อมต่อของคุณ และหลีกเลี่ยงการส่งข้อมูลส่วนบุคคลที่ไม่จำเป็น
ที่อยู่อีเมลในคำขอถูกจัดเก็บหรือไม่?
นโยบายความเป็นส่วนตัวอธิบายการจัดการที่อยู่อีเมลในคำขอและบันทึกทางเทคนิคที่เกี่ยวข้อง ที่อยู่อีเมลอาจเป็นข้อมูลส่วนบุคคล จึงควรส่งเฉพาะข้อมูลที่คำขอต้องใช้ และหลีกเลี่ยงการบันทึกที่อยู่แบบเต็มในบันทึกการวินิจฉัยของคุณเอง
ไฟล์ Excel หรือ CSV ที่อัปโหลดถูกเก็บไว้นานเท่าใด?
นโยบายความเป็นส่วนตัวกำหนดการเก็บรักษา การลบ และการสำรองข้อมูลของไฟล์ที่อัปโหลด ส่งออกผลลัพธ์ที่ต้องการ แล้วใช้ปุ่มลบในพื้นที่ทำงานเมื่อไม่ต้องการไฟล์นั้นแล้ว หากมีคำถามเกี่ยวกับข้อกำหนดการเก็บรักษาข้อมูลขององค์กร ให้ติดต่อทีมช่วยเหลือ
ผู้ให้บริการภายนอกประมวลผลข้อมูลคำขอหรือไฟล์ที่อัปโหลดได้หรือไม่?
นโยบายความเป็นส่วนตัวและข้อมูลผู้ประมวลผลข้อมูลช่วงอธิบายการประมวลผลโดยผู้ให้บริการและมาตรการคุ้มครองที่ใช้ เมื่อประเมินว่าข้อมูลของคุณถูกประมวลผลที่ใด ให้ตรวจสอบเอกสารเหล่านี้และข้อตกลงที่ใช้กับบัญชีของคุณ
บัญชีและการช่วยเหลือ
เชื่อมต่อคีย์และจัดการบัญชี
การใช้งานฟรี การยืนยันตัวตน การตรวจสอบยอดคงเหลือ และการช่วยเหลือ
ทดลองใช้ GenderAPI ฟรีได้หรือไม่?
ได้ บัญชีฟรีที่ลงทะเบียนแล้วได้รับ 200 เครดิตทุกวัน นอกจากนี้การทดลองใช้ตาม IP ของ V2 ที่ไม่ต้องใช้คีย์ให้ 10 เครดิตต่อที่อยู่ IP สาธารณะในแต่ละรอบ 24 ชั่วโมง โดยใช้ร่วมกับ V1 และผู้ใช้อื่นบน IP เดียวกัน ทั้งสองแบบคิดค่าใช้จ่ายตามอัตราเครดิตปกติ จำนวนเครดิตจึงไม่เท่ากับจำนวนคำขอ HTTP เสมอไป
ควรยืนยันตัวตนของคำขอและปกป้องคีย์ API อย่างไร?
ใช้ Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอ POST ต้องมี Content-Type: application/json ด้วย อย่าใส่คีย์จริงในโค้ดฝั่งเบราว์เซอร์ ที่เก็บโค้ดสาธารณะ หรือบันทึก คีย์ที่ไม่มี ผิดรูปแบบ หรือระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP จึงควรยืนยันว่า meta.access.mode เป็น api_key คีย์ที่ระบบรู้จักแต่ถูกปิดใช้งาน หมดอายุ หรือถูกจำกัดจะไม่เปลี่ยนไปใช้การทดลองใช้
ตรวจสอบเครดิตคงเหลือได้อย่างไร?
เรียก GET /api/v2/usage ด้วยคีย์แบบ Bearer การตรวจสอบยอดคงเหลือนี้ไม่มีค่าใช้จ่ายและส่งคืน data.remaining_credits หากเรียกโดยไม่มีคีย์ ระบบจะอ่านยอดของการทดลองใช้ตาม IP ที่ใช้ร่วมกัน V1 และ V2 ใช้ยอดคงเหลือเดียวกันของบัญชี ค่า remaining_credits ในผลการคาดการณ์คือยอดคงเหลือ ณ เวลาที่งานเสร็จ
จัดการหรือยกเลิกการสมัครสมาชิกได้ที่ไหน?
เข้าสู่ระบบแอป GenderAPI เพื่อจัดการการสมัครสมาชิกที่เชื่อมกับคีย์ API ของคุณ ดูแพ็กเกจและตัวเลือกการยกเลิกได้ในการตั้งค่าบัญชีปัจจุบัน
อัปเดตข้อมูลการเรียกเก็บเงินได้ที่ไหน?
จัดการการตั้งค่าการเรียกเก็บเงินและการชำระเงินของคีย์ API หรือการสมัครสมาชิกที่เกี่ยวข้องได้ในแอป GenderAPI หลังเข้าสู่ระบบ
จะแจ้งผลลัพธ์ที่ไม่ถูกต้องหรือขอความช่วยเหลือด้านการเชื่อมต่อได้อย่างไร?
ส่งเวอร์ชัน API, endpoint, request_id และตัวอย่างขนาดเล็กที่ทำซ้ำปัญหาได้ให้ทีมช่วยเหลือ แนบรหัสข้อผิดพลาดหากมี แต่ให้ลบคีย์ API และข้อมูลส่วนบุคคลที่ละเอียดอ่อนออก
ฐานความรู้ทางเทคนิค
คู่มือการใช้งานและการใช้อย่างรับผิดชอบ
คำตอบเกี่ยวกับผลลัพธ์ ความเป็นส่วนตัว และการใช้งาน V2 พร้อมลิงก์ไปยังคู่มือที่เกี่ยวข้องและเวอร์ชัน Markdown ของแต่ละคำตอบ
ผลลัพธ์ ค่าความเชื่อมั่น และการใช้อย่างรับผิดชอบ
การคาดการณ์ของ V2 ที่ระบุเพศไม่ได้จะใช้ค่า null ดั้งเดิมของ JSON ใน gender ไม่ใช่สตริง "null" ชื่ออาจกำกวมหรือสัญญาณที่มีอยู่อาจไม่เพียงพอ หากมี result_status และ reason ให้ตรวจสอบค่าเหล่านั้น เก็บผลลัพธ์ที่ไม่ทราบไว้แทนการบังคับจัดเข้ากลุ่มใดกลุ่มหนึ่ง การคาดการณ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิตตามอัตราของโหมดที่เลือก ข้อผิดพลาดของคำขอหรือผู้ให้บริการเป็นความล้มเหลวแยกต่างหาก และมีข้อมูลการหักเครดิตอยู่ใน meta.usage
อ่านคำตอบเต็ม →ความแม่นยำของ GenderAPI ประเมินอย่างไร?การประเมินความแม่นยำที่มีประโยชน์ต้องรายงานกลุ่มประชากรที่ทดสอบ วันที่ วิธีการสุ่มตัวอย่าง สัดส่วนของผลลัพธ์ที่ไม่ทราบ และผลลัพธ์แยกตามภูมิภาคและระบบอักษร หน้าวิธีการประเมินในปัจจุบันอธิบายขั้นตอนการประเมิน ไม่ได้ระบุเปอร์เซ็นต์ความแม่นยำที่วัดได้ confidence และ confidence_kind ของ V2 อธิบายหลักฐานของผลลัพธ์แต่ละรายการ แต่ใช้แทนการทดสอบด้วยข้อมูลที่เป็นตัวแทนไม่ได้
อ่านคำตอบเต็ม →แหล่งข้อมูล ความเป็นส่วนตัว และการปฏิบัติตามข้อกำหนด
หน้าแหล่งที่มาของข้อมูลอธิบายกรอบการบันทึกประเภทของแหล่งข้อมูล เกณฑ์การคัดเลือก สิทธิ์การใช้งาน และข้อจำกัดด้านภูมิศาสตร์หรือระบบอักษร ปัจจุบันยังไม่มีการเผยแพร่รายการแหล่งข้อมูลที่ผ่านการตรวจสอบแล้ว ดูหน้านั้นและติดต่อทีมช่วยเหลือหากการเชื่อมต่อของคุณมีข้อกำหนดเกี่ยวกับแหล่งข้อมูล อย่าคาดเดาแหล่งข้อมูล ขนาดชุดข้อมูล หรือตัวเลขความครอบคลุมที่ไม่ได้ระบุไว้ในเอกสาร
อ่านคำตอบเต็ม →ข้อมูลชื่ออัปเดตบ่อยแค่ไหน?หน้าแหล่งที่มาของข้อมูลในปัจจุบันไม่ได้ระบุกำหนดการอัปเดตเดียวที่ใช้กับทุกระเบียนชื่อหรือกฎการประมวลผล หากความใหม่ของข้อมูลมีผลต่อกรณีการใช้งานของคุณ ให้สอบถามทีมช่วยเหลือเกี่ยวกับชุดข้อมูลหรือเวิร์กโฟลว์ที่เกี่ยวข้อง และทดสอบด้วยผลลัพธ์ที่เป็นตัวแทน วันที่ตรวจทานของหน้าเว็บไม่ได้เป็นหลักฐานว่าระเบียนพื้นฐานทั้งหมดได้รับการอัปเดตในวันนั้น
อ่านคำตอบเต็ม →ดูข้อมูล GDPR และข้อตกลงการประมวลผลข้อมูลได้ที่ไหน?นโยบายความเป็นส่วนตัว ข้อมูล GDPR ข้อตกลงการประมวลผลข้อมูล และรายชื่อผู้ประมวลผลข้อมูลช่วงอธิบายเงื่อนไขการประมวลผลและมาตรการคุ้มครองที่เผยแพร่ไว้ ตรวจสอบเอกสารฉบับปัจจุบันและข้อตกลงที่ใช้กับบัญชีของคุณ หากมีคำถามเฉพาะองค์กรเกี่ยวกับบทบาทในการประมวลผล การโอนข้อมูล หรือคำขอของเจ้าของข้อมูล ให้ติดต่อ GenderAPI คำตอบในคำถามที่พบบ่อยทั่วไปใช้แทนข้อตกลงที่มีผลบังคับไม่ได้
อ่านคำตอบเต็ม →การใช้งาน API ข้อผิดพลาด และการหักเครดิต
ใช้ Authorization: Bearer YOUR_API_KEY จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอ POST ของ V2 ต้องมี Content-Type: application/json ด้วย GET /api/v2/gender รับคีย์ในพารามิเตอร์ของ query ได้เช่นกัน แต่การใช้ header ช่วยไม่ให้ข้อมูลรับรองปรากฏใน URL ของเบราว์เซอร์ คีย์ที่ไม่มี ผิดรูปแบบ หรือระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP ที่ใช้ร่วมกัน สำหรับการเชื่อมต่อด้วยบัญชี ให้ตรวจสอบว่า meta.access.mode เป็น api_key คีย์ที่ระบบรู้จักแต่ถูกปิดใช้งาน หมดอายุ หรือถูกจำกัดจะไม่เปลี่ยนไปใช้การทดลองใช้
อ่านคำตอบเต็ม →ควรจัดการขีดจำกัดคำขอและการส่งคำขอซ้ำอย่างไร?V2 ใช้ขีดจำกัดจำนวนคำขอและคำขอพร้อมกัน จึงต้องรองรับ HTTP 429 และ Retry-After การคาดการณ์ที่ส่งซ้ำแต่ละครั้งเป็นงานใหม่และคิดค่าใช้จ่ายตามปกติ อย่าส่งคำขอซ้ำโดยอัตโนมัติเมื่อหมดเวลา ผลลัพธ์สูญหาย หรือการหักเครดิตยังไม่ได้รับการยืนยัน ให้ตรวจสอบ code, action และ meta.usage.billing_status ก่อน หากเป็น billing_reconciliation_required ให้ติดต่อทีมช่วยเหลือพร้อม request_id ใช้ backoff แบบจำกัดจำนวนครั้งเฉพาะเมื่อยืนยันการหักเครดิตแล้วและ action ในเอกสารอนุญาตให้ส่งคำขอใหม่
อ่านคำตอบเต็ม →ควรตีความข้อผิดพลาดของ V2 อย่างไร?ข้อผิดพลาดของ V2 API ใช้สถานะข้อผิดพลาด HTTP และ RFC 9457 Problem Details ที่มีฟิลด์ code และ action ซึ่งคงที่ ให้จัดการข้อผิดพลาดตามฟิลด์เหล่านี้แทนการเทียบข้อความใน detail และเก็บ request_id ไว้สำหรับติดต่อทีมช่วยเหลือ ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จไม่ใช่ข้อผิดพลาด ผลลัพธ์ของคำขอแบบกลุ่มอาจมีข้อผิดพลาดของรายการแม้จะเป็น HTTP 200 พร็อกซีอาจส่งคืนข้อผิดพลาดที่ไม่ใช่ JSON และผลลัพธ์ที่สูญหายหรืออ่านไม่ได้ไม่ได้ยืนยันว่าไม่มีการหักเครดิต
อ่านคำตอบเต็ม →ตรวจสอบเครดิตคงเหลือได้อย่างไร?เรียก GET /api/v2/usage ด้วยคีย์ API แบบ Bearer จากโค้ดฝั่งเซิร์ฟเวอร์ที่เชื่อถือได้ คำขอนี้ไม่มีค่าใช้จ่ายและส่งคืน data.remaining_credits หากไม่ส่งคีย์ ระบบจะอ่านยอดของการทดลองใช้ตาม IP ที่ใช้ร่วมกัน V1 และ V2 ใช้ยอดคงเหลือเดียวกันของบัญชี meta.usage ในผลการคาดการณ์แสดงเครดิตที่งานนั้นใช้และยอดคงเหลือ ณ เวลาที่งานเสร็จ ซึ่งอาจเปลี่ยนไปเมื่อมีคำขอพร้อมกัน อย่าบันทึกข้อมูลรับรองไว้ในบันทึก และอย่าถือว่าการอ่านยอดคงเหลือเป็นหลักฐานว่าคำขอที่ผลลัพธ์สูญหายไม่ได้ถูกหักเครดิต
อ่านคำตอบเต็ม →ย้ายจาก V1 ไป V2 อย่างปลอดภัยได้อย่างไร?ใช้ V2 สำหรับการเชื่อมต่อใหม่ และให้ไคลเอนต์ V1 ที่มีอยู่ใช้ endpoint ตามเอกสารต่อไปจนกว่าคุณจะตัดสินใจย้าย ทั้งสองเวอร์ชันใช้คีย์ API และเครดิตเดียวกัน แต่ฟิลด์ของคำขอ โครงสร้างผลลัพธ์ และรูปแบบข้อผิดพลาดแตกต่างกัน ทำตามคู่มือการย้ายระบบ ทดสอบผลลัพธ์ที่สำเร็จ ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาด แล้วอัปเดตโค้ดที่อ่านผลลัพธ์ก่อนเปลี่ยน endpoint เอกสาร V1 ยังคงให้บริการสำหรับการเชื่อมต่อเดิม
อ่านคำตอบเต็ม →ตรวจสอบข้อผิดพลาดและติดตามความพร้อมใช้งานของบริการได้อย่างไร?หากคำขอล้มเหลว ให้ใช้รหัสข้อผิดพลาดที่ส่งคืนเพื่อแยกความล้มเหลวของบริการออกจากข้อมูลนำเข้าที่ไม่ถูกต้อง ปัญหาการเข้าถึงบัญชี เครดิตไม่พอ หรือขีดจำกัดคำขอ ติดตามอัตราความสำเร็จของคำขอและเวลาตอบสนองในการเชื่อมต่อของคุณเอง หากมีความล้มเหลวที่ไม่ทราบสาเหตุหรือไม่แน่ใจเรื่องการหักเครดิต ให้ติดต่อทีมช่วยเหลือพร้อม request_id การกล่าวอ้างเรื่องความพร้อมใช้งานต้องอิงข้อมูลการติดตามที่วัดได้ คำตอบนี้ไม่ได้รับประกันเปอร์เซ็นต์ความพร้อมใช้งาน
อ่านคำตอบเต็ม →ยังต้องการความช่วยเหลือ?
ส่งตัวอย่างที่ทำซ้ำปัญหาได้
ระบุเวอร์ชัน API, endpoint, request_id และข้อผิดพลาดที่ได้รับ โดยไม่ส่งคีย์ API หรือข้อมูลส่วนบุคคลที่ละเอียดอ่อน