iApp Image Generation

สร้างภาพจากคำอธิบายภาษาไทยหรืออังกฤษ โดยข้อความที่คุณกำหนดปรากฏในภาพตรงตามที่เขียนทุกตัวอักษร

POST/v3/store/image-generation/iapp-image-generation/generateทดลองใช้

• ราคา1.5 ICต่อครั้ง
• รองรับ1,000 ภาพ/ชั่วโมง
• ให้บริการแล้ว8.9Kครั้ง

• v1.1.3-20260904
• ใช้งานได้

Input

prompt

การ์ดอวยพรวันเกิดสีพาสเทล มีเค้กและลูกโป่ง ลายเส้นน่ารักแบบภาพประกอบ

text

สุขสันต์วันเกิด

font

itim

size

1024x1024

OutputPOST /v3/store/image-generation/iapp-image-generation/generate

status

success

id

20260902-054442-f26467

width

1024

height

1024

font

itim

text

สุขสันต์วันเกิด

mime_type

image/png

time

translate: 3.1 generate: 8.6 total: 11.8

iapp

images: 1 version: 1.0.0-20260902

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Response

ภาพจาก API นี้

สร้างด้วย v1.1.0 เมื่อ 3 กันยายน 2569 ไม่ผ่านการตกแต่ง คลิกภาพเพื่อดูขนาดเต็ม

ก๋วยเตี๋ยวเรือ อร่อยมากฟอนต์ kanit-bold

สวัสดีปีใหม่ฟอนต์ kanit-bold

ยินดีต้อนรับสู่ประเทศไทยฟอนต์ charm

ชาไทย 35 บาทฟอนต์ sriracha

น้ำปลาแท้ฟอนต์ taviraj

กรุงเทพมหานคร 25 กม.ฟอนต์ notosans

กาแฟบ้านสวนฟอนต์ mitr

ทุเรียนหมอนทองฟอนต์ sriracha

Request

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": "itim", \
    "size": "1024x1024" \
  }'

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
  "status": "success",
  "id": "20260902-054442-f26467",
  "width": 1024,
  "height": 1024,
  "font": "itim",
  "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" }
}

Request

ส่งเป็น JSON ครั้งละหนึ่งภาพ Request ที่ล้มเหลวหรือถูกปฏิเสธไม่คิดเงิน ช่วงพรีวิวคิด 1.5 IC ต่อภาพ และจะใช้ราคาเต็ม 3 IC เมื่อพรีวิวสิ้นสุด โดยประกาศล่วงหน้าอย่างน้อย 14 วัน

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

promptstringrequired

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

textstring | array

ข้อความที่ต้องปรากฏในภาพ รายการละหนึ่งบรรทัด หรือสตริงที่ขึ้นบรรทัดใหม่ ไม่เกิน 4 บรรทัด บรรทัดละ 120 ตัวอักษร ข้อความไทยที่อยู่ใน prompt แต่ไม่อยู่ใน text ไม่รับประกัน

fontstring

รหัสฟอนต์จากรายการด้านล่าง ค่าเริ่มต้น kanit-bold

sizestring

1024x1024 (ค่าเริ่มต้น) 1280x768, 768x1280, 1536x1024 หรือ 1024x1536

stylestring

คำบอกสไตล์ต่อท้ายคำอธิบาย: photorealistic, flat vector, watercolor

seedinteger

กำหนดค่าสุ่ม เพื่อให้ได้ภาพเดิมซ้ำได้

reference_imagestring

ภาพ PNG, JPEG หรือ WebP เป็น Base64 ใส่ prefix data: ได้ ไม่เกิน 6 MB ภาพที่ได้จะคงตัวแบบ ลักษณะ และสไตล์ของภาพนี้ ส่วนที่เหลือทำตามคำอธิบาย

personsarray

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

person_referencestring

off (ค่าเริ่มต้น) หรือ auto ซึ่งสแกนคำอธิบายหาบุคคลมีชื่อเสียงที่เขียนด้วยชื่อเต็มหรือตำแหน่งทางการ แนะนำให้ใช้ persons แทน

text_scalenumber

ความกว้างของกล่องข้อความเทียบกับภาพ 0.2 ถึง 0.9 ค่าเริ่มต้น 0.55

Endpoint	ทำอะไร	ราคา
POST /v3/store/image-generation/iapp-image-generation/generate	สร้างภาพหนึ่งภาพ	3 IC ต่อภาพ ช่วงพรีวิว 1.5 IC
GET …/fonts	รายการฟอนต์	ฟรี
GET …/persons?q=	ค้นหาบุคคลสาธารณะไทยจากชื่อ	ฟรี
GET …/persons/portrait?id=	ภาพย่อของบุคคล	ฟรี
POST …/persons/detect	บุคคลที่จำได้ในคำอธิบาย สำหรับขั้นยืนยัน	ฟรี

ฟอนต์ทั้ง 19 แบบ

ทั้งหมดเผยแพร่ภายใต้ SIL Open Font License kanit-bold (ค่าเริ่มต้น) kanit, prompt-bold, prompt: สมัยใหม่ sarabun-bold, sarabun: ทางการ สำหรับเอกสาร mitr: มน เป็นมิตร chakrapetch-bold: เชิงเทคนิค เรขาคณิต athiti-bold: กระชับ k2d-bold: ตัวโชว์ notosans: sans-serif กลาง ๆ pridi, taviraj, notoserif: มีเชิง itim: ขี้เล่น mali, sriracha: ลายมือ charm: ลายมือหวัด srisakdi: ประดับ

บุคคล: ค้นหา ภาพย่อ ตรวจจับ

Endpoint ฟรีที่อยู่เบื้องหลังปุ่ม @ ในเดโม ใช้โควตาร่วมกัน 20 ครั้งต่อวินาทีต่อคีย์

• ค้นหา GET …/persons?q=<ชื่อ>&limit=<n>: ชื่อไทยหรือละติน เต็มหรือบางส่วน ถ้า q ว่างจะได้บุคคลที่ถูกเรียกมากที่สุด limit 1 ถึง 24 ค่าเริ่มต้น 12 แต่ละผลมี id ที่คงที่ name ภาษาไทย name_en และ role สำหรับผู้ดำรงตำแหน่ง
• ภาพย่อ GET …/persons/portrait?id=<id>&size=<px>: JPEG จัตุรัส size 48 ถึง 320 ค่าเริ่มต้น 128 แคช 24 ชั่วโมง ได้ 404 เมื่อไม่มีภาพ
• ตรวจจับ POST …/persons/detect พร้อม {"prompt": "…"}: บุคคลที่จำได้ในคำอธิบายไม่เกินสี่คน แต่ละคนมี id, name, name_en, role ข้อความ matched และ kind (role, full หรือ short) ระบบไม่เพิ่มใครเอง ใช้ถามผู้ใช้ว่าใครควรได้ใบหน้าจริง แล้วส่งรหัสที่ยืนยันแล้วใน persons

Response

ภาพเป็น Base64 ใน image_base64 พร้อม mime_type, width และ height ค่า font, text และ seed ที่ใช้ time แยกเป็น translate, generate และ total และ text_check ซึ่ง result เป็น ok, duplicate, missing หรือ extra บอกว่าข้อความออกมาครั้งเดียวพอดีหรือไม่ ทุก Response ที่สำเร็จมี header iapp-input-images: 1

ภาพเป็น Base64 ใน image_base64 พร้อม mime_type, width และ height ค่า font, text และ seed ที่ใช้ time แยกเป็น translate, generate และ total และ text_check ซึ่ง result เป็น ok, duplicate, missing หรือ extra บอกว่าข้อความออกมาครั้งเดียวพอดีหรือไม่ ทุก Response ที่สำเร็จมี header iapp-input-images: 1

รหัสสถานะ

รหัส	ความหมาย
400	size, font หรือฟิลด์อื่นไม่ถูกต้อง ข้อความแจ้งชื่อฟิลด์
422	ถูกตัวกรองความปลอดภัยปฏิเสธ prompt_rejected ก่อนสร้าง หรือ content_rejected หลังตรวจภาพ ไม่คิดเงิน
503	โมเดลกำลังเริ่มทำงาน ลองใหม่ใน 60 วินาที

รายละเอียดเพิ่มเติม

ผลการทดสอบ

รายการ	ผล
ข้อความไทยตรงตามที่เขียน ชุดแกลเลอรี 34 prompt 3 ก.ย. 2569	32 จาก 34 คือ 94%
ข้อความไทยถูกทุกตัวอักษร ชุดตรวจรับ 11 prompt 2 ก.ย. 2569	11 จาก 11
เวลาสร้างภาพ 1024 × 1024	20 ถึง 45 วินาที
กำลังให้บริการ	ราว 17 ภาพต่อนาที หรือ 1,000 ภาพต่อชั่วโมง เกินกว่านั้นต้องรอคิว

ข้อจำกัด

• จำกัดต่อคีย์: 2 ครั้งต่อวินาที 30 ครั้งต่อนาที 600 ครั้งต่อชั่วโมง
• ตัวอักษรคงรูปตามฟอนต์ที่เลือก เอฟเฟกต์เช่นแสงนีออนหรือพื้นผิวชอล์กใส่ได้เพียงบางส่วน
• คำอธิบายที่มีเนื้อหาทางเพศ เนื้อหาทางเพศเกี่ยวกับผู้เยาว์ หรือความรุนแรงสยดสยองถูกปฏิเสธก่อนสร้าง และทุกภาพถูกตรวจหลังสร้าง ถ้าในภาพมีบุคคลจริงผ่าน persons หรือ reference_image จะถูกปฏิเสธเมื่อมีนัยทางเพศใด ๆ รวมถึงชุดว่ายน้ำ

การจัดการข้อมูล

คำอธิบายและข้อความใช้เพื่อสร้างภาพที่ขอเท่านั้น ภาพส่งกลับใน Response และถูกลบภายใน 24 ชั่วโมง โมเดลรันบน GPU ของไอแอพพ์เอง ไม่มีคำอธิบายหรือภาพใดถูกส่งไปบุคคลที่สาม บริการเป็นไปตาม GDPR และ PDPA

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v1.1.3-20260904	4 ก.ย. 2569	ความรู้วัฒนธรรมไทยเพิ่มจาก 31 เป็น 791 แนวคิดจากวิกิพีเดียภาษาไทย จำได้ทั้งคำไทยและอังกฤษตามขอบเขตคำ และไม่จับคำที่มีความหมายอื่นในบริบท ผ่านชุดทดสอบทั้ง 50 คำอธิบาย
v1.1.2-20260904	4 ก.ย. 2569	สิ่งไทยที่ระบุในคำอธิบาย เช่น เครื่องแบบ สงกรานต์ บวช มวยไทย โขน ศาลพระภูมิ และอาหาร ออกมาตรงกับของจริง จาก 12 prompt เรื่องไทย เดิมผิด 5 ตอนนี้ถูกทั้ง 12
v1.1.1-20260904	4 ก.ย. 2569	ตัวกรองความปลอดภัยทั้งก่อนและหลังสร้าง การตรวจชื่อจำกัดที่ชื่อเต็ม ตำแหน่งทางการ และชื่อต้นของคนมีชื่อเสียง เพิ่ม POST …/persons/detect และจำกัด endpoint บุคคลที่ 20 ครั้งต่อวินาที
v1.1.0-20260903	3 ก.ย. 2569	วางข้อความเป็นส่วนหนึ่งของฉากจริง เพิ่ม text_check ใน Response เพิ่ม reference_image และบุคคลสาธารณะไทยกว่า 4,000 คนผ่าน persons จากชุดข้อมูล iApp Thai Famous People
v1.0.0-20260902	2 ก.ย. 2569	เปิดพรีวิว: คำอธิบายไทยและอังกฤษ ข้อความไทยตรงตามที่เขียนด้วยฟอนต์ 19 แบบ ห้าขนาด 1.5 IC ต่อภาพ