Dùng Seedream 4.0 qua Rivya Public API v1 với model id seedream-4-0, 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

seedream-4-0

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

5000 ký tự

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ó	seedream-4-0	Dùng API model id seedream-4-0.
prompt	string	Có	-	Tối đa 5000 ký tự cho mô hình này.
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ả
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_3_2, portrait_16_9, landscape_4_3, landscape_3_2, landscape_16_9, landscape_21_9	Điều khiển tỷ lệ khung. Cùng với độ phân giải đầu ra, nó quyết định kích thước pixel cuối cùng.
image_resolution	select	Không	1K	-	1K, 2K, 4K	Các tầng hiện tại là `1K`, `2K` và `4K`. Độ phân giải cao hơn thường đồng nghĩa với tệp lớn hơn và thời gian chờ lâu hơn.
max_images	number	Không	1	min 1 / max 6 / step 1	-	Giá trị hợp lệ từ 1 đến 6. Điều này kiểm soát một tác vụ có thể trả về bao nhiêu hình ảnh, vì vậy tốt nhất là giữ prompt khớp với số lượng đó.
seed	number	Không	-	min 0 / max 2147483647 / step 1	-	Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1.
nsfw_checker	select	Không	false	-	false, true	Điều khiển bộ lọc nội dung. Tắt đi sẽ đưa bạn gần hơn với đầu ra thô, nhưng cũng đồng nghĩa với việc chấp nhận lớp an toàn yếu hơn.

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 10 ảnh cho đường dẫn chỉnh sửa Seedream 4.0.

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": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false"
  }
}

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

{
  "model": "seedream-4-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "image_resolution": "1K",
    "max_images": 1,
    "seed": 0,
    "nsfw_checker": "false",
    "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_seedream_4_0_example",
  "status": "queued",
  "model": "seedream-4-0",
  "reserved_credits": 6,
  "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 Seedream 4.0