วิธีใช้ Gemini 3.6 Flash API

คุณเรียกใช้งาน Gemini 3.6 Flash ด้วยโมเดล ID gemini-3.6-flash ผ่าน Gemini API ของ Google นั่นคือแก่นหลักของมัน Google ได้เปิดตัว Flash รุ่นปรับปรุงเมื่อวันที่ 21 กรกฎาคม 2026 และ 3.6 Flash คือ รุ่นที่เป็นหัวใจหลักในการทำงาน: ให้ผลลัพธ์ที่ถูกกว่า 3.5 Flash, มีหน้าต่างบริบท (context window) ขนาด 1M โทเค็น, และสามารถรับอินพุตเป็นข้อความ รูปภาพ วิดีโอ เสียง และ PDF คู่มือนี้จะพาคุณตั้งแต่เริ่มต้นจนถึงการเรียกใช้งานที่ผ่านการทดสอบ คุณจะได้คีย์ ทำการเรียกใช้งานครั้งแรกด้วย curl และ Python เรียนรู้พารามิเตอร์ที่สำคัญ และตั้งค่าการทดสอบ regression เพื่อให้การเรียกใช้งานยังคงทำงานได้หลังจากที่คุณนำไปใช้งานจริง

ดาวน์โหลดแอป

สิ่งที่ต้องเตรียมก่อนเริ่มต้น

สามสิ่งนี้ และไม่มีค่าใช้จ่ายในการเริ่มต้น

บัญชี Google นั่นคือวิธีที่คุณจะใช้ลงชื่อเข้าสู่ระบบเพื่อรับคีย์
คีย์ Gemini API ฟรีจาก Google AI Studio ซึ่งส่วนถัดไปจะกล่าวถึงเรื่องนี้
วิธีส่งคำขอ HTTP. curl สามารถทำงานได้จากเทอร์มินัลใดก็ได้ Python สามารถใช้งานได้หากคุณต้องการเขียนโค้ด คุณยังสามารถใช้ไคลเอ็นต์ API เช่น Apidog หากคุณต้องการ UI สำหรับทั้งหมดนี้ เราจะแสดงให้เห็นทั้งสามวิธี

ไม่จำเป็นต้องตั้งค่าการเรียกเก็บเงินล่วงหน้า ระดับฟรีจะทำงานผ่าน AI Studio และมีการจำกัดอัตรา (rate-limited) ดังนั้นคุณจึงสามารถทดสอบได้โดยไม่ต้องใช้บัตรเครดิต ข้อมูลเพิ่มเติมเกี่ยวกับขีดจำกัดเหล่านั้นอยู่ด้านล่าง

รับคีย์ Gemini API

ไปที่ Google AI Studio และลงชื่อเข้าใช้ด้วยบัญชี Google ของคุณ คลิก "Get API key" จากนั้น "Create API key" คัดลอกสตริงที่ได้มาและเก็บไว้ในที่ปลอดภัย ปฏิบัติต่อมันเหมือนรหัสผ่าน: ใครก็ตามที่มีคีย์สามารถใช้จ่ายผ่านบัญชีของคุณได้

อย่าแปะคีย์ลงในโค้ดฝั่งไคลเอ็นต์ และอย่า commit ลงใน repo ให้ตั้งค่าเป็นตัวแปรสภาพแวดล้อม (environment variable) แทน:

export GEMINI_API_KEY="your_key_here"

Python SDK อย่างเป็นทางการจะอ่านตัวแปรนั้นด้วยตัวเอง ซึ่งช่วยให้ความลับไม่อยู่ในไฟล์ต้นฉบับของคุณ สำหรับขั้นตอนการตั้งค่าที่เป็นทางการ โปรดดู เอกสาร Gemini API ของ Google

ทำการเรียก API ครั้งแรกของคุณ

เอนด์พอยต์ REST คือการส่งคำขอ POST ไปยังเมธอด generateContent ของโมเดล นี่คือตัวอย่างใน curl:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {"text": "Explain how APIs work"}
        ]
      }
    ]
  }'

คีย์จะอยู่ในส่วนหัว x-goog-api-key ส่วนเนื้อหาคืออาร์เรย์ contents; แต่ละรายการมีอาร์เรย์ parts; แต่ละส่วนในที่นี้คือสตริง text การจัดเรียงแบบซ้อนกันนี้อาจดูยุ่งยากสำหรับพร้อมต์เดียว แต่เป็นรูปแบบเดียวกันที่ช่วยให้คุณสามารถผสมผสานข้อความกับรูปภาพและไฟล์ในการเรียกใช้งานครั้งเดียวในภายหลัง

ชอบ Python ใช่ไหม? ติดตั้ง SDK ด้วย pip install google-genai จากนั้น:

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY from the environment
resp = client.models.generate_content(
    model="gemini-3.6-flash",
    contents="Explain how APIs work",
)
print(resp.text)

ไคลเอ็นต์จะรับ GEMINI_API_KEY ด้วยตัวเอง ดังนั้นจึงไม่มีคีย์อยู่ในโค้ดของคุณ resp.text จะเก็บคำตอบที่สร้างขึ้น นั่นคือการเรียกใช้งานที่ใช้งานได้จริงในห้าบรรทัด

ภายใต้การทำงานภายใน API จะคืนค่า JSON ข้อความที่สร้างขึ้นจะอยู่ที่ candidates[0].content.parts[0].text ควรบันทึกไว้ตอนนี้ เพราะเป็นฟิลด์ที่คุณจะยืนยันเมื่อคุณเปลี่ยนการเรียกใช้งานนี้เป็นการทดสอบในภายหลังในคู่มือนี้

พารามิเตอร์สำคัญที่ควรรู้

คำขอพื้นฐานสามารถทำงานได้ แต่มีการตั้งค่าบางอย่างที่จะเปลี่ยนผลลัพธ์ที่คุณได้รับ

คำสั่งระบบ (System instruction) กำหนดบุคลิกหรือชุดกฎที่ใช้กับบทสนทนาทั้งหมด ซึ่งแยกออกจากพร้อมต์ของผู้ใช้ ใช้สำหรับ "ตอบกลับเป็น JSON เท่านั้น" หรือ "คุณคือนักตรวจสอบโค้ดที่พูดน้อย" มันช่วยกำหนดโทนเสียงและรูปแบบได้อย่างน่าเชื่อถือมากกว่าการยัดคำสั่งลงในทุกข้อความ
โทเค็นเอาต์พุตสูงสุด (Max output tokens) กำหนดความยาวของการตอบกลับ 3.6 Flash สามารถสร้างโทเค็นเอาต์พุตได้สูงสุด 64k ดังนั้นให้เพิ่มขีดจำกัดสำหรับการสร้างที่ยาวนานและลดลงเมื่อคุณต้องการควบคุมค่าใช้จ่ายและเวลาแฝง
อินพุตแบบหลายรูปแบบ (Multimodal inputs) โมเดลสามารถอ่านข้อความ รูปภาพ วิดีโอ เสียง และ PDF ได้ในการเรียกใช้งานเดียวกัน คุณสามารถเพิ่มสิ่งเหล่านี้เป็นรายการเพิ่มเติมในอาร์เรย์ parts ควบคู่ไปกับข้อความของคุณ ผลลัพธ์จะเป็นข้อความเท่านั้น ดังนั้นให้คิดว่าเป็นการรับอินพุตหลายประเภท และได้ผลลัพธ์เป็นคำ หน้าต่างบริบท (context window) สามารถเก็บโทเค็นอินพุตได้สูงสุด 1M ซึ่งเพียงพอสำหรับ PDF ขนาดใหญ่หรือถอดเสียงวิดีโอแบบเต็ม
การคิดและการให้เหตุผล (Thinking and reasoning) 3.6 Flash ให้เหตุผลก่อนที่จะตอบในพร้อมต์ที่ยาก นั่นคือสิ่งที่ช่วยปรับปรุงการทำงานแบบหลายขั้นตอน และเป็นเหตุผลที่ราคาเอาต์พุต (output price) รวมโทเค็นการคิด (thinking tokens) ด้วย (ข้อมูลเพิ่มเติมในส่วนถัดไป) คุณสามารถปรับการให้เหตุผลได้เมื่อคุณต้องการแลกเปลี่ยนความลึกกับความเร็ว

รายการพารามิเตอร์ทั้งหมดอยู่ใน เอกสาร Gemini API อย่าเดาชื่อฟิลด์; เอกสารคือแหล่งข้อมูลที่เชื่อถือได้และจะอัปเดตเมื่อ API มีการเปลี่ยนแปลง

ราคาและระดับฟรี

Gemini 3.6 Flash มีค่าใช้จ่าย $1.50 ต่อ 1M โทเค็นอินพุต และ $7.50 ต่อ 1M โทเค็นเอาต์พุต อัตราเอาต์พุตนี้ลดลงจาก $9.00 ที่ 3.5 Flash เรียกเก็บ และ 3.6 Flash ยังมีแนวโน้มที่จะสร้างโทเค็นเอาต์พุตน้อยลงประมาณ 17% สำหรับงานเดียวกัน ดังนั้นการประหยัดจึงทบต้น รายละเอียดหนึ่งที่ควรทำความเข้าใจ: ราคาเอาต์พุตได้รวมโทเค็นการคิดไว้ด้วย การให้เหตุผลภายในของโมเดลจะถูกเรียกเก็บเงินตามอัตราเอาต์พุต ดังนั้นพร้อมต์ที่กระตุ้นการให้เหตุผลที่หนักหน่วงอาจมีค่าใช้จ่ายมากกว่าความยาวคำตอบที่มองเห็นได้ โปรดจัดสรรงบประมาณสำหรับสิ่งนี้ เราได้แจกแจงการคำนวณทั้งหมดใน คู่มือราคา Gemini 3.6 Flash ของเรา

ระดับฟรีทำงานผ่าน AI Studio และใช้งานได้จริง แต่มีการจำกัดอัตรา (rate-limited): จำกัดจำนวนคำขอต่อนาทีและต่อวัน และ Google อาจใช้ข้อมูลจากระดับฟรีเพื่อปรับปรุงผลิตภัณฑ์ของตน เหมาะสำหรับการสร้างต้นแบบ ไม่ใช่สำหรับการใช้งานจริง สำหรับการเรียนรู้และการทดสอบก็เพียงพอแล้ว หากต้องการดูว่าสามารถใช้งานได้มากน้อยเพียงใด โปรดอ่าน วิธีใช้ Gemini 3.6 Flash ฟรี เมื่อคุณต้องการใช้งานเกินกว่านั้น คุณสามารถเปิดใช้งานการเรียกเก็บเงินและใช้คีย์เดิมได้ โดยไม่จำเป็นต้องเปลี่ยนแปลงโค้ด

ทดสอบและแก้ไขข้อบกพร่อง Gemini API ใน Apidog

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

Apidog เป็นไคลเอ็นต์ API และแพลตฟอร์มการทดสอบ นี่คือขั้นตอนการเรียกใช้งาน Gemini ตั้งแต่ต้นจนจบ:

สร้างคำขอ (Create the request) เพิ่มคำขอ POST ใหม่ด้วย URL https://generativelanguage.googleapis.com/v1beta/models/gemini-3.6-flash:generateContent วางเนื้อหา JSON จากก่อนหน้านี้ลงในส่วนเนื้อหาคำขอ
จัดเก็บคีย์ในตัวแปรสภาพแวดล้อม (Store the key in an environment variable) เพิ่มตัวแปรชื่อ GEMINI_API_KEY ไปยังสภาพแวดล้อม Apidog จากนั้นอ้างอิงถึงมันในส่วนหัว x-goog-api-key เป็น {{GEMINI_API_KEY}} ความลับจะยังคงไม่ถูกเปิดเผยในคำขอที่แชร์ และคุณสามารถสลับคีย์สำหรับแต่ละสภาพแวดล้อม (dev, staging, prod) โดยไม่ต้องแก้ไขการเรียกใช้งานเอง
เพิ่มการยืนยัน (Add assertions) หลังจากเรียกใช้งานคำขอ ให้ยืนยันการตอบกลับ JSON: สถานะคือ 200 และ candidates[0].content.parts[0].text มีอยู่และไม่ว่างเปล่า ตอนนี้การทำงานที่ผ่านหมายความว่า API ตอบกลับจริง ไม่ใช่แค่ส่งคืนบางสิ่งบางอย่าง
บันทึกและกำหนดเวลา (Save it and schedule it) เก็บคำขอไว้ในคอลเลกชันและ กำหนดเวลาเป็นการทดสอบ regression เรียกใช้ตามเวลาหรือภายใน CI แล้วคุณจะพบว่าเมื่อใดที่การเรียกใช้งาน Gemini หยุดทำงานตามที่ควรจะเป็น ก่อนที่ผู้ใช้ของคุณจะพบ

ดาวน์โหลด Apidog แล้วคุณจะสามารถเรียกใช้การทดสอบนี้ได้ภายในไม่กี่นาที นั่นคือประโยชน์ที่แท้จริง: Apidog ไม่ได้รันโมเดล แต่ทำให้แน่ใจว่า API ที่คุณพึ่งพาจะยังคงตอบสนองตามที่แอปของคุณคาดหวัง

ข้อผิดพลาดและการแก้ไขที่พบบ่อย

ข้อผิดพลาดสามประการครอบคลุมส่วนใหญ่ที่คุณจะเจอในช่วงแรก

401 Unauthorized (invalid key) คีย์ผิด ถูกยกเลิก หรือหายไปจากส่วนหัว ตรวจสอบว่า x-goog-api-key มีสตริงที่ถูกต้องจาก AI Studio และตัวแปรสภาพแวดล้อมของคุณถูกแก้ไขอย่างถูกต้อง สาเหตุส่วนใหญ่คือช่องว่างท้ายสุดหรือ {{GEMINI_API_KEY}} ที่ไม่ได้ถูกขยาย
429 Too Many Requests (rate limit) คุณถึงขีดจำกัดต่อนาทีหรือต่อวันของระดับฟรี ลดอัตราคำขอ เพิ่มการลองใหม่พร้อม backoff หรือเปิดใช้งานการเรียกเก็บเงินเพื่อเพิ่มขีดจำกัด ลูปการทดสอบที่รวดเร็วทำให้เกิดปัญหานี้ได้ง่าย
404 Not Found (model not found) ส่วนใหญ่มักเกิดจากการพิมพ์ผิดใน model id ต้องเป็น gemini-3.6-flash อย่างแน่นอน ไม่ใช่ gemini-3.5-flash หรือ gemini-flash-3.6 ระดับ Lite ในรุ่นเดียวกันนี้คือ gemini-3.5-flash-lite ซึ่งเป็นโมเดลที่แตกต่างกันในสาย 3.5 ดังนั้นอย่าสับสนระหว่างกัน

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

model id ที่แน่นอนสำหรับ Gemini 3.6 Flash คืออะไร? คือ gemini-3.6-flash ใช้เป็นชื่อโมเดลใน SDK และใน REST URL path ก่อน :generateContent
Gemini 3.6 Flash API ใช้งานฟรีหรือไม่? มีระดับฟรีผ่าน AI Studio และมีการจำกัดอัตรา (rate-limited) เหมาะสำหรับการสร้างต้นแบบและการเรียนรู้ การใช้งานจริงจำเป็นต้องเปิดใช้งานการเรียกเก็บเงิน สำหรับรายละเอียด โปรดดู วิธีใช้งานฟรี
ฉันสามารถส่งอะไรไปยังโมเดลได้บ้าง? ข้อความ รูปภาพ วิดีโอ เสียง และ PDF ได้สูงสุดถึงหน้าต่างบริบท (context window) ขนาด 1M โทเค็น ผลลัพธ์จะเป็นข้อความเท่านั้น
ทำไมบิลของฉันถึงสูงกว่าคำตอบที่เห็น? ราคาเอาต์พุต $7.50 ต่อ 1M โทเค็นรวมถึงโทเค็นการคิดของโมเดล พร้อมต์ที่ต้องใช้การให้เหตุผลมากจะถูกเรียกเก็บเงินมากกว่าความยาวคำตอบที่แสดงบนหน้าจอ
นี่เหมือนกับ Gemini 3.5 Flash API รุ่นเก่าหรือไม่? รูปแบบการเรียกใช้งานเหมือนกัน ดังนั้นหากคุณ เคยใช้ Gemini 3.5 API คุณเพียงแค่สลับ model id ก็เสร็จสิ้น 3.6 Flash ช่วยลดราคาเอาต์พุตและใช้โทเค็นเอาต์พุตน้อยลงสำหรับงานเดียวกัน
ฉันสามารถใช้คีย์เดียวกันใน curl, Python และ Apidog ได้หรือไม่? ได้ คีย์เดียวจาก AI Studio สามารถใช้ได้กับทุกแพลตฟอร์ม เก็บไว้ในตัวแปรสภาพแวดล้อมในแต่ละเครื่องมือแทนการฮาร์ดโค้ด แล้วคุณจะสามารถเปลี่ยนหรือยกเลิกคีย์ได้จากที่เดียว

จะไปต่อจากนี้ที่ไหน

คุณมีคีย์, การเรียกใช้งานที่ใช้ได้จริงใน curl และ Python, พารามิเตอร์ที่สำคัญ, และการทดสอบ regression ที่บันทึกไว้คอยเฝ้าดูเอนด์พอยต์ เริ่มต้นที่ระดับฟรี, เก็บกุญแจของคุณไว้ในตัวแปรสภาพแวดล้อม, และอิงจาก เอกสารทางการ สำหรับสิ่งใดๆ ที่เกินกว่าพื้นฐาน เมื่อการเรียกใช้งานกลายเป็นสิ่งที่แอปของคุณต้องพึ่งพา ให้ห่อหุ้มมันด้วยการทดสอบ Apidog เพื่อให้การเปลี่ยนแปลง API ที่เงียบงันไม่ถึงมือผู้ใช้ของคุณก่อน

ดาวน์โหลดแอป