ใช้ Ideogram V3 Remix ผ่าน Rivya Public API v1 ด้วยรหัสโมเดล ideogram-v3-remix, อินพุตที่รองรับ, พารามิเตอร์, กฎ Files API, เครดิต และตัวอย่างคำตอบ

พร้อมใช้งานผ่าน APIความพร้อมรูปภาพ

ID โมเดล API

ideogram-v3-remix

อินพุต

file

Files API

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

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

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

ความสามารถ

รูปภาพ

การชำระเงิน

FIXED

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

5000 อักขระ

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

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

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

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

คีย์	ประเภท	จำเป็น	ค่าเริ่มต้น	ช่วง	ตัวเลือก	คำอธิบาย
rendering_speed	select	ไม่ใช่	BALANCED	-	TURBO, BALANCED, QUALITY	ปรับสมดุลระหว่างความเร็ว ต้นทุน และรายละเอียด Turbo เร็วและถูกที่สุด, Quality ละเอียดที่สุดและแพงที่สุด, ส่วน Balanced เป็นค่ากลางเริ่มต้น
style	select	ไม่ใช่	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN	สไตล์
expand_prompt	select	ไม่ใช่	true	-	true, false	สวิตช์ขยายพรอมป์ของ Ideogram เมื่อเปิดไว้จะช่วยให้โมเดลเติมรายละเอียดคำบรรยาย ส่วนการปิดเหมาะกว่าเมื่อต้องการควบคุมพรอมป์อย่างเคร่งครัด
image_size	select	ไม่ใช่	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	ขนาดภาพ
num_images	select	ไม่ใช่	1	-	1, 2, 3, 4	เลือกผลลัพธ์ 1–4 ภาพ ยอดรวมคือราคาต่อภาพคูณจำนวนที่เลือก แล้วปัดขึ้นเป็นเครดิตเต็มจำนวน
seed	number	ไม่ใช่	-	-	-	เว้นว่างไว้เพื่อสร้างผลลัพธ์แบบสุ่มใหม่ทุกครั้ง การใช้เลขจำนวนเต็มเดิมซ้ำจะช่วยให้ทำซ้ำหรือปรับละเอียดจากผลลัพธ์ก่อนหน้าได้ง่ายขึ้น ผลลัพธ์จะใกล้เคียงขึ้นเมื่อพรอมป์และการตั้งค่าหลักอื่นยังคล้ายเดิมเท่านั้น และไม่รับประกันว่าจะตรงกันแบบ 1:1
strength	number	ไม่ใช่	0.8	min 0.01 / max 1	-	ควบคุมว่าภาพต้นทางกำหนดผลลัพธ์แรงแค่ไหน ค่าสูงจะอยู่ใกล้โครงสร้างเดิมมากขึ้น ส่วนค่าต่ำเปิดให้เบี่ยงเบนได้มากขึ้น
negative_prompt	text	ไม่ใช่	-	-	-	พรอมป์เชิงลบ

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

อัปโหลดไฟล์อ้างอิงก่อน จากนั้นใส่ URL และโทเค็นระยะเวลาที่ได้กลับมาไว้ใน `params.referenceMediaItems`

กฎอ้างอิง

รูปอ้างอิง: อัปโหลดไฟล์รูปภาพให้ตรง 1 ไฟล์สำหรับงานนี้

ไฟล์สูงสุด

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

image

โทเค็นระยะเวลา

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

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

คำขอขั้นต่ำ

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "สิ่งที่ต้องการหลีกเลี่ยงแบบไม่บังคับ"
  }
}

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

{
  "model": "ideogram-v3-remix",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "num_images": "1",
    "seed": 1,
    "strength": 0.8,
    "negative_prompt": "สิ่งที่ต้องการหลีกเลี่ยงแบบไม่บังคับ",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_ideogram_v3_remix_example",
  "status": "queued",
  "model": "ideogram-v3-remix",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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 ของ Ideogram V3 Remix