Dùng Seedream 5.0 Pro qua Rivya Public API v1 với ID mô hình seedream-5-pro, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIVăn bản hoặc URL đã sẵn sàng; chế độ tham chiếu dùng Files APIHình ảnh

ID mô hình API

seedream-5-pro

Đầu vào

text, file

Files API

Bắt buộc cho chế độ tham chiếu

Tín dụng cơ bản

per_image_plus_reference_image · basic=7 · high=14 · additional_input_image=0.5 · ⌈total⌉

Năng lực

Hình ảnh

Thanh toán

FIXED

Giới hạn prompt

5000 ký tự

Quy ước yêu cầu

Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	seedream-5-pro	Dùng seedream-5-pro làm ID mô hình API.
prompt	string	Có	-	Tối đa 5000 ký tự cho mô hình này.
params	object	Không	-	Đối tượng 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	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Key	Loại	Bắt buộc	Mặc định	Phạm vi	Tùy chọn	Mô tả
aspect_ratio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	Tỷ lệ khung hình
quality	select	Không	basic	-	basic, high	Chất lượng
output_format	select	Không	png	-	png, jpeg	Định dạng đầu ra
nsfw_checker	select	Không	false	-	false, true	Bật bộ lọc nội dung tùy chọn của mô hình. Không bộ lọc tự động nào có thể bảo đảm bao quát hoàn toàn.

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

Trước tiên tải tệp tham chiếu lên, 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 10 ảnh JPEG, PNG hoặc WebP, mỗi ảnh không quá 10 MB.

Số tệp tối đa

Loại tệp đượ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 thời lượng.

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

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

{
  "model": "seedream-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false"
  }
}

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

{
  "model": "seedream-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Phản hồi tạo

Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.

{
  "id": "task_seedream_5_pro_example",
  "status": "queued",
  "model": "seedream-5-pro",
  "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
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Một số chế độ cần tải tệp tham chiếu qua Files API.

Tích hợp API Seedream 5.0 Pro