ส่งภาพให้ Claude API วิเคราะห์อย่างไร? พร้อมตัวอย่างการใช้งาน

Claude API รับภาพพร้อมข้อความในคำขอ Messages API ได้ เหมาะกับงานอ่านภาพสินค้า วิเคราะห์กราฟ ดูเอกสารที่เป็นภาพ หรืออธิบายสิ่งที่ปรากฏในภาพ ผู้ใช้ ComSiam ควรระบุคำถามเกี่ยวกับภาพให้ชัด และส่งภาพผ่าน Backend หากเชื่อมกับเว็บไซต์ เพื่อไม่เปิดเผย API Key ในเบราว์เซอร์

วิธีส่งภาพให้ Claude API

เลือกวิธีตามลักษณะงาน:

① ส่งภาพแบบ Base64
เหมาะเมื่อแอปมีไฟล์ภาพอยู่แล้วและต้องการแนบข้อมูลภาพไปกับคำขอโดยตรง

② ส่ง URL ของภาพ
เหมาะเมื่อภาพอยู่บนพื้นที่ออนไลน์ที่ API เข้าถึงได้ ควรตรวจสิทธิ์และการเปิดเผยไฟล์ก่อนใช้ URL

③ ใช้ Files API และอ้างอิงด้วย file_id
เหมาะกับภาพที่จะใช้ซ้ำหลายครั้ง อัปโหลดภาพก่อน แล้วใช้ file_id ในคำขอแต่ละครั้งแทนการส่งข้อมูล Base64 ซ้ำ

ตัวอย่างโครงสร้างคำขอแบบ Base64

ใส่ภาพและคำถามไว้ใน content เดียวกัน ตัวอย่างนี้แสดงรูปแบบที่ต้องแทน BASE64_IMAGE_DATA ด้วยข้อมูลภาพที่เข้ารหัสจริง:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 700,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/jpeg",
            "data": "BASE64_IMAGE_DATA"
          }
        },
        {
          "type": "text",
          "text": "อธิบายสิ่งที่เห็นในภาพ และระบุจุดที่ควรตรวจสอบ"
        }
      ]
    }
  ]
}

แทน BASE64_IMAGE_DATA ด้วยข้อมูลภาพที่เข้ารหัสแล้ว และปรับ media_type ให้ตรงกับไฟล์ เช่น image/png หรือ image/webp ชื่อโมเดลในตัวอย่างอาจเปลี่ยนแปลง ควรเลือกจากรายการที่บัญชีรองรับ

ขั้นตอนใช้งานกับเว็บไซต์

① ให้ผู้ใช้อัปโหลดหรือเลือกภาพผ่านหน้าเว็บ
② ส่งไฟล์ไปยัง Backend ของเว็บไซต์
③ Backend ตรวจชนิดไฟล์ ขนาด และสิทธิ์ของผู้ใช้
④ Backend ส่งภาพและคำถามไปยัง Claude API
⑤ Backend ส่งคำตอบกลับไปแสดงบนเว็บไซต์

ผู้ใช้ ComSiam ควรหลีกเลี่ยงการเรียก Claude API โดยตรงจากหน้าเว็บพร้อม API Key เพราะผู้เข้าชมอาจตรวจดูคีย์จากโค้ดหรือคำขอเครือข่ายได้

รูปแบบภาพและข้อจำกัดที่ควรรู้

เอกสารทางการระบุว่ารองรับ JPEG, PNG, GIF และ WebP สำหรับ Claude API โดยตรง ภาพ Base64 แต่ละภาพมีขนาดสูงสุด 10 MB และภาพมีขนาดสูงสุด 8,000 × 8,000 พิกเซล อย่างไรก็ตาม ขนาดคำขอรวมของ Messages API มีข้อจำกัดด้วย หากมีภาพจำนวนมากหรือไฟล์ใหญ่ คำขออาจชนเพดานรวมก่อนถึงจำนวนภาพสูงสุด

หากภาพมีขนาดใหญ่ ให้ย่อความละเอียดหรือบีบอัดก่อนส่ง หากใช้ URL ให้แน่ใจว่าระบบเข้าถึงภาพได้ และหากใช้ Files API ให้จัดเก็บความเชื่อมโยงระหว่างผู้ใช้กับไฟล์ไว้ฝั่งเซิร์ฟเวอร์

เขียนคำถามให้ได้คำตอบตรงเป้าหมาย

แทนที่จะถามว่า “ภาพนี้คืออะไร” ให้ระบุงานที่ต้องการ เช่น:

• “อ่านตัวเลขในกราฟ แล้วสรุปแนวโน้มจากซ้ายไปขวา”
• “อธิบายข้อความบนป้าย และแจ้งคำที่อ่านไม่ชัด”
• “เปรียบเทียบสินค้าสองภาพตามสี รูปทรง และสภาพที่เห็น”
• “สรุปสิ่งที่ปรากฏในภาพ โดยแยกสิ่งที่มองเห็นจากข้อสันนิษฐาน”

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

ดูแลความเป็นส่วนตัวของภาพ

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

สรุป

ส่งภาพให้ Claude API ได้ด้วย Base64, URL หรือ Files API โดยแนบภาพพร้อมคำถามใน Messages API เลือกรูปแบบตามตำแหน่งและการใช้ภาพซ้ำ ตรวจชนิดไฟล์กับขนาดก่อนส่ง และเรียก API ผ่าน Backend เมื่อเชื่อมกับเว็บไซต์ ผู้ใช้ ComSiam ควรตรวจคำตอบกับภาพจริงและจัดการข้อมูลส่วนตัวก่อนอัปโหลด