Skip to main content

iApp Image Generation

โมเดล AI สร้างรูปภาพ โมเดลแรกของคนไทย โดยทีม iApp Technology! ภาษาไทย แม่นเฉียบ พลาดน้อยมาก

เวอร์ชัน 1.1.0 — เพิ่มความเป็นไทยและความสมจริงเข้าไปอีก

ข้อความกลมกลืนกับพื้นผิวจริงในภาพแทนแผ่นป้ายสีขาว ใส่บุคคลที่มีชื่อเสียงของไทยกว่า 4,000 คนลงในภาพได้ด้วยปุ่ม @ อัปโหลดภาพอ้างอิงได้ ระบุบุคคลได้สูงสุด 2 คนต่อภาพ โดยใช้ 2 ชื่อแรกที่กล่าวถึง รายละเอียดในบันทึกการเปลี่ยนแปลง

iApp Image Generation คือโมเดลสร้างภาพภาษาไทยตัวแรก พัฒนาและปรับจูน (fine-tune) โดยทีม iApp Technology สำหรับภาษาไทยโดยเฉพาะ สร้างภาพจากคำอธิบายภาษาไทยหรือภาษาอังกฤษ และวางข้อความภาษาไทยหรือภาษาอังกฤษที่คุณกำหนดลงในภาพอย่างถูกต้องทุกตัวอักษร ทั้งสระและวรรณยุกต์ โดยเลือกฟอนต์ไทยได้ 19 แบบ และรู้จักสิ่งที่เป็นไทยอย่างถูกต้อง เครื่องแบบ พิธี เทศกาล ชุดไทย และอาหารที่ระบุในคำอธิบายจะออกมาตรงตามของจริง เหมาะกับงานที่การสะกดผิดเป็นเรื่องที่ยอมรับไม่ได้ เช่น โปสเตอร์ ป้ายร้าน การ์ดอวยพร ฉลากสินค้า สไลด์นำเสนอ แบนเนอร์ และภาพสำหรับโซเชียลมีเดีย โมเดลสร้างภาพทั่วไปมักวาดตัวอักษรไทยออกมาเป็นเส้นที่ดูคล้ายภาษาไทยแต่อ่านไม่ได้ iApp Image Generation สะกดได้ถูกต้อง ในการสร้างชุดตัวอย่างเวอร์ชัน 1.1.0 จำนวน 34 คำขอเมื่อ 3 กันยายน 2569 ภาพ 32 จาก 34 ภาพ (94%) แสดงข้อความภาษาไทยถูกต้องตรงตามที่พิมพ์ เพียงครั้งเดียว และไม่มีตัวอักษรอื่นเพิ่มเข้ามา

ทดลองใช้งาน

อธิบายภาพเป็นภาษาไทยหรือภาษาอังกฤษ ใส่ข้อความภาษาไทยหรือภาษาอังกฤษที่ต้องปรากฏในภาพ เลือกฟอนต์และขนาด หรือเลือกจากตัวอย่าง 29 ภาพด้านล่าง

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

พิมพ์ @ เพื่อดึงใบหน้าจากฐานข้อมูลคนดังไทยกว่า 4,000 คน (เช่น @อนุทิน) หรือพิมพ์ชื่อตามปกติ เมื่อกดสร้างภาพ ระบบจะแสดงชื่อที่รู้จักให้ติ๊กเลือกว่าจะใช้ใบหน้าจริงของใคร ระบุได้สูงสุด 2 คนต่อภาพ
ภาพที่สร้างจะคงบุคคล สินค้า หรือสไตล์จากภาพนี้ไว้ รองรับ JPEG หรือ PNG
ภาพที่สร้างจะแสดงที่นี่
คำขอในรูปแบบ cURL
curl -X POST 'https://api.iapp.co.th/v3/store/image-generation/iapp-image-generation/generate' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"โปสเตอร์โปรโมชั่นร้านกาแฟสไตล์มินิมอล โทนสีน้ำตาลครีม ตรงกลางมีแก้วกาแฟลาเต้อาร์ตรูปใบไม้บนจานรองไม้ มีเมล็ดกาแฟโปรยรอบ ๆ ข้อความอยู่ในแถบสีครีมด้านบนของโปสเตอร์ แสงอบอุ่นจากด้านข้าง เงานุ่ม จัดวางแบบนิตยสาร มีพื้นที่ว่างสบายตา","text":["กาแฟสด ลด 50%"],"font":"kanit-bold","size":"768x1280","person_reference":"off"}'

ตัวอย่างภาพที่สร้างจริง 29 ภาพ

ภาพทั้ง 29 ภาพด้านล่างสร้างด้วย iApp Image Generation เวอร์ชัน 1.1.0 เมื่อ 3 กันยายน 2569 ตามคำขอที่แสดงในแต่ละการ์ด โดยไม่มีการแก้ไขภาพ คลิกที่ภาพเพื่อดูขนาดเต็ม หรือกดปุ่มเพื่อนำคำขอไปใส่ในหน้าทดลองใช้งาน

ก๋วยเตี๋ยวเรือ อร่อยมาก
ก๋วยเตี๋ยวเรือ อร่อยมาก
ป้ายร้านอาหาร · ฟอนต์ kanit-bold · 1280 × 768
ภาพถ่ายป้ายไม้ทาสีแดงหน้าร้านก๋วยเตี๋ยวเรือริมคลองในกรุงเทพฯ แสงแดดตอนเช้า
ปัญญาประดิษฐ์ไทย ก้าวไกลระดับโลก
ปัญญาประดิษฐ์ไทย ก้าวไกลระดับโลก
วิทยากรบนเวที (ระบุชื่อบุคคล) · ฟอนต์ kanit-bold · 1280 × 768
ภาพถ่ายจากงานจริง ดร.กอบกฤตย์ วิริยะยุทธกร ยืนบรรยายอยู่ด้านหน้าเวทีงานสัมมนาเทคโนโลยี AI ในห้องประชุมโรงแรม ถ่ายระยะกลางเห็นใบหน้าชัดเจน กำลังพูดกับผู้ฟัง ฉากหลังเป็นจอ LED ขนาดใหญ่สีน้ำเงินเข้มที่แสดงข้อความ แสงไฟเวทีโทนอุ่น
สองบุคคล ไม่มีข้อความ
สองบุคคล ไม่มีข้อความ
สองบุคคล ไม่มีข้อความ · ฟอนต์ kanit-bold · 768 × 1280
อนุทิน และ ทักษิณ ยืนจับมือกัน ถ่ายภาพหน้าตรง
บุคคลเดียว ไม่มีข้อความ
บุคคลเดียว ไม่มีข้อความ
บุคคลเดียว ไม่มีข้อความ · ฟอนต์ kanit-bold · 1280 × 768
ดร.กอบกฤตย์ วิริยะยุทธกร สวมเสื้อเชิ้ตสีขาวและแว่นตา กำลังประกอบและปรับแต่งหุ่นยนต์ฮิวแมนนอยด์สีขาวเงินสูงเท่าคน ในห้องแล็บวิศวกรรมหุ่นยนต์ทันสมัย ถือไขควงไฟฟ้า มีแขนกลและจอมอนิเตอร์แสดงแผนภาพวงจรอยู่ด้านหลัง แสงไฟห้องแล็บโทนเย็น ภาพถ่ายสารคดีระยะกลาง เห็นใบหน้าชัดเจน
พอร์เทรตชุดล้านนา (ไม่มีข้อความ)
พอร์เทรตชุดล้านนา (ไม่มีข้อความ)
พอร์เทรตชุดล้านนา (ไม่มีข้อความ) · ฟอนต์ kanit-bold · 768 × 1280
ภาพพอร์เทรตหญิงสาวไทยอายุประมาณ 20-25 ปี สวมชุดล้านนาแบบดั้งเดิม เสื้อปั๊ดแขนยาวเข้ารูปสีขาวหรือพาสเทล ผ้าซิ่นตีนจกไหมทอมือลายสีแดง เหลือง เขียวสดใส เข็มขัดเงินหรือทองเหลืองคาดเอว เกล้าผมมวยแบบล้านนาทัดดอกไม้สดหรือกล้วยไม้ ต่างหูและกำไลเงิน ยืนอย่างสง่างามถือตะกร้าสานใบเล็ก ในหมู่บ้านล้านนาที่มีเรือนไม้ใต้ถุนสูงและดอกไม้ป่าเป็นฉากหลัง แสงธรรมชาตินุ่มช่วงโกลเดนอาวร์ โทนอุ่น ระยะชัดตื้น ภาพสมจริง รายละเอียดผ้าและเครื่องประดับคมชัด บรรยากาศงดงามสงบและเปี่ยมวัฒนธรรม
สุขสันต์วันเกิด
สุขสันต์วันเกิด
การ์ดวันเกิด · ฟอนต์ itim · 1024 × 1024
การ์ดอวยพรวันเกิดสีพาสเทล มีเค้กและลูกโป่ง ลายเส้นน่ารักแบบภาพประกอบ
สวัสดีปีใหม่
สวัสดีปีใหม่
การ์ดปีใหม่ · ฟอนต์ kanit-bold · 1024 × 1024
การ์ดอวยพรปีใหม่สุดหรู ไล่สีน้ำเงินเข้มถึงกรมท่า ดอกไม้ไฟสีทองเหนือเส้นขอบฟ้ากรุงเทพฯ ตอนเที่ยงคืน สะท้อนบนแม่น้ำเจ้าพระยา ประกายทองละเอียด คำอวยพรเป็นตัวอักษรสีทองขนาดใหญ่ตรงกลางด้านบนของการ์ด ออกแบบเต็มภาพไม่มีขอบ
ยินดีต้อนรับสู่ประเทศไทย
ยินดีต้อนรับสู่ประเทศไทย
ป้ายนีออน · ฟอนต์ charm · 1280 × 768
ป้ายไฟนีออนสีชมพูเรืองแสงบนกำแพงอิฐสีเข้มตอนกลางคืน สไตล์ภาพยนตร์
ชาไทย 35 บาท
ชาไทย 35 บาท
เมนูกระดานดำ · ฟอนต์ sriracha · 1024 × 1024
เมนูกระดานดำในคาเฟ่ เขียนด้วยชอล์กสีขาว มีรูปชาไทยเย็นวาดข้างข้อความ
น้ำปลาแท้
น้ำปลาแท้
ฉลากสินค้า · ฟอนต์ taviraj · 1024 × 1024
ภาพถ่ายสินค้าในสตูดิโอ ขวดน้ำปลาแก้วใสทรงสูงบนหินอ่อนสีครีม แสงนุ่มโทนอุ่น ฉลากกระดาษสีน้ำเงินทองสไตล์คลาสสิก ข้อความพิมพ์กลางฉลากพอดีภายในกรอบ
กรุงเทพมหานคร 25 กม.
กรุงเทพมหานคร 25 กม.
ป้ายจราจร · ฟอนต์ notosans · 1280 × 768
ภาพถ่ายป้ายบอกทางสีเขียวบนทางหลวงในประเทศไทย ติดตั้งบนโครงเหล็กคร่อมถนนที่ว่างเปล่า ท้องฟ้าสีฟ้าใส ถ่ายจากถนนด้านล่าง ป้ายมีเฉพาะข้อความตัวอักษรสีขาว ไม่มีลูกศรหรือสัญลักษณ์
กาแฟบ้านสวน
กาแฟบ้านสวน
หน้าร้านคาเฟ่ · ฟอนต์ mitr · 1280 × 768
ภาพถ่ายหน้าร้านคาเฟ่ในสวน ป้ายไม้แขวน ต้นไม้และไฟประดับ
ทุเรียนหมอนทอง
ทุเรียนหมอนทอง
ป้ายแผงผลไม้ · ฟอนต์ sriracha · 1280 × 768
ภาพถ่ายแผงทุเรียนในตลาดสดไทย ป้ายสีเหลืองเขียนมือ กองทุเรียน
สู้ ๆ นะ
สู้ ๆ นะ
สติกเกอร์ · ฟอนต์ mali · 1024 × 1024
ภาพเวกเตอร์แบบแบนของสติกเกอร์ไดคัทชิ้นเดียว แมวส้มยิ้มน่ารักถือป้ายเล็ก ๆ ที่มีข้อความ ขอบสีขาวหนารอบสติกเกอร์ สีแบนสดใส วางกลางพื้นหลังสีเทาอ่อนเรียบ ๆ ไม่มีอย่างอื่น
ลดโลกร้อน
ลดโลกร้อน
กระเป๋าผ้า · ฟอนต์ athiti-bold · 1024 × 1024
ภาพถ่ายสินค้า กระเป๋าผ้าแคนวาสสีธรรมชาติแบบเรียบ มีหูหิ้วยาวสองข้าง ตั้งอยู่บนโต๊ะไม้ริมหน้าต่าง ข้อความสกรีนสีเขียวกลางกระเป๋า แสงธรรมชาตินุ่ม
สวัสดีครับ
สวัสดีครับ
รอยสัก · ฟอนต์ mali · 1024 × 1024
ภาพถ่ายระยะใกล้ของท่อนแขนชายไทยวางบนโต๊ะ ข้อความถูกสักบนผิวหนังด้วยหมึกสีดำเหมือนรอยสักจริง ขอบนุ่มเล็กน้อย แสงธรรมชาติ ระยะชัดตื้น
ขอเชิญร่วมงานมงคลสมรส
ขอเชิญร่วมงานมงคลสมรส
การ์ดแต่งงาน · ฟอนต์ notoserif · 1024 × 1024
การ์ดเชิญงานแต่งงานหรูหรา กระดาษสีครีม กรอบดอกไม้ฟอยล์สีทอง เรียบง่าย
รักแม่ที่สุด
รักแม่ที่สุด
การ์ดวันแม่ · ฟอนต์ mali · 1024 × 1024
การ์ดวันแม่ ดอกมะลิสีขาวบนพื้นสีฟ้า สไตล์สีน้ำนุ่มนวล
ปัญญาประดิษฐ์เพื่อคนไทย
ปัญญาประดิษฐ์เพื่อคนไทย
สไลด์นำเสนอ · ฟอนต์ chakrapetch-bold · 1280 × 768
สไลด์นำเสนอองค์กรเทคโนโลยี พื้นหลังสีน้ำเงินเข้มไล่เฉด มีกราฟิกโครงข่ายประสาทเทียมเรืองแสงด้านขวา
คอนเสิร์ตใหญ่ 2569
คอนเสิร์ตใหญ่ 2569
บัตรคอนเสิร์ต · ฟอนต์ chakrapetch-bold · 1280 × 768
บัตรคอนเสิร์ต สีม่วงเข้ม แสงไฟเวทีและเงาฝูงชน บาร์โค้ดด้านขวา
เปิดแล้ววันนี้
เปิดแล้ววันนี้
ป้ายบิลบอร์ด · ฟอนต์ kanit-bold · 1280 × 768
ป้ายบิลบอร์ดขนาดใหญ่ริมถนนโฆษณาห้างใหม่เปิดตัว การจราจรในเมืองยามเย็นด้านล่าง สมจริง
ตลาดนัดกลางคืน
ตลาดนัดกลางคืน
ป้ายตลาดนัด · ฟอนต์ kanit-bold · 1280 × 768
ซุ้มทางเข้าตลาดนัดกลางคืนของไทย หลอดไฟหลากสี ผู้คนและร้านอาหาร
ส้มตำแซ่บ
ส้มตำแซ่บ
ป้ายร้านส้มตำ · ฟอนต์ charm · 1280 × 768
ป้ายไฟนีออนสีเขียวของร้านส้มตำในถนนตลาดกลางคืน แสงโบเก้อบอุ่น
ยินดีต้อนรับนักเรียนใหม่
ยินดีต้อนรับนักเรียนใหม่
ป้ายโรงเรียน · ฟอนต์ sarabun-bold · 1280 × 768
ป้ายไวนิลต้อนรับหน้าประตูโรงเรียนไทย สีน้ำเงินขาว นักเรียนเดินเข้า
ลดสูงสุด 70%
ลดสูงสุด 70%
แบนเนอร์ลดราคา · ฟอนต์ kanit-bold · 1280 × 768
แบนเนอร์ลดราคากลางปีของห้างสรรพสินค้า สีแดงเหลืองสดใส มีถุงช้อปปิ้งและกระดาษโปรย
ข้าวหอมมะลิ
ข้าวหอมมะลิ
ถุงข้าว · ฟอนต์ pridi · 1024 × 1024
ภาพถ่ายสินค้าถุงข้าวหอมมะลิพรีเมียม บรรจุภัณฑ์สีเขียวทอง มีภาพประกอบทุ่งนา
ขนมปังอบใหม่
ขนมปังอบใหม่
ป้ายร้านเบเกอรี่ · ฟอนต์ itim · 1280 × 768
หน้าต่างโชว์ร้านเบเกอรี่ ขนมปังอบใหม่ ป้ายสไตล์ชอล์ก แสงอบอุ่น
รักเมืองไทย
รักเมืองไทย
เสื้อยืด · ฟอนต์ prompt-bold · 1024 × 1024
คนใส่เสื้อยืดสีขาวสกรีนข้อความภาษาไทยตัวใหญ่ ถ่ายกลางแจ้งแนวสตรีท
ห้ามจอดรถ บริเวณนี้
ห้ามจอดรถ บริเวณนี้
ประกาศ · ฟอนต์ sarabun-bold · 1024 × 1024
ภาพถ่ายระยะใกล้ ประกาศกระดาษ A4 ติดเทปบนประตูกระจกสำนักงาน

เริ่มต้นใช้งาน

ต้องมี API key จาก iApp AI Portal ส่งคำขอเป็น JSON พร้อมส่วนหัว apikey:

curl -X POST https://api.iapp.co.th/v3/store/image-generation/iapp-image-generation/generate \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "การ์ดอวยพรวันเกิดสีพาสเทล มีเค้กและลูกโป่ง ลายเส้นน่ารักแบบภาพประกอบ",
"text": "สุขสันต์วันเกิด",
"font": "kanit-bold",
"size": "1024x1024"
}'
{
"status": "success",
"id": "20260902-054442-f26467",
"width": 1024,
"height": 1024,
"font": "kanit-bold",
"text": ["สุขสันต์วันเกิด"],
"mime_type": "image/png",
"image_base64": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zU...",
"time": { "translate": 3.1, "generate": 8.6, "total": 11.8 },
"iapp": { "images": 1, "version": "1.0.0-20260902" }
}

ตัวอย่างโค้ด Python และ JavaScript อยู่ในข้อมูลอ้างอิงทางเทคนิค

Endpoint และราคา

Endpointรายละเอียดราคา
POST /v3/store/image-generation/iapp-image-generation/generateสร้างภาพ 1 ภาพ3 IC ต่อภาพ — 1.5 IC ในช่วง Preview
GET /v3/store/image-generation/iapp-image-generation/fontsรายชื่อฟอนต์ไทยที่ใช้ได้ฟรี
GET /v3/store/image-generation/iapp-image-generation/personsค้นหาบุคคลที่มีชื่อเสียงของไทยจากชื่อ สำหรับฟิลด์ persons (รายละเอียด)ฟรี
GET /v3/store/image-generation/iapp-image-generation/persons/portraitภาพใบหน้าขนาดย่อของรหัสบุคคลฟรี
POST /v3/store/image-generation/iapp-image-generation/persons/detectรายชื่อบุคคลที่รู้จักในคำอธิบาย สำหรับขั้นตอนยืนยันฟรี

คิดค่าบริการเฉพาะคำขอที่สำเร็จ ราคา Preview ใช้กับทุกบัญชีตลอดช่วง Preview และจะกลับเป็นราคาปกติหลังสิ้นสุดช่วง Preview โดยแจ้งล่วงหน้าอย่างน้อย 14 วัน

ประสิทธิภาพ

วัดจากระบบให้บริการจริง วันที่ 2 กันยายน 2569 หนึ่งภาพต่อคำขอ

ตัวชี้วัดค่า
เวลาสร้างภาพ (1024 × 1024)20–45 วินาทีต่อภาพ ตั้งแต่เวอร์ชัน 1.1.0
ความจุในการให้บริการประมาณ 17 ภาพต่อนาที หรือประมาณ 1,000 ภาพต่อชั่วโมง บน GPU 4 ตัว คำขอที่เกินกว่านั้นจะรอคิวตามลำดับก่อนหลัง
ขนาดภาพ1024 × 1024, 1280 × 768, 768 × 1280, 1536 × 1024, 1024 × 1536
ข้อความสูงสุด 4 บรรทัด บรรทัดละไม่เกิน 120 ตัวอักษร ฟอนต์ไทย 19 แบบ
คำอธิบายภาพภาษาไทยหรืออังกฤษ ไม่เกิน 1,500 ตัวอักษร
ขีดจำกัดอัตราการเรียก (ต่อ API key)2 ครั้งต่อวินาที, 30 ครั้งต่อนาที, 600 ครั้งต่อชั่วโมง

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

ความถูกต้องของข้อความภาษาไทย

ความถูกต้องของข้อความภาษาไทยถูกวัดผลทุกเวอร์ชัน ในชุดทดสอบภายใน 11 คำขอ ครอบคลุมป้าย โปสเตอร์ สไลด์ ฉลาก และเสื้อผ้า (2 กันยายน 2569) ภาพทั้ง 11 ภาพแสดงข้อความภาษาไทยถูกต้องทุกตัวอักษร และในการสร้างชุดตัวอย่างเวอร์ชัน 1.1.0 จำนวน 34 คำขอเมื่อ 3 กันยายน 2569 ภาพ 32 ภาพ (94%) แสดงข้อความถูกต้องเพียงครั้งเดียวโดยไม่มีตัวอักษรอื่น ตัวอย่าง 29 ภาพ ด้านบนนำมาจากชุดนี้โดยไม่มีการตกแต่งภาพ

คำตอบรายงานในฟิลด์ text_check ว่าข้อความที่ขอถูกแสดงตรงตามที่พิมพ์หรือไม่ (result เป็น ok, duplicate, missing หรือ extra)

ข้อจำกัด 2 ประการ:

  • ตัวอักษรคงรูปทรงตามฟอนต์ที่เลือก เอฟเฟกต์ตกแต่ง เช่น แสงนีออนหรือพื้นผิวชอล์ก โมเดลจะใส่ให้เพียงบางส่วน
  • ข้อความภาษาไทยที่อยู่ใน prompt แต่ไม่อยู่ใน text ไม่รับประกันความถูกต้อง ให้ใส่ทุกข้อความที่ต้องปรากฏในภาพลงใน text

ความปลอดภัยของข้อมูล

  • บริการเป็นไปตาม GDPR และ PDPA
  • คำอธิบายภาพและข้อความถูกใช้เพื่อสร้างภาพที่ร้องขอเท่านั้น
  • ภาพที่สร้างส่งกลับในคำตอบโดยตรง และถูกลบออกจากระบบภายใน 24 ชั่วโมง
  • โมเดลทำงานบนโครงสร้างพื้นฐาน GPU ที่ iApp ดูแลเอง ไม่มีการส่งคำอธิบายภาพหรือภาพไปยังผู้ให้บริการสร้างภาพภายนอก
  • ความปลอดภัยของเนื้อหา: คำอธิบายภาพที่มีเนื้อหาทางเพศ เนื้อหาทางเพศที่เกี่ยวกับผู้เยาว์ หรือความรุนแรงสยดสยองจะถูกปฏิเสธก่อนสร้างภาพ และภาพที่สร้างทุกภาพผ่านการตรวจด้วยตัวจำแนก NSFW คำขอที่แสดงบุคคลจริง (ผ่าน persons หรือ reference_image) จะถูกปฏิเสธเมื่อมีสัญญาณทางเพศใด ๆ แม้เพียงชุดว่ายน้ำหรือชุดชั้นใน คำขอที่ถูกปฏิเสธจะได้รับ HTTP 422 และไม่คิดเครดิต

ข้อมูลอ้างอิงทางเทคนิค

คำขอ

POST /v3/store/image-generation/iapp-image-generation/generate รับ application/json พร้อมส่วนหัว apikey

ฟิลด์ชนิดจำเป็นรายละเอียด
promptstringใช่ฉากที่ต้องการสร้าง ภาษาไทยหรืออังกฤษ (ไม่เกิน 1,500 ตัวอักษร) ข้อความในเครื่องหมายคำพูดคู่ภายใน prompt จะถูกวางลงในภาพอย่างถูกต้องด้วย
textstring หรือ arrayไม่ข้อความภาษาไทยที่ต้องปรากฏในภาพ หนึ่งบรรทัดต่อหนึ่งรายการ หรือสตริงเดียวคั่นด้วยขึ้นบรรทัดใหม่ (สูงสุด 4 บรรทัด)
fontstringไม่รหัสฟอนต์จากตารางด้านล่าง ค่าเริ่มต้น kanit-bold
sizestringไม่1024x1024 (ค่าเริ่มต้น), 1280x768, 768x1280, 1536x1024, 1024x1536
stylestringไม่คำใบ้สไตล์เพิ่มเติม เช่น photorealistic, flat vector, watercolor
seedintegerไม่กำหนดค่าสุ่มเพื่อให้ได้ผลลัพธ์เดิมซ้ำได้
reference_imagestringไม่ภาพอ้างอิงแบบ base64 (PNG, JPEG หรือ WebP รองรับคำนำหน้า data: URL) ขนาดไม่เกิน 6 MB ภาพที่สร้างจะคงบุคคล สินค้า สถานที่ หรือผลงานในภาพนี้ รวมถึงลักษณะและสไตล์ แล้วทำตามคำอธิบายในส่วนที่เหลือ เพิ่มในเวอร์ชัน 1.1.0
personsarray of stringไม่รหัสบุคคลที่มีชื่อเสียงของไทยสูงสุด 2 คน เรียงจากซ้ายไปขวา ได้จาก GET …/persons?q= (ระบบค้นหาเบื้องหลังปุ่ม @ ในหน้าทดลองใช้งาน ไม่คิดค่าบริการ) เป็นวิธีที่แน่นอนที่สุดในการใส่บุคคลที่ต้องการลงในภาพ
person_referencestringไม่off (ค่าเริ่มต้น): ชื่อในคำขอถือเป็นคำทั่วไป auto: ค้นหาบุคคลที่มีชื่อเสียงของไทยในคำขอจากชื่อ-นามสกุลเต็มหรือตำแหน่งอย่างเป็นทางการที่สะกดถูกต้อง แนะนำให้ใช้ persons แทน
text_scalenumberไม่ความกว้างของบล็อกข้อความเทียบกับภาพ 0.2–0.9 ค่าเริ่มต้น 0.55

คำตอบที่สำเร็จทุกรายการมีส่วนหัว iapp-input-images: 1

คำตอบ

{
"status": "success",
"id": "20260902-071417-3b2093",
"width": 768,
"height": 1280,
"font": "kanit-bold",
"text": ["กาแฟสด ลด 50%"],
"seed": null,
"mime_type": "image/png",
"image_base64": "...",
"time": { "translate": 3.2, "generate": 10.0, "total": 13.4 },
"iapp": { "images": 1, "version": "1.0.0-20260902" }
}

ฟอนต์

GET /v3/store/image-generation/iapp-image-generation/fonts ส่งรายการนี้กลับ ฟอนต์ทั้งหมดเผยแพร่ภายใต้สัญญาอนุญาต SIL Open Font License

รหัสฟอนต์ลักษณะ
kanit-boldKanit Bold (ค่าเริ่มต้น)สมัยใหม่ ตัวหนา
kanitKanitสมัยใหม่
prompt-boldPrompt Boldสมัยใหม่ ตัวหนา
promptPromptสมัยใหม่
sarabun-boldSarabun Boldทางการ เอกสาร
sarabunSarabunทางการ เอกสาร
mitrMitrมน เป็นมิตร
chakrapetch-boldChakra Petch Boldเทคโนโลยี เรขาคณิต
athiti-boldAthiti Boldกะทัดรัด
k2d-boldK2D Boldพาดหัว
notosansNoto Sans Thaiซานเซอริฟมาตรฐาน
pridiPridiเซอริฟ
tavirajTavirajเซอริฟ
notoserifNoto Serif Thaiเซอริฟ
itimItimน่ารัก
maliMaliลายมือ
srirachaSrirachaลายมือ
charmCharmลายมือหวัด
srisakdiSrisakdiประดิษฐ์

บุคคล (ค้นหาใบหน้า)

Endpoint ฟรี 3 รายการนี้ทำให้แอปพลิเคชันทำทุกอย่างที่ปุ่ม @ ในหน้าทดลองใช้งานทำได้: ค้นหาบุคคลที่มีชื่อเสียงของไทย แสดงภาพใบหน้า และส่งรหัสไปยัง generate ในฟิลด์ persons ชื่อที่พิมพ์ในคำอธิบายถือเป็นคำทั่วไป เฉพาะรหัสใน persons เท่านั้นที่ใส่ใบหน้าจริงลงในภาพ (สูงสุด 2 คนต่อภาพ เรียงจากซ้ายไปขวา) endpoint กลุ่มนี้มีขีดจำกัดอัตรา 20 คำขอต่อวินาทีต่อ API key

ค้นหาGET …/persons?q=<ชื่อ>&limit=<n> q เป็นชื่อภาษาไทยหรืออังกฤษ เต็มหรือบางส่วนก็ได้ (อนุทิน, kobkrit) หาก q ว่างจะได้รายชื่อบุคคลที่ถูกเรียกใช้บ่อยที่สุด limit อยู่ระหว่าง 1 ถึง 24 ค่าเริ่มต้น 12 ผลลัพธ์แต่ละรายการมี id ที่คงที่ ชื่อไทย name, name_en และ role สำหรับผู้ดำรงตำแหน่งปัจจุบัน

{
"status": "success",
"query": "อนุทิน",
"persons": [
{"id": "w0000", "name": "อนุทิน ชาญวีรกูล", "name_en": "Anutin Charnvirakul", "role": "นายกรัฐมนตรี"}
]
}

ภาพใบหน้าGET …/persons/portrait?id=<id>&size=<px> คืนภาพ JPEG สี่เหลี่ยมจัตุรัสของบุคคล (size 48 ถึง 320 ค่าเริ่มต้น 128 แคช 24 ชั่วโมง) สำหรับหน้าจอเลือกหรือยืนยัน หรือ 404 หากรหัสนั้นไม่มีภาพ

ตรวจจับชื่อPOST …/persons/detect พร้อม {"prompt": "…"} คืนรายชื่อบุคคลที่รู้จักในคำอธิบาย (สูงสุด 4 คน): id, name, name_en, role, ข้อความที่ตรง matched และ kind (role, full หรือ short สำหรับชื่อต้นเดี่ยว ๆ) endpoint นี้ไม่ใส่ใบหน้าใครลงในภาพเอง ใช้เพื่อถามผู้ใช้ว่าชื่อใดควรใช้ใบหน้าจริง แล้วส่งรหัสที่ยืนยันแล้วใน persons

{
"status": "success",
"persons": [
{"id": "1258", "name": "ทักษิณ ชินวัตร", "name_en": "Thaksin", "role": "", "matched": "ทักษิณ", "kind": "short"},
{"id": "w0000", "name": "อนุทิน ชาญวีรกูล", "name_en": "Anutin Charnvirakul", "role": "นายกรัฐมนตรี", "matched": "อนุทิน", "kind": "short"}
]
}

คำขอที่มี persons หรือ reference_image อยู่ภายใต้นโยบายเนื้อหาแบบเข้มงวด: สัญญาณทางเพศใด ๆ แม้เพียงชุดว่ายน้ำหรือชุดชั้นใน จะถูกปฏิเสธด้วย HTTP 422 และไม่คิดเครดิต

import base64
import requests

BASE = "https://api.iapp.co.th/v3/store/image-generation/iapp-image-generation"
HEADERS = {"apikey": "YOUR_API_KEY"}

# 1. Find the people (Thai or Latin, a first name is enough for well-known people)
ids = []
for name in ("อนุทิน", "ทักษิณ"):
r = requests.get(f"{BASE}/persons", params={"q": name, "limit": 3}, headers=HEADERS, timeout=30)
ids.append(r.json()["persons"][0]["id"]) # ["w0000", "1258"]

# 2. Generate with their faces, in left-to-right order
payload = {"prompt": "อนุทิน และ ทักษิณ ยืนจับมือกัน ถ่ายภาพหน้าตรง", "size": "768x1280", "persons": ids}
r = requests.post(f"{BASE}/generate", headers=HEADERS, json=payload, timeout=300)
r.raise_for_status()
with open("handshake.png", "wb") as f:
f.write(base64.b64decode(r.json()["image_base64"]))

ข้อผิดพลาด

สถานะ HTTPความหมาย
400ค่า size, font หรือฟิลด์อื่นไม่ถูกต้อง ข้อความจะระบุชื่อฟิลด์
401ไม่มีหรือ apikey ไม่ถูกต้อง
402เครดิตไม่เพียงพอ
422ถูกปฏิเสธโดยตัวกรองความปลอดภัยของเนื้อหา (prompt_rejected ก่อนสร้างภาพ, content_rejected หลังตรวจสอบภาพ) ไม่คิดเครดิต
429เกินขีดจำกัดอัตราการเรียกของ API key นี้
503โมเดลกำลังเริ่มทำงาน ลองใหม่ใน 60 วินาที

ตัวอย่างโค้ด

curl -X POST https://api.iapp.co.th/v3/store/image-generation/iapp-image-generation/generate \
-H "apikey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "ป้ายไฟนีออนเรืองแสงยามค่ำคืนบนถนนข้าวสาร", "text": "ยินดีต้อนรับสู่ประเทศไทย", "font": "prompt-bold", "size": "1280x768"}' \
| python3 -c "import sys, json, base64; r = json.load(sys.stdin); open('image.png', 'wb').write(base64.b64decode(r['image_base64'])); print(r['time'])"

บันทึกการเปลี่ยนแปลง

เวอร์ชันวันที่การเปลี่ยนแปลง
v1.1.3-202609044 ก.ย. 2569ขยายความรู้วัฒนธรรมไทยจาก 31 เป็น 791 เรื่อง จากวิกิพีเดียภาษาไทย: อาหารและขนมพื้นถิ่น เครื่องดนตรีและวงดนตรี ผ้าทอ เทศกาลและพิธีกรรม ผีและวัตถุมงคล เรือพระราชพิธี ตลาด สถาปัตยกรรม และสัญลักษณ์ประจำชาติ การรู้จำทำงานทั้งคำไทยและอังกฤษ ตามขอบเขตคำ รองรับการสะกดต่างกัน และไม่ตีความคำที่มีความหมายอื่นในบริบท (กระทงใบตองไม่ใช่กระทงลอยกระทง) ทดสอบกับคำอธิบาย 50 รายการที่กำหนดผลที่ต้องได้และห้ามได้ ผ่านทั้งหมด
v1.1.2-202609044 ก.ย. 2569ความถูกต้องทางวัฒนธรรมไทย: โมเดลรู้จักสิ่งที่เป็นไทยที่ระบุในคำอธิบาย ทั้งภาษาไทยและอังกฤษ โดยไม่ต้องพิมพ์อะไรเพิ่ม และแสดงออกมาตรงตามของจริง ได้แก่ ชุดนักเรียนและชุดนักศึกษา เครื่องแบบทหารบก ทหารเรือ ทหารอากาศ ตำรวจ และข้าราชการ (ชุดกากีและชุดปกติขาว) ลอยกระทง ไหว้ครู สงกรานต์ งานบวช มวยไทย (มงคลและประเจียด) พระสงฆ์บิณฑบาต ชุดไทย โขน ศาลพระภูมิ รถตุ๊กตุ๊ก ธงชาติ และอาหาร เช่น ส้มตำ ขนมครก ต้มยำ ผัดไทย ข้าวเหนียวมะม่วง แกงเขียวหวาน และก๋วยเตี๋ยวเรือ ในการทดสอบคำอธิบายเกี่ยวกับวัฒนธรรมไทย 12 คำขอ ก่อนหน้านี้ผิด 5 ภาพ ตอนนี้ถูกต้องทั้ง 12 ภาพ ภาพถ่ายที่ไม่ได้ขอข้อความมีโอกาสน้อยลงมากที่จะมีตัวอักษรที่โมเดลเติมเอง
v1.1.1-202609044 ก.ย. 2569เปิดใช้ตัวกรองความปลอดภัยของเนื้อหา: คำอธิบายที่มีเนื้อหาทางเพศ เนื้อหาทางเพศที่เกี่ยวกับผู้เยาว์ หรือความรุนแรงสยดสยองจะถูกปฏิเสธก่อนสร้างภาพ และภาพที่สร้างทุกภาพผ่านการตรวจสอบหลังสร้างเสร็จ คำขอที่แสดงบุคคลจริง (persons หรือ reference_image) จะถูกปฏิเสธเมื่อมีสัญญาณทางเพศใด ๆ คำขอที่ถูกปฏิเสธได้รับ HTTP 422 และไม่คิดเครดิต การตรวจจับชื่อเข้มงวดขึ้น: นับเฉพาะชื่อ-นามสกุลเต็ม ตำแหน่งอย่างเป็นทางการ และชื่อต้นของบุคคลที่เป็นที่รู้จัก ไม่นับชื่อเล่นหรือคำเดี่ยว เพิ่ม endpoint ฟรี POST …/persons/detect คืนรายชื่อบุคคลที่รู้จักในคำอธิบาย หน้าทดลองใช้งานแสดงกล่องยืนยันก่อนสร้างภาพทุกครั้ง ระบุคำอธิบาย บุคคลที่จะใช้ใบหน้าจริง และข้อความแต่ละบรรทัดพร้อมช่องติ๊ก และเพิ่มปุ่มล้างค่า endpoint บุคคลมีขีดจำกัดอัตราของตัวเอง 20 คำขอต่อวินาที เวลาสร้างภาพระบุเป็น 20–45 วินาที
v1.1.0-202609033 ก.ย. 2569ปรับจูนโมเดลให้แสดงข้อความสมจริงยิ่งขึ้น: ตัวอักษรถูกวางเป็นส่วนหนึ่งของฉากจริง (ป้าย แบนเนอร์ พื้นผิวที่ทาสีหรือมีไฟ) แทนแผ่นป้ายสีขาว คำตอบรายงานในฟิลด์ text_check ว่าข้อความถูกแสดงตรงตามที่พิมพ์หรือไม่ บุคคลที่มีชื่อเสียงของไทย: ฝึกโมเดลด้วยข้อมูลบุคคลที่มีชื่อเสียงของไทยมากกว่า 4,000 คนจากชุดข้อมูล iApp Thai Famous People เมื่อระบุชื่อบุคคลในคำขอ ภาพที่ได้จะเป็นใบหน้าของบุคคลนั้น ในหน้าทดลองใช้งาน พิมพ์ @ แล้วเลือกบุคคลจากรายการ (แสดงภาพใบหน้าให้ดู) ส่วน API รับรหัสเดียวกันในฟิลด์ใหม่ persons ระบุได้สูงสุด 2 คนต่อภาพ ชื่อที่พิมพ์เป็นข้อความธรรมดาจะไม่ถูกตรวจจับ เว้นแต่ตั้ง person_reference เป็น auto ภาพอ้างอิง: ฟิลด์ใหม่ reference_image (และในหน้าทดลองใช้งานด้านบน) คงบุคคล สินค้า หรือสไตล์จากภาพที่อัปโหลด สร้างชุดตัวอย่างใหม่ทั้งหมดในรุ่นนี้
v1.0.0-202609022 ก.ย. 2569เปิดตัว Preview: รองรับคำอธิบายภาษาไทยและอังกฤษ ข้อความไทยถูกต้องทุกตัวอักษรด้วยฟอนต์ 19 แบบ ขนาดภาพ 5 แบบ ราคา Preview 1.5 IC ต่อภาพ