เอกสาร API ข้อมูลอ้างอิง SDK ข้อมูลอ้างอิง การใช้งาน Agent AI ทักษะ

รูปภาพ

สร้างรูปภาพ

สร้างรูปภาพจากพรอมต์ข้อความ ค่าเริ่มต้นคืนค่า JSON ซิงโครนัสที่เข้ากันได้กับ OpenAI (ใช้กับ client.images.generate() ได้); ส่ง stream: true เพื่อรับสตรีมเหตุการณ์ SSE แทน รองรับ image-to-image ผ่าน inputImages / input_references

POST/api/v1/images/generations

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

Body

modelจำเป็น

string

โมเดลสร้างภาพที่จะใช้ ในรูปแบบมีคำนำหน้าผู้ให้บริการ เช่น "openai/gpt-image-2"

minLength: 1

Example: "openai/gpt-image-2"

promptจำเป็น

string

คำอธิบายข้อความของภาพที่ต้องการ

minLength: 1

Example: "a red cat on a sofa"

n

integer

จำนวนภาพที่จะสร้าง 1–10

1–10

Example: 1

size

string

ขนาดภาพ — พิกเซลชัดเจน ("2048x2048") หรือระดับ ("2K", "4K") ส่งต่อไปยังผู้ให้บริการตามเดิม ขนาดที่รองรับแตกต่างกันตามโมเดล

Example: "1024x1024"

stream

boolean

เลือกรูปแบบการตอบกลับ: ละไว้หรือ false = JSON ซิงโครนัสเข้ากันได้กับ OpenAI (ค่าเริ่มต้น), true = สตรีมเหตุการณ์ SSE

input_references

string[]

ภาพต้นฉบับสำหรับ image-to-image (URL แบบ data: หรือ https:) สูงสุด 8 ภาพ เป็นชื่อแทนของ inputImages (เข้ากันได้กับชื่อฟิลด์ที่ใช้กันทั่วไปในอุตสาหกรรม) ทั้งคู่ผ่านการตรวจสอบเนื้อหาก่อน คืนค่า 400 — ไม่ใช่ warning — เมื่อเส้นทางโมเดลไม่รองรับ i2i

≤ 8 images

aspect_ratio

enum<string>

อัตราส่วนภาพของรูปที่สร้าง รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

ระดับความละเอียด พิกเซลจริงคำนวณตามผู้ให้บริการ รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

5121K2K4K

Example: "2K"

quality

enum<string>

คุณภาพการเรนเดอร์ รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

autolowmediumhigh

background

enum<string>

การจัดการพื้นหลัง transparent ต้องใช้ output_format ที่รองรับ alpha (png/webp) รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

autotransparentopaque

output_format

enum<string>

การเข้ารหัสของไบต์ภาพที่คืนค่า รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

pngjpegwebpsvg

Example: "png"

output_compression

integer

ระดับการบีบอัด (0–100) สำหรับเอาต์พุต webp/jpeg; png จะละเว้น รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

0–100

Example: 100

seed

integer

seed สุ่มแบบกำหนดได้ seed + พารามิเตอร์เดิมควรได้ผลเดิม แต่ไม่ใช่ทุกผู้ให้บริการที่รับประกัน รองรับโดยตรงบนบางเส้นทางโมเดล — ตรวจสอบพารามิเตอร์ที่แต่ละโมเดลรองรับได้ที่ supported_parameters ในการตอบกลับของ GET /api/v1/images/models; เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้และบันทึกไว้ใน warnings[] ของการตอบกลับ (คำขอยังสำเร็จ)

คู่มือเชิงลึก →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

ตัวอย่างการตอบกลับ

สำเร็จ ค่าเริ่มต้น (หรือ stream: false) คืนค่า JSON ซิงโครนัสด้านล่าง เมื่อ stream: true คืนค่าสตรีมเหตุการณ์ SSE (ดูโปรโตคอลในคู่มือเชิงลึก) พารามิเตอร์ที่เส้นทางละเว้นจะปรากฏใน warnings[] ระดับบนสุด (เพื่อแจ้งข้อมูลเท่านั้น)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}