ตรวจสอบเมื่อ 2026-11-12

เรียก Gemini API ด้วย OpenAI SDK และ key เดียว

เรียก Gemini API ผ่าน RelaySwitch ในรูปแบบ OpenAI-compatible: ตั้ง Base URL เป็น https://api.relayswitch.io/v1 ใส่ key ที่ขึ้นต้นด้วย sk-relay- แล้วเขียน id ของ Gemini ในค่า model โดยใช้ OpenAI SDK ตามเดิม มี Gemini ให้เรียก 21 รุ่น คิดเงินตาม token จากยอดที่เติมไว้ล่วงหน้า

01Gemini API คืออะไร และเรียกผ่าน gateway ต่างกันอย่างไร

Gemini API คือ API ของ Google สำหรับเรียกโมเดล Gemini การใช้โดยตรงต้องมีบัญชี Google สร้าง key ใน AI Studio แล้วจ่ายเงินตามระบบของ Google เมื่อเรียกผ่าน RelaySwitch ส่วนนี้เปลี่ยนไป: เติมเงินและรับ key ที่ RelaySwitch แล้วส่ง request มาที่ gateway ซึ่งส่งต่อไปยัง Gemini สำหรับโค้ด สิ่งที่เปลี่ยนมีเพียงที่อยู่และ key ส่วน model id ยังเป็น id ของ Gemini

Gemini มี request format ของตัวเองคือ generateContent แต่เครื่องมือและโค้ดส่วนใหญ่เขียนตาม Chat Completions ของ OpenAI Google เองจึงมีชั้น OpenAI-compatible ให้ และระบุในเอกสารว่ายังเป็น beta ที่นี่ใช้แนวทางเดียวกัน: Gemini ทุก id ในตารางราคาเรียกด้วย OpenAI format ได้ การเปลี่ยนโค้ด OpenAI ที่มีอยู่มาใช้ Gemini จึงแก้เพียงค่า model

02ทดสอบ Gemini API ด้วย curl

เริ่มจาก curl เพื่อยืนยันว่า key และที่อยู่ถูกต้อง ก่อนย้ายไปใส่ใน SDK Base URL ต้องมี /v1 และ SDK จะต่อ /chat/completions ให้เอง ถ้าได้ 200 พร้อม JSON แสดงว่าทั้งสองค่าถูกต้อง

การเปิด streaming ให้ตั้ง stream เป็น true แล้ว response จะมาเป็น server-sent events ในรูปแบบเดียวกับของ OpenAI

bash
1curl https://api.relayswitch.io/v1/chat/completions \
2 -H "Authorization: Bearer sk-relay-..." \
3 -H "content-type: application/json" \
4 -d '{"model": "gemini-3.1-pro-preview", "messages": [{"role": "user", "content": "Reply with ok"}]}'

03OpenAI SDK กับโมเดล Gemini

ส่ง base_url และ api_key ตอนสร้าง client แล้วเขียน id ของ Gemini ในค่า model ส่วนที่เหลือของโค้ดเป็น OpenAI SDK ตามปกติ และเมื่อจะเปลี่ยนไปใช้โมเดลของค่ายอื่นก็แก้เพียงค่า model

โค้ดที่เขียนตามเอกสาร OpenAI-compatible ของ Google ใช้ OpenAI SDK อยู่แล้ว การย้ายมาจึงแก้สามจุดตามรายการด้านล่าง โดย request body ไม่ต้องแก้ ส่วน field เฉพาะของ Gemini ที่เอกสารของ Google ส่งผ่าน extra_body หน้านี้ไม่ได้ทดสอบทีละรายการ ถ้าต้องใช้ ให้ลองส่งหนึ่ง request ก่อน แล้วดูว่าการคิดเงินในใบเสร็จเป็นไปตามที่คาดหรือไม่

  • base_url: เปลี่ยนจากที่อยู่ในเอกสารของ Google เป็น https://api.relayswitch.io/v1
  • api_key: เปลี่ยนจาก key ของ AI Studio เป็น key sk-relay- ของ RelaySwitch
  • model: เทียบ id กับตารางราคาในหน้านี้อีกครั้ง โดยยึดตามที่ตารางแสดง ณ ตอนนั้น ถ้าเขียนผิดจะได้ 404 model_not_found
python
1from openai import OpenAI
2
3client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")
4reply = client.chat.completions.create(
5 model="gemini-3.1-pro-preview",
6 messages=[{"role": "user", "content": "Reply with ok"}],
7)
8print(reply.choices[0].message.content)

04Gemini format ของ Google เอง: generateContent

โปรแกรมที่เขียนตาม request format ของ Google อยู่แล้วไม่ต้องเขียนใหม่ สำหรับ Gemini id ที่แคตตาล็อกระบุว่ารองรับ route นี้ ให้ส่ง request ไปที่ https://api.relayswitch.io/v1beta/models/{model}:generateContent สังเกตว่า path นี้ต่อ /v1beta หลังโดเมนโดยตรง ไม่มี /v1 นำหน้า key ใส่ใน header x-goog-api-key และอย่าใส่ไว้ใน URL เพราะ gateway ปฏิเสธ key ที่ส่งมาใน query parameter

request และ response เป็นโครงสร้างของ Google คือส่ง contents และได้ candidates กลับมา error ก็เป็นไปตามแต่ละ format: ใน OpenAI format รหัสอยู่ที่ error.code ส่วนใน format ของ Google เช่นเมื่อไม่ได้ส่ง key จะได้ 401 พร้อม error.status เป็น UNAUTHENTICATED ทั้งสอง format ใช้ key เดียวกัน ยอดเงินเดียวกัน และราคาเท่ากัน ตารางรหัส error ตามสถานะอยู่ที่หน้า OpenAI API ซึ่งใช้กับ Gemini ใน OpenAI format ได้ทั้งหมด

05ราคา Gemini ทุกรุ่นต่อหนึ่งล้าน token

ตารางนี้อ่านจากแคตตาล็อกตอนสร้างหน้า และเป็นราคาที่ถูกหักจากยอดเงินจริง Gemini มักถูกใช้อ่านเอกสารยาว เช่น สัญญาทั้งฉบับ repository ของโค้ด หรือบทถอดเสียงการประชุม ค่าใช้จ่ายของงานแบบนี้เกือบทั้งหมดอยู่ที่ input จึงควรดูราคา input และความยาว context ก่อน แล้วค่อยดูราคา output

เมื่อถามซ้ำบนเอกสารชุดเดิม ส่วนที่ซ้ำและตรงกับ cache จะคิดตามราคา cached input และใบเสร็จแยก token ส่วนนี้ให้เห็น รุ่นที่มีคำว่า preview ในชื่อเป็นรุ่นทดลอง ซึ่ง Google จะเปลี่ยนเป็นชื่อทางการภายหลัง id ที่เขียนลงโค้ดจึงควรยึดตามที่ตารางแสดง

การเลือกรุ่นไม่ต้องเดา: Gemini ทุก id อยู่บน key เดียวกัน ส่ง prompt เดียวกันไปรุ่นละครั้ง แล้วเทียบคำตอบกับค่าใช้จ่ายในใบเสร็จได้ ถ้าต้องการเทียบกับ GPT หรือ Claude ก็แก้เพียงค่า model ดูหน้า OpenAI API และหน้า Claude API

โมเดลผู้พัฒนาInputOutputContext
Gemini 4 Argongemini-4-argonGoogle$0.60≈ ฿20.76$3.00≈ ฿103.781,048,576
Gemini 3.8 Flashgemini-3.8-flashGoogle$0.4925≈ ฿17.04$2.25≈ ฿77.831,048,576
Gemini 3.7 Flashgemini-3.7-flashGoogle$0.4925≈ ฿17.04$2.25≈ ฿77.841,048,576
Gemini 3.5 Flash Litegemini-3.5-flash-liteGoogle$0.225≈ ฿7.78$1.875≈ ฿64.861,048,576
Gemini 3.6 Flashgemini-3.6-flashGoogle$0.4925≈ ฿17.04$2.25≈ ฿77.841,048,576
Gemini 3.5 Flashgemini-3.5-flashGoogle$1.50≈ ฿51.89$9.00≈ ฿311.341,048,576
Gemini 3.1 Flash Lite Previewgemini-3.1-flash-lite-previewGoogle$0.1875≈ ฿6.49$1.125≈ ฿38.921,048,576
Gemini 3.1 Pro Previewgemini-3.1-pro-previewGoogle$1.20≈ ฿41.51$7.20≈ ฿249.071,048,576
Gemini 3.1 PRO Preview LOWgemini-3.1-pro-preview-lowGoogle$5.00≈ ฿172.97$22.50≈ ฿778.351,048,576
Gemini 3 Flash Previewgemini-3-flash-previewGoogle$0.375≈ ฿12.97$2.25≈ ฿77.831,048,576
Gemini 2.5 Flashgemini-2.5-flashGoogle$0.30≈ ฿10.38$2.50≈ ฿86.481,048,576
Gemini 2.5 Progemini-2.5-proGoogle$0.9375≈ ฿32.43$7.50≈ ฿259.451,048,576
Gemini 2.5 Flash Litegemini-2.5-flash-liteGoogle$0.075≈ ฿2.59$0.30≈ ฿10.38
Gemini 3 Pro Previewgemini-3-pro-previewGoogle$5.00≈ ฿172.97$22.50≈ ฿778.35
Gemini 3.1 Flash Litegemini-3.1-flash-liteGoogle$0.15≈ ฿5.19$0.90≈ ฿31.13
Gemini 3.1 PRO Preview Customtoolsgemini-3.1-pro-preview-customtoolsGoogle$4.80≈ ฿166.05$28.80≈ ฿996.291,048,576
Gemini 4 Carbongemini-4-carbonGoogle$2.3529≈ ฿81.40$11.7647≈ ฿406.98
Gemini 4 Hydrogengemini-4-hydrogenGoogle$0.5882≈ ฿20.35$2.9412≈ ฿101.74
Gemini Flash Latestgemini-flash-latestGoogle$1.80≈ ฿62.27$9.00≈ ฿311.341,048,576
Gemini Flash Lite Latestgemini-flash-lite-latestGoogle$0.72≈ ฿24.91$6.00≈ ฿207.561,048,576
Gemini PRO Latestgemini-pro-latestGoogle$4.80≈ ฿166.05$28.80≈ ฿996.291,048,576

USD ต่อหนึ่งล้าน token · ≈ คือราคาอ้างอิงเป็นเงินบาทตามอัตราของธนาคารกลางยุโรป ณ วันที่ 2026-11-13 การคิดค่าบริการเป็นดอลลาร์สหรัฐ

06ก่อนนำ Gemini API ขึ้น production

สร้าง key แยกสำหรับ production ตั้งงบเป็น USD และเพดานรายวัน แล้วใช้ allow-list ของโมเดลจำกัดให้เรียกได้เฉพาะ Gemini id ที่เลือกไว้ โปรแกรมที่อ่านเอกสารยาวยิ่งควรตั้งเพดาน เพราะ request เดียวที่ส่งทั้งโฟลเดอร์เข้าไปโดยไม่ตั้งใจมี input หลายแสน token

เมื่อ request ล้มเหลว ให้อ่าน header retry-after เพื่อกำหนดเวลารอก่อนลองใหม่ ส่วนคำถามว่าโมเดลที่ตอบเป็นตัวจริงตามชื่อหรือไม่ มีการตรวจแบบเปิดเผยวันละครั้ง อธิบายไว้ที่หน้าการตรวจโมเดล

คำถามที่พบบ่อย

เริ่มใช้ Gemini API ที่นี่ต้องทำอย่างไร
แก้สองค่าในโค้ด คือ base_url เป็น https://api.relayswitch.io/v1 และ api_key เป็น key sk-relay- ของ RelaySwitch แล้วเขียน id ของ Gemini ในค่า model โดยเรียกผ่าน Chat Completions ของ OpenAI SDK บัญชีเปิดด้วยอีเมล เติมเงินขั้นต่ำ $10 ด้วยบัตรหรือคริปโต
ต้องมีบัญชี Google หรือ API key จาก AI Studio ไหม
ไม่ต้อง Gemini API ของ Google เองต้องใช้บัญชี Google สร้าง key ใน AI Studio แต่บัญชีที่นี่อยู่กับ RelaySwitch ใช้เพียงอีเมล key สร้างในคอนโซลของ RelaySwitch และ key ตัวเดียวกันเรียกโมเดลอื่นในแคตตาล็อกได้ด้วย
ควรใช้ OpenAI SDK หรือ format ของ Gemini เอง
โปรแกรมที่เขียนใหม่ใช้ OpenAI SDK โดยเปลี่ยน base_url และเมื่อจะสลับไปโมเดลของค่ายอื่นก็แก้เพียงค่า model ส่วนโปรแกรมที่เขียนตาม generateContent ของ Google อยู่แล้ว ส่ง request มาที่ route generateContent ของที่นี่ได้ โดยใส่ key ใน header x-goog-api-key ทั้งสอง format ใช้ key เดียวกัน ยอดเงินเดียวกัน และราคาเท่ากัน
Gemini API ฟรีไหม
Gemini API ของ Google เองมี free tier แบบจำกัดอัตราการเรียกสำหรับบางโมเดล โมเดลใดอยู่ในเงื่อนไขนี้ให้ยึดตามหน้าราคาของ Google ส่วนที่ RelaySwitch ไม่มี free tier: ทุก request หักตาม token จากยอดที่เติมไว้ เติมขั้นต่ำ $10 และยอดเงินไม่มีวันหมดอายุ
ราคา Gemini API ที่นี่เทียบกับราคาทางการเป็นอย่างไร
ราคาของแต่ละรุ่นอยู่ในตารางของหน้านี้ อ่านสดจากแคตตาล็อก หน่วยเป็น USD ต่อหนึ่งล้าน token และหน้าของแต่ละโมเดลแสดงราคาทางการที่ Google ประกาศไว้ข้างกันเมื่อมีข้อมูล ราคาในตารางคือราคาที่ถูกหักจริง
ยืนยันได้อย่างไรว่าที่ตอบคือ Gemini จริง
ทุกโมเดลได้รับ prompt ทดสอบชุดเดียวกันทุกวัน คำตอบถูกเทียบกับรอบก่อนหน้า และผลเปิดเผยที่ https://api.relayswitch.io/v1/proof โดยไม่ต้องใช้ key ทุก request ยังมีใบเสร็จลงลายเซ็นที่ GET https://api.relayswitch.io/v1/requests/:id/receipt ซึ่งระบุ model id, token ที่คิดเงิน และค่าใช้จ่าย
หน้าที่เกี่ยวข้อง

เปลี่ยน base_url แล้วเปลี่ยน model

Base URL คือ https://api.relayswitch.io/v1 Gemini ทุกรุ่นคิดตามราคาสดในแคตตาล็อก และมีการตรวจโมเดลแบบเปิดเผยทุกวัน

โมเดลรับ API key