ทำความเข้าใจ Endpoint สำหรับสร้างภาพ การเลือกโมเดล การตั้งค่าพารามิเตอร์ และวิธีส่งคำขอ

ตอนนี้ LLM API Gateway รองรับการสร้างภาพแล้ว ไม่ว่าจะเป็นภาพหน้าปก WeChat Official Account ภาพประกอบผลิตภัณฑ์ ไอคอนแอป ภาพสินค้าอีคอมเมิร์ซ หรือภาพประกอบอัตโนมัติสำหรับ Agent คุณก็สร้างภาพได้โดยตรงผ่าน Endpoint เดียว Endpoint สำหรับสร้างภาพ: POST https://api.llm-token.cn/v1/images/generations

1. เริ่มต้นอย่างรวดเร็ว: เตรียม 3 อย่างนี้ให้พร้อม ✨

สิ่งที่ต้องเตรียม	ค่าที่ต้องกรอก
API Key สำหรับเข้าถึง LLM API Gateway	เพิ่ม `Authorization: Bearer 你的new-api-token` ใน header ของคำขอ
Endpoint สำหรับสร้างภาพ	`https://api.llm-token.cn/v1/images/generations`
โมเดลสร้างภาพ	`image-01` หรือ `image-01-live`

LLM API Gateway รวมการเข้าถึงโมเดล ความเข้ากันได้ของ API การจัดการโควตา และกฎการคิดค่าบริการไว้ในที่เดียว คุณใช้เพียง API Key ของ LLM API Gateway ก็เรียกใช้ความสามารถในการสร้างภาพผ่าน Endpoint เดียวได้

2. เรียกใช้งานได้ภายใน 1 นาที: ตัวอย่าง curl 🚀

แทนที่ YOUR_NEW_API_TOKEN ด้านล่างด้วย API Key ของ LLM API Gateway เพื่อทดสอบได้ทันที

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

สำหรับการทดสอบครั้งแรก แนะนำให้สร้างเพียง 1 ภาพด้วยการตั้งค่า n: 1 เมื่อยืนยันแล้วว่าสร้างภาพได้ตามปกติ จึงค่อยปรับอัตราส่วนภาพ สไตล์ และจำนวนตามต้องการ

3. ต้องตั้งค่าพารามิเตอร์ของคำขออย่างไร 🧩

พารามิเตอร์	จำเป็น	ค่าที่ใช้บ่อย	รายละเอียด
`model`	ใช่	`image-01`	ชื่อโมเดลสำหรับสร้างภาพ หากต้องการความสามารถในการสร้างภาพแบบเรียลไทม์มากขึ้น สามารถใช้ `image-01-live` ได้
`prompt`	ใช่	กรอกตามภาพที่ต้องการ	อธิบายภาพที่ต้องการสร้าง ควรระบุวัตถุหลัก สไตล์ สี องค์ประกอบภาพ และวัตถุประสงค์ให้ชัดเจน
`response_format`	ไม่	`url`	แนะนำให้ใช้ `url` เพื่อรับลิงก์ภาพโดยตรง หรือใช้ `base64` ได้ตามความต้องการของระบบ
`n`	ไม่	`1`	จำนวนภาพที่สร้างต่อคำขอ สำหรับการทดสอบทั่วไปแนะนำให้ใช้ `1`
`aspect_ratio`	ไม่	`1:1`	อัตราส่วนภาพ ค่าที่ใช้บ่อย ได้แก่ `1:1`, `16:9`, `9:16`, `4:3`, `3:4` และ `21:9`
`prompt_optimizer`	ไม่	`false`	กำหนดว่าจะเปิดใช้การปรับปรุง prompt หรือไม่ หากต้องการให้โมเดลทำตามข้อความต้นฉบับอย่างเคร่งครัด แนะนำให้ใช้ `false`
`seed`	ไม่	จำนวนเต็ม	ช่วยให้สร้างผลลัพธ์ซ้ำได้ใกล้เคียงเดิม หากต้องการผลลัพธ์คล้ายกันในการสร้างหลายครั้ง ให้ใช้ seed ค่าเดียวกัน
`width` / `height`	ไม่	โดยทั่วไปไม่จำเป็น	สำหรับกรณีส่วนใหญ่ ใช้เพียง `aspect_ratio` ก็เพียงพอ ส่งพารามิเตอร์เหล่านี้เฉพาะเมื่อต้องการกำหนดความกว้างและความสูงอย่างแม่นยำ

หาก response มี URL ของภาพ ควรบันทึกภาพทันที ลิงก์ภาพเหมาะสำหรับการดูตัวอย่างและดาวน์โหลดชั่วคราว ไม่ควรใช้เป็น URL ถาวรของไฟล์สื่อ

4. ทำไมจึงควรใช้ LLM API Gateway 🍬

การเชื่อมต่อแบบทั่วไปมักต้องสลับไปมาระหว่างแพลตฟอร์มโมเดลหลายแห่ง ซึ่งแต่ละแห่งใช้ API Key, Endpoint และวิธีคิดค่าบริการต่างกัน ทำให้การพัฒนาและบำรุงรักษาซับซ้อนขึ้น

LLM API Gateway รวมทุกอย่างเหล่านี้ไว้ให้แล้ว คุณใช้เพียง API Key เดียวของ LLM API Gateway ก็เรียกใช้การสร้างภาพผ่าน Endpoint เดียวได้ ส่วนปริมาณการใช้งาน ตัวคูณ และยอดคงเหลือจะแสดงในคอนโซลของ LLM API Gateway ช่วยให้ตรวจสอบและจัดการจากส่วนกลางได้อย่างชัดเจน

ความสามารถ	รายละเอียด
Endpoint เดียว	คำขอสร้างภาพทั้งหมดใช้ `https://api.llm-token.cn/v1/images/generations` ทำให้เชื่อมต่อได้ง่ายขึ้น
API Key เดียว	ใช้ `new-api-token` ที่สร้างจากคอนโซลของ LLM API Gateway โดยไม่ต้องสลับระหว่างหลายแพลตฟอร์ม
การคิดค่าบริการแบบรวมศูนย์	ปริมาณการใช้งาน ตัวคูณ และยอดคงเหลืออ้างอิงจากข้อมูลในคอนโซลของ LLM API Gateway ช่วยให้ทีมบริหารต้นทุนได้ง่ายขึ้น
เหมาะสำหรับเชื่อมต่อกับระบบธุรกิจ	รองรับการสร้างภาพประกอบสำหรับ WeChat Official Account ภาพสินค้า ภาพหน้าปก ภาพประกอบอัตโนมัติสำหรับ Agent การสร้างไฟล์สื่อจำนวนมาก และการใช้งานอื่น ๆ

สรุปสั้น ๆ: ใช้ API Key ของ LLM API Gateway เพียงชุดเดียวและ Endpoint เดียว ก็เพิ่มความสามารถในการสร้างภาพให้ผลิตภัณฑ์หรือเวิร์กโฟลว์ของคุณได้

5. วิธีใช้ image-01-live ⚡

image-01-live ใช้ Endpoint สำหรับสร้างภาพเดียวกัน พารามิเตอร์อื่นคงเดิม เพียงเปลี่ยน model เป็น image-01-live

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

หากบัญชีของคุณเปิดใช้โมเดลนี้แล้ว ก็เรียกใช้งานด้วยวิธีนี้ได้ทันที

6. ตัวอย่าง Python สำหรับนำไปใช้ในโปรเจกต์ 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

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

7. เขียน prompt อย่างไรให้ได้ภาพที่ดีขึ้น 🪄

เพื่อให้ได้ผลลัพธ์ที่สม่ำเสมอยิ่งขึ้น ลองอธิบายภาพตามลำดับนี้:

วัตถุหลัก: สิ่งที่ต้องการให้ปรากฏในภาพ เช่น “หุ่นยนต์ AI สีฟ้า” หรือ “โปสเตอร์วิเคราะห์ฟุตบอลโลก”
ฉาก: สถานที่หรือพื้นหลังของวัตถุ เช่น “พื้นหลังสีขาว” “ใต้แสงไฟสนามกีฬา” หรือ “บนโต๊ะทำงานในสำนักงาน”
สไตล์: มินิมอล สมจริง 3D ภาพวาด โปสเตอร์เชิงพาณิชย์ สไตล์ภาพถ่าย และอื่น ๆ
องค์ประกอบภาพ: จัดวางกึ่งกลาง มุมมองจากด้านบน ครึ่งตัว มีพื้นที่ว่าง หรือภาพหน้าปกแนวนอน
สี: สีหลักและสีรอง เช่น ฟ้ากับขาว ดำกับทอง หรือแดงกับฟ้าที่ตัดกัน
ข้อจำกัด: เช่น “ไม่มีข้อความ” “ไม่มีลายน้ำ” หรือ “พื้นหลังสะอาด”

คุณสามารถนำแม่แบบสั้น ๆ นี้ไปใช้ได้ทันที:

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

ตัวอย่าง:

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

8. วิธีแก้ปัญหาเบื้องต้น 🛟

อาการ	วิธีแก้ไข
การยืนยันตัวตนล้มเหลว	ตรวจสอบว่าเขียน header ของคำขอเป็น `Authorization: Bearer YOUR_NEW_API_TOKEN` และไม่มีช่องว่างส่วนเกินติดมากับ token
ไม่พบโมเดล	ตรวจสอบว่าชื่อโมเดลเป็น `image-01` หรือ `image-01-live` อย่างถูกต้องทุกตัวอักษร รวมถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
อัตราส่วนภาพไม่ตรงตามที่คาดไว้	ปรับ `aspect_ratio` ก่อน โดยใช้ `16:9` สำหรับภาพหน้าปก WeChat Official Account ทั่วไป หรือ `1:1` สำหรับรูปโปรไฟล์หรือไอคอน
เปิดลิงก์ภาพไม่ได้	URL ของภาพอาจหมดอายุแล้ว ควรดาวน์โหลดภาพทันทีหลังสร้างเสร็จ หรือบันทึกไว้ในคลังไฟล์สื่อของคุณ
คำขอใช้เวลานาน	การสร้างภาพต้องใช้เวลาประมวลผล แนะนำให้ตั้งค่า timeout ของคำขอเป็นอย่างน้อย 120 วินาที
ผลลัพธ์ไม่สม่ำเสมอ	ระบุความต้องการให้ชัดเจนขึ้นและตัดคำอธิบายที่ขัดแย้งกันออก หากต้องการผลลัพธ์ใกล้เคียงกัน ให้กำหนด `seed` เป็นค่าคงที่

9. เวอร์ชันสำหรับส่งให้ทีมพัฒนาได้ทันที 📮

เราใช้ LLM API Gateway เพื่อสร้างภาพผ่าน POST https://api.llm-token.cn/v1/images/generations โดยตั้งค่า header ของคำขอเป็น Authorization: Bearer YOUR_NEW_API_TOKEN จากนั้นกำหนด model: image-01 หรือ model: image-01-live ใน request body พร้อมส่งพารามิเตอร์ เช่น prompt, response_format: url, n และ aspect_ratio

10. เหมาะกับการใช้งานประเภทใดบ้าง 📚

กรณีใช้งาน	วิธีนำไปใช้
ภาพประกอบสำหรับ WeChat Official Account / Xiaohongshu	สร้างภาพหน้าปก ภาพหลัก โปสเตอร์กิจกรรม และภาพประกอบบทความได้อย่างรวดเร็ว
หน้าผลิตภัณฑ์และ SaaS	สร้างไอคอนแอป ภาพประกอบฟีเจอร์ Banner และภาพประกอบสำหรับสถานะว่าง
ไฟล์สื่อสำหรับอีคอมเมิร์ซและสินค้า	สร้างภาพพื้นหลังสินค้า ภาพโปรโมชัน และภาพบรรยากาศสำหรับหน้ารายละเอียดสินค้า
เวิร์กโฟลว์อัตโนมัติของ Agent	ให้ Agent สร้างภาพประกอบที่เกี่ยวข้องกับเนื้อหาโดยอัตโนมัติ เพื่อเพิ่มประสิทธิภาพการผลิตคอนเทนต์

Your privacy choices

คู่มือสร้างภาพด้วย LLM API Gateway