Dùng Flux Kontext Pro qua Rivya Public API v1 với model id flux-kontext-pro, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.

Khả dụng qua APIText hoặc URL sẵn sàng; reference modes dùng Files APIHình ảnh

ID mô hình API

flux-kontext-pro

Input

text, file

Files API

Bắt buộc cho reference modes

Tín dụng cơ bản

Năng lực

Hình ảnh

Thanh toán

FIXED

Giới hạn prompt

Không có giới hạn prompt được ghi

Hợp đồng yêu cầu

Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.

Key	Type	Bắt buộc	Default	Mô tả
model	string	Có	flux-kontext-pro	Dùng API model id flux-kontext-pro.
prompt	string	Có	-	Prompt text cho mô hình hỗ trợ text input.
params	object	Không	-	Object tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép.
client_request_id	string	Không	-	Client-side id tùy chọn để trace request trong hệ thống của bạn.

Tham số mô hình

Key	Type	Bắt buộc	Default	Range	Options	Mô tả
aspectRatio	select	Không	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Tỷ lệ khung hình
outputFormat	select	Không	jpeg	-	jpeg, png	JPEG có dung lượng nhỏ hơn, còn PNG phù hợp hơn cho độ trong suốt hoặc viền lossless sạch hơn.
enableTranslation	select	Không	true	-	true, false	Tự động dịch prompt
promptUpsampling	select	Không	false	-	false, true	Khi bật, Rivya để mô hình mở rộng và làm mượt prompt của bạn trước khi tạo. Điều này thường giúp chất lượng chi tiết tốt hơn, nhưng cũng có thể khiến kết quả diễn giải nhiều hơn prompt gốc.
safetyTolerance	number	Không	2	min 0 / max 6	-	Kiểm soát độ nghiêm ngặt của kiểm duyệt nội dung. Tạo ảnh thường cho phép phạm vi rộng hơn chỉnh sửa; giá trị thấp nghiêm ngặt hơn và giá trị cao thoáng hơn.
watermark	text	Không	-	-	-	Dấu mờ

Chính sách tải lên

Upload reference files trước, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp ảnh cho dự án chỉnh sửa ảnh.

Số file tối đa

Loại file được chấp nhận

image

Token thời lượng

Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh duration.

kind	Kích thước tối đa	MIME types
image	10 MB	image/jpeg, image/png, image/webp

Yêu cầu tối thiểu

{
  "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": "Văn bản dấu mờ tùy chọn"
  }
}

Yêu cầu có tệp tham chiếu

{
  "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": "Văn bản dấu mờ tùy chọn",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Phản hồi tạo

Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.

{
  "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
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Một số mode cần Files API reference uploads.

Tích hợp API Flux Kontext Pro