ใช้ Flux Kontext Pro ผ่าน Rivya Public API v1 ด้วย model id flux-kontext-pro, input ที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่าง response

พร้อมใช้งานผ่าน APIText หรือ URL พร้อม; โหมด reference ใช้ Files APIรูปภาพ

ID โมเดล API

flux-kontext-pro

Input

text, file

Files API

จำเป็นสำหรับโหมด reference

เครดิตพื้นฐาน

ความสามารถ

รูปภาพ

Billing

FIXED

ขีดจำกัดพรอมต์

ยังไม่มีขีดจำกัดพรอมต์ในเอกสาร

contract ของ request

ส่ง model id ที่ระดับบนสุด control เฉพาะโมเดลอยู่ใน params

Key	Type	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	flux-kontext-pro	ใช้ API model id flux-kontext-pro
prompt	string	ใช่	-	ข้อความพรอมต์สำหรับโมเดลที่รองรับ input แบบข้อความ
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	client-side id แบบเลือกได้สำหรับ trace คำขอในระบบของคุณ

พารามิเตอร์โมเดล

Key	Type	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
aspectRatio	select	ไม่ใช่	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	อัตราส่วนภาพ
outputFormat	select	ไม่ใช่	jpeg	-	jpeg, png	JPEG มีขนาดเล็กกว่า ส่วน PNG เหมาะกับความโปร่งใสหรือขอบแบบไม่สูญเสียรายละเอียดที่สะอาดกว่า
enableTranslation	select	ไม่ใช่	true	-	true, false	แปลพรอมป์อัตโนมัติ
promptUpsampling	select	ไม่ใช่	false	-	false, true	เมื่อเปิดใช้ Rivya จะให้โมเดลขยายและขัดเกลาพรอมป์ของคุณก่อนสร้างภาพ มักช่วยให้รายละเอียดดีขึ้น แต่อาจทำให้ผลลัพธ์ตีความมากกว่าพรอมป์ดิบของคุณ
safetyTolerance	number	ไม่ใช่	2	min 0 / max 6	-	ควบคุมความเข้มงวดของการกลั่นกรองเนื้อหา โดยปกติการสร้างภาพจะยอมรับช่วงกว้างกว่าการแก้ไขภาพ; ค่าต่ำเข้มงวดกว่า และค่าสูงผ่อนปรนกว่า
watermark	text	ไม่ใช่	-	-	-	ลายน้ำ

policy การอัปโหลด

อัปโหลดไฟล์ reference ก่อน จากนั้นใส่ URL และ duration token ที่ได้กลับมาไว้ใน params.referenceMediaItems

กฎ reference

ภาพอ้างอิง: อัปโหลดไฟล์ภาพได้สูงสุด 1 ไฟล์สำหรับโปรเจกต์แก้ไขภาพ

ไฟล์สูงสุด

ชนิดไฟล์ที่รับ

image

Duration token

reference วิดีโอและเสียงควรมี durationToken จาก /api/v1/files เมื่อจำเป็นต้องตรวจ duration

kind	ขนาดสูงสุด	MIME type
image	10 MB	image/jpeg, image/png, image/webp

request ขั้นต่ำ

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "ข้อความลายน้ำแบบไม่บังคับ"
  }
}

request แบบไฟล์ reference

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "ข้อความลายน้ำแบบไม่บังคับ",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

response จากการสร้าง

endpoint create ส่ง public task id กลับมา poll endpoint สถานะจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_flux_kontext_pro_example",
  "status": "queued",
  "model": "flux-kontext-pro",
  "reserved_credits": 4,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

error ทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

บางโหมดต้องใช้การอัปโหลด reference ผ่าน Files API

การเชื่อมต่อ API ของ Flux Kontext Pro