ใช้ Midjourney ผ่าน Rivya Public API v1 ด้วย model id midjourney, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ

พร้อมใช้งานผ่าน APIข้อความหรือ URL พร้อม; โหมดอ้างอิงใช้ Files APIรูปภาพ

ID โมเดล API

midjourney

อินพุต

text, file

Files API

จำเป็นสำหรับโหมดอ้างอิง

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

ความสามารถ

รูปภาพ

การชำระเงิน

FIXED

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

2000 อักขระ

สัญญาของคำขอ

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

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
model	string	ใช่	midjourney	ใช้ API model id midjourney
prompt	string	ใช่	-	สูงสุด 2000 อักขระสำหรับโมเดลนี้
params	object	ไม่ใช่	-	object พารามิเตอร์เฉพาะโมเดล ใช้แถวด้านล่างสำหรับ key ที่อนุญาต
client_request_id	string	ไม่ใช่	-	ID ฝั่งไคลเอนต์แบบเลือกได้สำหรับติดตามคำขอในระบบของคุณ

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

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
speed	select	ไม่ใช่	relaxed	-	relaxed, fast, turbo	โหมดความเร็ว
aspectRatio	select	ไม่ใช่	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3	อัตราส่วนภาพ
version	select	ไม่ใช่	7	-	7, 6.1, 6, niji7, niji6	เวอร์ชัน

นโยบายการอัปโหลด

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

กฎอ้างอิง

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

ไฟล์สูงสุด

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

image

Duration token

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

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

คำขอขั้นต่ำ

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7"
  }
}

คำขอแบบไฟล์อ้างอิง

{
  "model": "midjourney",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "speed": "relaxed",
    "aspectRatio": "1:1",
    "version": "7",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

คำตอบจากการสร้าง

endpoint create ส่ง ID งานสาธารณะกลับมา ให้ตรวจ endpoint สถานะซ้ำจนกว่างานจะสำเร็จหรือล้มเหลว

{
  "id": "task_midjourney_example",
  "status": "queued",
  "model": "midjourney",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

ข้อผิดพลาดทั่วไป

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

การเชื่อมต่อ API ของ Midjourney