Tra cứu model ID của Rivya API, khả dụng, mode được hỗ trợ, bảng tham số, giới hạn prompt, quy tắc media tham chiếu và liên kết chi tiết mô hình.

Trang này là tham chiếu API cấp mô hình cho Rivya API v1.

Bảng bên dưới được tạo từ cùng catalog mô hình và public serializer mà /api/v1/models sử dụng. Đây không phải số lượng mô hình cố định viết thủ công.

Cách đọc tham chiếu này

Dùng id của mô hình làm model trong POST /api/v1/generations cho các mô hình hình ảnh, video và âm thanh bất đồng bộ.
Dùng ID mô hình chat trong POST /api/v1/chat/completions.
Dùng prompt cấp cao nhất cho văn bản prompt của generation.
Dùng message cấp cao nhất cho lượt Chat API.
Đặt các trường riêng theo mô hình bất đồng bộ bên trong params.
Đọc api_input_status trước khi xây dựng tích hợp. available_text và available_url_input có thể kiểm thử mà không cần tải tệp lên; partial_requires_files nghĩa là chỉ một số mode cần Files API; requires_files_api nghĩa là cần tải media tham chiếu qua Files API trước khi gọi mô hình.
Với mô hình chat, đọc chat_capabilities để biết hỗ trợ không streaming, SSE streaming, ảnh đính kèm bằng file_id, web search, thoughts và reasoning effort.
Trang chi tiết mô hình cung cấp hướng dẫn và ví dụ ở cấp sản phẩm.

Dùng reference này với debugger

Bắt đầu từ quickstart, xác nhận model fields ở đây, rồi chạy mock hoặc live request đã đăng nhập trong Developers debugger.

Hướng dẫn nhanh API Trình debug trực tuyến

Z-Image

z-imageKhả dụng qua APIText input sẵn sàng

Hình ảnh · Mô hình text-to-image nhẹ của Alibaba. Tạo nhanh một ảnh với 5 tỷ lệ khung hình, lý tưởng cho bản nháp ý tưởng nhanh và hình ảnh mạng xã hội chỉ với 1 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

1000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2Khả dụng qua APIMột phần: cần Files API

Image · Mô hình hình ảnh thế hệ mới của Google với độ phân giải 4K, 15 tỷ lệ khung hình (bao gồm 8:1 cực rộng), grounding bằng Google Search và tối đa 14 ảnh tham chiếu - trình tạo ảnh linh hoạt nhất trên Rivya.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

image · 14 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "nano-banana-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto",
    "resolution": "1K",
    "output_format": "jpg",
    "google_search": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 14 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9, 4:1, 1:4, 8:1, 1:8
resolution	select	Không	1K	-	1K, 2K, 4K
output_format	select	Không	jpg	-	jpg, png
google_search	select	Không	false	-	false, true

Nano Banana Pro

nano-banana-proKhả dụng qua APIMột phần: cần Files API

Image · Mô hình ảnh cao cấp của Google với đầu ra 4K, 11 tỷ lệ khung hình và tối đa 8 ảnh tham chiếu. Được tối ưu cho hình ảnh thương hiệu và chiến dịch có độ trung thực cao, với chi tiết và độ chính xác màu tốt hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 8 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "nano-banana-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 8 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto
resolution	select	Không	1K	-	1K, 2K, 4K
output_format	select	Không	png	-	png, jpg

Nano Banana

nano-bananaKhả dụng qua APIMột phần: cần Files API

Image · Mô hình ảnh linh hoạt của Google cho text-to-image và image-to-image với 11 tỷ lệ khung hình, tối đa 10 ảnh tham chiếu và đầu ra PNG/JPEG. Phù hợp tốt với chân dung, bố cục sản phẩm và visual landing page khổ rộng hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 10 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "nano-banana",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "imageSize": "1:1",
    "output_format": "png"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 10 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
imageSize	select	Không	1:1	-	1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto
output_format	select	Không	png	-	png, jpeg

GPT Image 2

gpt-image-2Khả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình GPT Image mới hơn của OpenAI trên Rivya, với text-to-image, image-to-image, tối đa 16 hình ảnh tham chiếu và các tầng credit 1K / 2K / 4K rõ ràng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

image · 16 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-image-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}

Quy tắc tham chiếu

Hình ảnh tham chiếu: Tải lên tối đa 16 hình ảnh tham chiếu cho nhiệm vụ image-to-image của GPT Image 2.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	Không	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5Khả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh của OpenAI với hai tầng chất lượng Trung bình/Cao và tối đa 16 hình ảnh tham chiếu. Mô hình nổi bật ở khả năng bám theo chỉ dẫn phức tạp và dựng cảnh mạch lạc với quan hệ không gian chính xác.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

Media tham chiếu

image · 16 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-image-1-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "quality": "medium",
    "aspect_ratio": "1:1"
  }
}

Quy tắc tham chiếu

Hình ảnh tham chiếu: Tải lên tối đa 16 tệp hình ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
quality	select	Không	medium	-	medium, high
aspect_ratio	select	Không	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageKhả dụng qua APIText input sẵn sàng

Hình ảnh · Mô hình 4o Image của OpenAI hiện có trên Rivya như một đường dẫn text-to-image chuyên biệt. Thiết lập trang hiện được giữ chủ ý gọn: prompt cộng 3 tỷ lệ khung hình được hỗ trợ với mức cố định 3 credit cho mỗi ảnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "4o-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "1:1"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
size	select	Không	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh Seedream nhẹ hơn của ByteDance với mức giá chung cho text-to-image và chỉnh sửa hình ảnh. Mô hình này hỗ trợ 8 tỷ lệ khung hình, tối đa 14 ảnh tham chiếu và hiện có giá 6 credit mỗi lượt chạy.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

3000 ký tự

Media tham chiếu

image · 14 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 14 tệp hình ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Không	basic	-	basic, high

Seedream 4.5

seedream-4-5Khả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh cao cấp của ByteDance với các tầng chất lượng 2K/4K, 8 tỷ lệ khung hình và tối đa 14 ảnh tham chiếu. Nổi bật nhờ color grading điện ảnh và chi tiết texture phong phú trong hình ảnh thời trang và lifestyle.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

3000 ký tự

Media tham chiếu

image · 14 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedream-4-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 14 tệp hình ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	Không	basic	-	basic, high

Seedream 4.0

seedream-4-0Khả dụng qua APIMột phần: cần Files API

Hình ảnh · Seedream 4.0 là mô hình hình ảnh ByteDance cân bằng trên Rivya cho tạo text-to-image, chỉnh sửa bằng ảnh tham chiếu và các điều khiển đầu ra rõ ràng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 10 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

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

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.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
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
image_resolution	select	Không	1K	-	1K, 2K, 4K
max_images	number	Không	1	min 1 / max 6 / step 1	-
seed	number	Không	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	Không	false	-	false, true

Seedream 3.0

seedream-3-0Khả dụng qua APIText input sẵn sàng

Hình ảnh · Seedream 3.0 hiện trở lại trên Rivya như một mô hình hình ảnh dòng cũ độc lập. Mô hình này hiện chỉ giữ đường dẫn text-to-image công khai và có giá 5 credit mỗi lượt chạy.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedream-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "seed": 0
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	Không	2.5	min 1 / max 10 / step 0.1	-
seed	number	Không	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh của xAI với khả năng diễn giải sáng tạo mạnh và 5 tỷ lệ khung hình. Tạo một hình ảnh, tập trung vào biểu đạt nghệ thuật và phong cách thị giác phi quy ước.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

Quy tắc tham chiếu

Hình ảnh tham chiếu: Tải lên tối đa 1 tệp hình ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	Không	false	-	false, true

Flux 2 Pro

flux-2-proKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình chủ lực 32B tham số của Black Forest Labs. Hỗ trợ tạo ảnh từ văn bản và tạo ảnh từ ảnh với tối đa 8 ảnh tham chiếu, độ phân giải 2K và khả năng render chữ chính xác — được xây dựng cho ảnh sản phẩm và hình ảnh thương hiệu.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 8 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "flux-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 8 tệp ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Không	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Biến thể tập trung vào chỉnh sửa của dòng Flux 2. Mô hình chuyên xử lý điều chỉnh cấu trúc và chuyển phong cách với tối đa 8 ảnh tham chiếu cùng độ phân giải 2K — lý tưởng để lặp lại và tinh chỉnh hình ảnh sẵn có.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 8 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "flux-2-flex",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "resolution": "1K"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 8 tệp ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	Không	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình Flux Kontext nâng cao của Black Forest Labs cho các tác vụ tạo ảnh và chỉnh sửa ảnh theo prompt đòi hỏi cao hơn. Rivya hiện giữ cả tạo ảnh từ văn bản và tạo ảnh từ ảnh trong cùng dự án async, đồng thời định giá cố định 8 credit cho mỗi lượt chạy theo chính sách hiện tại của nền tảng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "flux-kontext-max",
  "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"
  }
}

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.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Không	jpeg	-	jpeg, png
enableTranslation	select	Không	true	-	true, false
promptUpsampling	select	Không	false	-	false, true
safetyTolerance	number	Không	2	min 0 / max 6	-
watermark	text	Không	-	-	-

Flux Kontext Pro

flux-kontext-proKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Dự án Flux Kontext chi phí thấp hơn của Black Forest Labs cho tạo ảnh từ văn bản và chỉnh sửa một ảnh. Rivya hiện mở cả tạo ảnh từ văn bản và tạo ảnh từ ảnh trên cùng dự án ảnh async, với định giá cố định 4 credit cho cả hai chế độ theo chính sách giá hiện tại của nền tảng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

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

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.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	Không	jpeg	-	jpeg, png
enableTranslation	select	Không	true	-	true, false
promptUpsampling	select	Không	false	-	false, true
safetyTolerance	number	Không	2	min 0 / max 6	-
watermark	text	Không	-	-	-

Qwen2 Image

qwen2-imageKhả dụng qua APIMột phần: cần Files API

Image · Mô hình hình ảnh Qwen2 của Alibaba hiện được tích hợp trên Rivya như một dự án ảnh giá cố định. Nó bao phủ an toàn text-to-image và image-to-image với tập con tỷ lệ khung hình chung mà cả hai tài liệu công khai đều nêu, cùng đầu ra PNG/JPEG, tái sử dụng seed và một công tắc NSFW đơn giản.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

800 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "qwen2-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "16:9",
    "output_format": "png",
    "seed": 0,
    "nsfw_checker": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
image_size	select	Không	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	Không	png	-	png, jpeg
seed	number	Không	-	min 0	-
nsfw_checker	select	Không	false	-	false, true

Qwen Image

qwen-imageKhả dụng qua APIMột phần: cần Files API

Image · Mô hình hình ảnh thuộc gia đình Alibaba Qwen với preset HD (Square, Portrait, Landscape) và đầu ra PNG/JPEG. Mạnh với prompt tiếng Trung và tạo hình ảnh có sắc thái văn hóa.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "qwen-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "image_size": "square_hd",
    "output_format": "png"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	Không	png	-	png, jpeg

Midjourney

midjourneyKhả dụng qua APIMột phần: cần Files API

Image · Mô hình ảnh V7 của Midjourney cho text-to-image và image-to-image, với các chế độ anime Niji, 3 bậc tốc độ (Relaxed/Fast/Turbo), tham chiếu phong cách và tính nhất quán do Omni Reference dẫn dắt. Vẫn là chuẩn mực cho art điện ảnh, minh họa và moodboard.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

2000 ký tự

Media tham chiếu

image · 4 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

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

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 4 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
speed	select	Không	relaxed	-	relaxed, fast, turbo
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	Không	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundKhả dụng qua APICần Files API

Image · Mô hình xóa nền của Recraft trên Rivya để tách chủ thể khỏi một ảnh hiện có. Dùng khi bước tiếp theo cần asset trong suốt, cutout sạch hoặc ảnh nguồn không còn nền gốc.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh nguồn: Upload đúng 1 ảnh. Viền chủ thể càng sạch thường tạo cutout càng sạch.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

Không cần tham số mô hình bổ sung.

Recraft Crisp Upscale

recraft-crisp-upscaleKhả dụng qua APICần Files API

Image · Mô hình upscale ảnh nhẹ của Recraft trên Rivya để tăng độ sắc nét và độ rõ với chi phí thấp cho một ảnh tĩnh đã duyệt. Dùng khi ảnh đã chọn chỉ cần một bước polish rẻ trước khi xuất, không phải một lượt upscale nặng cấp giao hàng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh nguồn: Upload đúng 1 ảnh. Tùy chọn này dành cho một bước polish nhanh với chi phí thấp.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

Không cần tham số mô hình bổ sung.

Wan 2.7 Image Pro

wan-2-7-image-proKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh Wan 2.7 cao cấp hơn của Alibaba, hiện được Rivya đưa vào như một vị trí hình ảnh riêng cho text-to-image và chỉnh sửa hình ảnh. Chi phí được giữ cố định ở 12 credit mỗi lượt chạy bằng cách giới hạn rõ ràng mỗi lần tạo chỉ có một ảnh đầu ra.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 9 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-7-image-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Quy tắc tham chiếu

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

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Không	2K	-	1K, 2K
watermark	select	Không	false	-	false, true
seed	number	Không	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageKhả dụng qua APIMột phần: cần Files API

Hình ảnh · Mô hình hình ảnh Wan 2.7 tiêu chuẩn của Alibaba được Rivya đưa vào như một vị trí hình ảnh riêng cho text-to-image và chỉnh sửa hình ảnh, hiện có chi phí 5 credit mỗi lượt chạy.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image, image-to-image

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 9 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-7-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "watermark": "false",
    "seed": 0
  }
}

Quy tắc tham chiếu

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

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	Không	2K	-	1K, 2K
watermark	select	Không	false	-	false, true
seed	number	Không	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraKhả dụng qua APIText input sẵn sàng

Hình ảnh · Google Imagen4 Ultra là tầng tạo ảnh từ văn bản Imagen cao cấp của Rivya. Hiện mô hình được tích hợp như dự án một ảnh, cố định 12 credit, với các điều khiển công khai gồm prompt, prompt loại trừ, tỷ lệ khung hình và seed.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Những điều tùy chọn cần tránh",
    "seed": "Giá trị seed tùy chọn"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Không	-	-	-
seed	text	Không	-	-	-

Google Imagen4

google-imagen4Khả dụng qua APIText input sẵn sàng

Hình ảnh · Google Imagen4 là tầng tạo ảnh từ văn bản Imagen tiêu chuẩn của Rivya. Hiện mô hình được tích hợp như dự án một ảnh, cố định 8 credit, với các điều khiển công khai gồm prompt, prompt loại trừ, tỷ lệ khung hình và seed.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Những điều tùy chọn cần tránh",
    "seed": "Giá trị seed tùy chọn"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Không	-	-	-
seed	text	Không	-	-	-

Google Imagen4 Fast

google-imagen4-fastKhả dụng qua APIText input sẵn sàng

Hình ảnh · Google Imagen4 Fast là tầng tạo ảnh từ văn bản Imagen nhẹ của Rivya. Hiện mô hình giữ dự án một ảnh, dùng định giá cố định 4 credit và mở các điều khiển công khai gồm prompt, prompt loại trừ, tỷ lệ khung hình và seed mà không mở đầu ra nhiều ảnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "Những điều tùy chọn cần tránh",
    "seed": 0
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspect_ratio	select	Không	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	Không	-	-	-
seed	number	Không	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleKhả dụng qua APICần Files API

Hình ảnh · Trình upscale hình ảnh cấp giao hàng của Topaz trên Rivya dành cho các ảnh tĩnh đã được duyệt và cần tăng kích thước thật sự. Dùng khi bố cục đã là bản cuối và vấn đề còn lại là độ phân giải xuất file, kích thước duyệt hoặc sẵn sàng in.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh nguồn: Tải lên 1 ảnh đã được duyệt mà bạn muốn giữ lại. Tùy chọn này dành cho phóng lớn, không phải chỉnh sửa sáng tạo lại.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
upscale_factor	select	Không	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3Khả dụng qua APIText input sẵn sàng

Hình ảnh · Ideogram V3 là mô hình chuyển văn bản thành hình ảnh trên Rivya cho dựng chữ, bố cục poster và prompt hình ảnh ưu tiên thiết kế. Giá hiện tại là 4 credit cho TURBO, 7 cho BALANCED và 10 cho QUALITY.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-image

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Những điều tùy chọn cần tránh"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
rendering_speed	select	Không	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Không	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Không	true	-	true, false
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Không	-	min 0	-
negative_prompt	text	Không	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeKhả dụng qua APICần Files API

Hình ảnh · Ideogram V3 Reframe hiện được tích hợp trên Rivya như một dự án chỉnh khung một ảnh với giá theo tốc độ render. Giá hiện tại là 4 credit cho TURBO, 7 cho BALANCED và 10 cho QUALITY.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên đúng 1 tệp ảnh cho dự án này.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
rendering_speed	select	Không	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Không	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Không	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixKhả dụng qua APICần Files API

Hình ảnh · Ideogram V3 Remix hiện được tích hợp trên Rivya như một dự án remix một ảnh với giá theo tốc độ render. Giá hiện tại là 4 credit cho TURBO, 7 cho BALANCED và 10 cho QUALITY.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên đúng 1 tệp ảnh cho dự án này.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
rendering_speed	select	Không	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Không	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	Không	true	-	true, false
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Không	-	min 0	-
strength	number	Không	0.8	min 0.01 / max 1	-
negative_prompt	text	Không	-	-	-

Ideogram Character

ideogram-characterKhả dụng qua APICần Files API

Hình ảnh · Tùy chọn giữ nhất quán nhân vật để biến một ảnh nhân vật đã duyệt thành cảnh, trang phục và định dạng mới. Dùng khi việc giữ nhận diện quan trọng hơn chỉnh sửa ảnh rộng, và bạn chỉ cần một ảnh đầu ra mỗi lần.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-image

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu nhân vật: Tải lên 1 ảnh tham chiếu nhân vật rõ ràng. Tùy chọn này bỏ qua ảnh dư và giữ đầu ra ở một kết quả duy nhất.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
rendering_speed	select	Không	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	Không	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	Không	true	-	true, false
image_size	select	Không	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	Không	-	min 0	-
negative_prompt	text	Không	-	-	-

Seedance 2.0

seedance-2Khả dụng qua APIText input sẵn sàng

Video · Mô hình video Seedance 2.0 đầy đủ của ByteDance với hỗ trợ rõ ràng cho tạo prompt-only, animation dẫn dắt bằng khung hình và tạo video tham chiếu đa phương thức. Rivya giữ rõ phần tách vai trò theo tài liệu để đầu vào khung hình và tham chiếu đa phương thức tách biệt nhau, thay vì gom vào một nhóm upload mơ hồ.

API guide Trang mô hình

Tín dụng cơ bản

175

Mode

text-to-video, image-to-video, reference-to-video

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

2500 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedance-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
seedance_scene	select	Không	text	-	text, frames, reference
resolution	select	Không	720p	-	480p, 720p
aspect_ratio	select	Không	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Không	5	min 4 / max 15	-
generate_audio	select	Không	true	-	true, false
return_last_frame	select	Không	false	-	false, true
web_search	select	Không	false	-	false, true
nsfw_checker	select	Không	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastKhả dụng qua APIText input sẵn sàng

Video · Mô hình video Seedance 2.0 nhanh hơn của ByteDance với định tuyến cảnh đầy đủ cho tạo prompt-only, animation dẫn dắt bằng khung hình và tạo video tham chiếu đa phương thức. Rivya giữ rõ phần tách cảnh theo tài liệu để đầu vào khung đầu/cuối không lẫn với vai trò ảnh, video và âm thanh tham chiếu.

API guide Trang mô hình

Tín dụng cơ bản

140

Mode

text-to-video, image-to-video, reference-to-video

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

2500 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedance-2-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
seedance_scene	select	Không	text	-	text, frames, reference
resolution	select	Không	720p	-	480p, 720p
aspect_ratio	select	Không	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	Không	5	min 4 / max 15	-
generate_audio	select	Không	true	-	true, false
return_last_frame	select	Không	false	-	false, true
web_search	select	Không	false	-	false, true
nsfw_checker	select	Không	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video flagship của ByteDance cho text-to-video và image-to-video với đồng bộ âm thanh-hình ảnh native. Hỗ trợ 480p-1080p, clip 4-12s, 6 tỷ lệ khung hình, điều khiển ống kính động/cố định, tạo âm thanh tùy chọn và lip-sync.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

2500 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedance-1-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Upload tối đa 2 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	480p, 720p, 1080p
duration	select	Không	8	-	4, 8, 12
generate_audio	select	Không	false	-	false, true
aspectRatio	select	Không	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	Không	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proKhả dụng qua APIMột phần: cần Files API

Video · Mô hình Seedance 1.0 Pro của ByteDance, được mở trên Rivya như tùy chọn 1.0 Pro tiêu chuẩn cho cả text-to-video và image-to-video. Thiết lập trang hiện được giữ căn chỉnh với tài liệu V1 Pro công khai, gồm điều khiển độ phân giải, thời lượng, khóa camera, seed và kiểm tra an toàn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedance-1-0-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Upload 1 tệp ảnh cho các lượt image-to-video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	480p, 720p, 1080p
duration	select	Không	5	-	5, 10
aspect_ratio	select	Không	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	Không	false	-	false, true
seed	number	Không	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Không	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastKhả dụng qua APICần Files API

Video · Mô hình image-to-video nhanh của ByteDance. Biến một ảnh tham chiếu thành clip 5s hoặc 10s ở 720p/1080p - tối ưu cho tốc độ khi bạn cần video nhanh từ một ảnh tĩnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Upload 1 ảnh nguồn để biến nó thành video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	720p, 1080p
duration	select	Không	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteKhả dụng qua APIMột phần: cần Files API

Video · Mô hình Seedance 1.0 Lite của ByteDance được mở trên Rivya như tùy chọn 1.0 nhẹ hơn cho cả text-to-video và image-to-video. Nó theo bộ tham số V1 Lite công khai và hiện dùng thang giá thấp hơn Seedance 1.0 Pro.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "seedance-1-0-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Upload 1 ảnh nguồn cho image-to-video, hoặc 2 ảnh khi bạn cũng muốn cung cấp một khung cuối tùy chọn.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	480p, 720p, 1080p
duration	select	Không	5	-	5, 10
aspect_ratio	select	Không	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	Không	false	-	false, true
seed	number	Không	-1	min -1 / max 2147483647	-
enable_safety_checker	select	Không	true	-	true, false

HappyHorse 1.0

happyhorse-1-0Khả dụng qua APIMột phần: cần Files API

Video · Một mô hình video AI linh hoạt trên Rivya cho chuyển văn bản thành video, chuyển động từ một ảnh, video tham chiếu từ nhiều ảnh và chỉnh sửa video, tất cả từ một trang mô hình công khai.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video, reference-to-video, video-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, video · 10 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "happyhorse-1-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio_setting": "auto",
    "seed": 0
  }
}

Quy tắc tham chiếu

Media tham chiếu: Dùng tối đa 9 ảnh khi không có video, hoặc 1 video với tối đa 5 ảnh tham chiếu cho chỉnh sửa video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	1080p	-	720p, 1080p
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	Không	5	min 3 / max 15	-
audio_setting	select	Không	auto	-	auto, origin
seed	number	Không	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoKhả dụng qua APIMột phần: cần Files API

Video · Dòng video Wan mới hơn của Alibaba, tính giá theo độ phân giải và thời lượng. Rivya hiện đưa text-to-video, image-to-video và chỉnh sửa video vào cùng một vị trí mô hình, bắt đầu từ 80 credit cho mỗi lần tạo.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video, video-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, video · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-7-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Các loại trừ hoặc lỗi hình ảnh tùy chọn cần tránh.",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Quy tắc tham chiếu

Media tham chiếu: Tải lên tối đa 2 asset. Dùng tối đa 2 ảnh cho image-to-video, hoặc 1 video cộng 1 ảnh tùy chọn cho chỉnh sửa video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	720p, 1080p
duration	select	Không	5	-	5, 10, 15
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	Không	-	-	-
prompt_extend	select	Không	true	-	true, false
watermark	select	Không	false	-	false, true
audio_setting	select	Không	auto	-	auto, origin
seed	number	Không	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6Khả dụng qua APIMột phần: cần Files API

Video · Tùy chọn Wan ba chế độ của Alibaba trên Rivya: text-to-video, image-to-video và chỉnh sửa video nguồn trong một dự án. Nó hỗ trợ 720p/1080p, clip 5-15 giây và mỗi lần nhận một ảnh hoặc một video nguồn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video, video-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, video · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5"
  }
}

Quy tắc tham chiếu

Media tham chiếu: Tải lên tối đa 1 tệp hình ảnh / video cho dự án hình ảnh / video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	720p, 1080p
duration	select	Không	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoKhả dụng qua APIMột phần: cần Files API

Video · Wan 2.5 hiện được mở trên Rivya như một lối vào chung cho text-to-video và image-to-video. Giá hiện tại là `720p_5 = 60`, `720p_10 = 120`, `1080p_5 = 100` và `1080p_10 = 200` credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-5-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "negative_prompt": "Loại trừ tùy chọn hoặc các kiểu lỗi cần tránh.",
    "nsfw_checker": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp hình ảnh cho chế độ image-to-video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	720p, 1080p
duration	select	Không	5	-	5, 10
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	Không	false	-	false, true
seed	number	Không	-	min 0 / max 2147483647	-
negative_prompt	text	Không	-	-	-
nsfw_checker	select	Không	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboKhả dụng qua APIMột phần: cần Files API

Video · Wan 2.2 A14B Turbo hiện bao phủ text-to-video, image-to-video và đường dẫn video dẫn dắt bằng hình ảnh kèm âm thanh trên Rivya. Giá hiện tại là `480p = 8` và `720p = 12` cho lượt chạy từ văn bản hoặc hình ảnh, cộng thêm `480p = 16`, `580p = 20` và `720p = 24` khi một ảnh và một clip âm thanh dẫn dắt kết quả.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video, speech-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, audio · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Loại trừ tùy chọn hoặc các kiểu lỗi cần tránh.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Quy tắc tham chiếu

Media tham chiếu: Tải lên tối đa 2 asset. Chế độ văn bản không cần asset, image-to-video dùng 1 ảnh, và đường dẫn hình ảnh cộng âm thanh dùng 1 ảnh cộng 1 clip âm thanh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	720p	-	480p, 580p, 720p
aspect_ratio	select	Không	16:9	-	16:9, 9:16
enable_prompt_expansion	select	Không	false	-	false, true
seed	number	Không	-	min 0 / max 2147483647	-
acceleration	select	Không	none	-	none, regular
num_frames	number	Không	80	min 40 / max 120 / step 1	-
frames_per_second	number	Không	16	min 4 / max 60 / step 1	-
negative_prompt	text	Không	-	-	-
num_inference_steps	number	Không	27	min 2 / max 40 / step 1	-
guidance_scale	number	Không	3.5	min 1 / max 10 / step 0.1	-
shift	number	Không	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	Không	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceKhả dụng qua APIURL input sẵn sàng

Video · Mô hình video thay thế nhân vật của Wan trên Rivya để đổi chủ thể xuất hiện trong một clip có sẵn. Dùng một URL video nguồn công khai, một URL ảnh thay thế công khai và một tầng độ phân giải khi chuyển động đã đúng nhưng chủ thể nhìn thấy cần thay đổi.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

URL input sẵn sàng

Input

url

Giới hạn prompt

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "wan-2-2-animate-replace",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://...",
    "image_url": "https://...",
    "resolution": "480p"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mô hình này nhận public URL input qua model parameters.

Parameters

key	Type	Bắt buộc	Default	Range	Options
video_url	text	Không	-	-	-
image_url	text	Không	-	-	-
resolution	select	Không	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3Khả dụng qua APICần Files API

Video · Mô hình chuyển ảnh thành video của MiniMax với các mức chất lượng Standard/Pro, độ phân giải 768P/1080P và clip 6 giây hoặc 10 giây. Nổi bật ở chuyển động mượt hơn và các đoạn chuyển tiếp tự nhiên từ ảnh tĩnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
quality	select	Không	standard	-	standard, pro
resolution	select	Không	768P	-	768P, 1080P
duration	select	Không	6	-	6, 10

Hailuo Pro

hailuo-proKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video Hailuo Pro đời cũ của MiniMax được kết nối tại đây như một mô hình cố định ở mức Pro cho cả chuyển văn bản thành video và chuyển ảnh thành video. Chế độ ảnh chấp nhận 1 hoặc 2 ảnh tham chiếu, trong đó ảnh thứ hai được dùng làm khung hình cuối, và mỗi lượt chạy hiện tốn 57 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

1500 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "hailuo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "prompt_optimizer": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Chế độ ảnh chấp nhận tối đa 2 ảnh, và ảnh thứ hai sẽ trở thành khung hình cuối.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
prompt_optimizer	select	Không	false	-	false, true

Hailuo Standard

hailuo-standardKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video Hailuo Standard đời cũ của MiniMax, được hợp nhất tại đây thành một mô hình cho cả chuyển văn bản thành video và chuyển ảnh thành video. Chế độ ảnh chấp nhận 1 hoặc 2 ảnh tham chiếu, trong đó ảnh thứ hai được dùng làm khung hình cuối, và các mức giá công khai hiện đã xác minh nằm trong khoảng 12 đến 50 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

1500 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "hailuo-standard",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "6",
    "resolution": "512P",
    "prompt_optimizer": "false"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Chế độ ảnh chấp nhận tối đa 2 ảnh, và ảnh thứ hai sẽ trở thành khung hình cuối.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	6	-	6, 10
resolution	select	Không	512P	-	512P, 768P
prompt_optimizer	select	Không	false	-	false, true

Kling 3.0

kling-3-0Khả dụng qua APIMột phần: cần Files API

Video · Mô hình video cao cấp của Kuaishou cho chuyển văn bản thành video và chuyển ảnh thành video, với các mức Standard (720P) / Pro (1080P), cấu trúc một cảnh hoặc nhiều cảnh, thời lượng 3-15 giây, tạo âm thanh tùy chọn và tối đa 2 ảnh tham chiếu.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

2000 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "kling-3-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "pro",
    "multi_shots": "false",
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "16:9"
  }
}

Quy tắc tham chiếu

Media tham chiếu: Tải lên tổng cộng tối đa 2 tệp ảnh cho các dự án chuyển ảnh thành video.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
mode	select	Không	pro	-	std, pro
multi_shots	select	Không	false	-	false, true
duration	select	Không	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	Không	false	-	false, true
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlKhả dụng qua APICần Files API

Video · Tùy chọn Kling motion-control mới hơn để điều khiển một chủ thể từ một ảnh tham chiếu cộng một video chuyển động, với lựa chọn nguồn nền rõ ràng. Dùng khi bạn muốn chuyển động cộng khả năng kiểm soát mạnh hơn về việc cảnh nên đến từ video hay ảnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

2500 ký tự

Media tham chiếu

image, video · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu + video chuyển động: Tải lên đúng 1 ảnh nhân vật và 1 clip chuyển động. Dùng 3.0 khi bạn cần cả điều khiển hướng lẫn lựa chọn nguồn nền.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
mode	select	Không	pro	-	std, pro
character_orientation	select	Không	video	-	video, image
background_source	select	Không	input_video	-	input_video, input_image

Kling 2.6

kling-2-6Khả dụng qua APIMột phần: cần Files API

Video · Mô hình video của Kuaishou với tạo âm thanh tùy chọn, clip 5 giây/10 giây và 3 tỷ lệ khung hình. Mạnh về chuyển động con người và hoạt ảnh nhân vật giàu biểu cảm với vật lý tự nhiên.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

1000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "kling-2-6",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 1 tệp ảnh cho các dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
sound	select	Không	false	-	false, true
aspect_ratio	select	Không	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlKhả dụng qua APICần Files API

Video · Dự án chuyển động chuyên dụng để điều khiển một chủ thể từ một ảnh tham chiếu cộng một video chuyển động. Dùng khi bạn muốn một lượt Kling motion-control rẻ hơn và có thể không cần các điều khiển cảnh bổ sung trong Kling 3.0 motion-control.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

2500 ký tự

Media tham chiếu

image, video · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu + video chuyển động: Tải lên đúng 1 ảnh nhân vật và 1 clip chuyển động. Cả hai nên thể hiện rõ đầu, vai và thân.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
mode	select	Không	720p	-	720p, 1080p
character_orientation	select	Không	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video Kling V2.5 Turbo Pro của Kuaishou, hiện hỗ trợ cả text-to-video và image-to-video. Bằng chứng giá công khai bao phủ rõ cả hai bậc text và image ở 5 giây và 10 giây, nên Rivya ánh xạ trực tiếp thành 42 / 84 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

2500 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Mô tả những gì video nên tránh",
    "cfg_scale": 0.5
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tùy chọn tải lên tối đa 2 ảnh để chuyển sang chế độ image-to-video; ảnh thứ hai được ánh xạ thành khung cuối.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Không	-	-	-
cfg_scale	number	Không	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video Kling V2.1 Master đời cũ của Kuaishou hiện hỗ trợ cả chuyển văn bản thành video và chuyển ảnh thành video trên Rivya. Giá hiện tại là 160 credit cho 5 giây và 320 credit cho 10 giây.

API guide Trang mô hình

Tín dụng cơ bản

160

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "kling-v2-1-master",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Mô tả những gì video nên tránh",
    "cfg_scale": 0.5
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tùy chọn tải lên một ảnh để chuyển sang chế độ chuyển ảnh thành video; để trống để ở chế độ văn bản.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
aspect_ratio	select	Không	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	Không	-	-	-
cfg_scale	number	Không	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proKhả dụng qua APICần Files API

Video · Mô hình chuyển ảnh thành video Kling V2.1 Pro đời cũ của Kuaishou hỗ trợ một khung đầu cộng một ảnh khung cuối tùy chọn. Giá hiện tại là 50 credit cho 5 giây và 100 credit cho 10 giây.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Chế độ ảnh chấp nhận tối đa 2 tệp ảnh, và ảnh thứ hai ánh xạ thành khung cuối.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
negative_prompt	text	Không	-	-	-
cfg_scale	number	Không	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardKhả dụng qua APICần Files API

Video · Mô hình chuyển ảnh thành video Kling V2.1 Standard đời cũ của Kuaishou. Giá hiện tại là 25 credit cho 5 giây và 50 credit cho 10 giây.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh tham chiếu: Chế độ ảnh chấp nhận tối đa 1 tệp ảnh làm khung đầu.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
negative_prompt	text	Không	-	-	-
cfg_scale	number	Không	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proKhả dụng qua APICần Files API

Video · Mô hình avatar nói chuyện Kling AI Avatar Pro chất lượng cao hơn của Kuaishou, dùng một ảnh chân dung cộng một clip âm thanh để tạo video avatar khớp môi. Rivya hiện định giá cố định 16 credit cho mỗi lần tạo.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, audio · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh chân dung và âm thanh: Tải lên cùng lúc một ảnh chân dung và một clip âm thanh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

Không cần tham số mô hình bổ sung.

Kling AI Avatar Standard

kling-ai-avatar-standardKhả dụng qua APICần Files API

Video · Mô hình avatar nói chuyện Kling AI Avatar Standard của Kuaishou, dùng một ảnh chân dung cộng một clip âm thanh để tạo video avatar khớp môi. Rivya hiện định giá cố định 8 credit cho mỗi lần tạo.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, audio · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh chân dung và âm thanh: Tải lên cùng lúc một ảnh chân dung và một clip âm thanh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

Không cần tham số mô hình bổ sung.

Infinitalk

infinitalkKhả dụng qua APICần Files API

Video · Infinitalk là mô hình video nói chuyện dùng chân dung cộng âm thanh. Giá hiện tại được tính theo độ phân giải và thời lượng âm thanh: 480p = 3 credit mỗi giây và 720p = 12 credit mỗi giây.

API guide Trang mô hình

Tín dụng cơ bản

Mode

image-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image, audio · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Ảnh chân dung và âm thanh: Tải lên cùng lúc một ảnh chân dung và một clip âm thanh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
resolution	select	Không	480p	-	480p, 720p
seed	number	Không	-	min 10000 / max 1000000	-

Runway

runwayKhả dụng qua APIMột phần: cần Files API

Video · Runway là mô hình video độc lập hỗ trợ cả text-to-video và image-to-video. Bằng chứng giá công khai hiện chỉ xác nhận 6 bậc tạo, nên Rivya giữ nó trong tập đã kiểm chứng: `720p_5 = 12`, `720p_10 = 30`, và `1080p_5 = 30`.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

1800 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "Để trống để tắt watermark"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tùy chọn upload một ảnh để chuyển sang chế độ image-to-video; để trống để ở lại chế độ text.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
duration	select	Không	5	-	5, 10
quality	select	Không	720p	-	720p, 1080p
aspectRatio	select	Không	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	Không	-	-	-

Runway Aleph

runway-alephKhả dụng qua APICần Files API

Video · Dự án biến đổi source-video để chỉnh một clip hiện có thành kết quả thị giác mới. Dùng Aleph khi chuyển động đến từ footage đầu vào của bạn và hướng sáng tạo đến từ prompt, với giá cố định 90 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

5000 ký tự

Media tham chiếu

video, image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Media đầu vào: Upload clip nguồn bạn muốn Aleph biến đổi. Chỉ thêm một ảnh tĩnh tùy chọn khi bạn cần dẫn hướng thêm về phong cách hoặc chủ thể.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	Không	-	-	-
seed	number	Không	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoKhả dụng qua APICần Files API

Video · Dự án rewrite source-video độc lập để đẩy một clip hiện có sang hướng thị giác mới. Dùng khi prompt cần biến đổi chính footage, chứ không chỉ làm bản xuất sắc nét hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

video · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Video đầu vào: Tải lên một clip nguồn ngắn mà bạn muốn biến đổi. Tùy chọn này rewrite footage thay vì chỉ enhancement nó.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
watermark	text	Không	-	-	-

Grok Imagine Video

grok-imagine-videoKhả dụng qua APIMột phần: cần Files API

Video · Mô hình video của xAI với các chế độ sáng tạo Fun/Normal/Spicy và 5 tỷ lệ khung hình. Các preset phong cách độc đáo cho nhiều sắc thái sáng tạo khác nhau — từ vui nhộn đến điện ảnh rồi táo bạo.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "grok-imagine-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "mode": "normal",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "2:3"
  }
}

Quy tắc tham chiếu

Hình ảnh tham chiếu: Tải lên tối đa 1 tệp hình ảnh cho dự án hình ảnh.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
mode	select	Không	normal	-	fun, normal, spicy
duration	number	Không	6	min 6 / max 30 / step 1	-
resolution	select	Không	480p	-	480p, 720p
aspect_ratio	select	Không	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proKhả dụng qua APIMột phần: cần Files API

Video · Tầng cao cấp của Sora 2 với chế độ chất lượng Standard/High, clip 10s/15s và tùy chọn xóa watermark. Chi tiết, ánh sáng và độ trung thực chuyển động được nâng cao cho sản xuất video chuyên nghiệp.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "sora-2-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "size": "standard",
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Quy tắc tham chiếu

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

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
size	select	Không	-	-	standard, high
n_frames	select	Không	10	-	10, 15
aspect_ratio	select	Không	landscape	-	landscape, portrait
remove_watermark	select	Không	false	-	false, true
upload_method	select	Không	s3	-	s3, oss

Sora 2

sora-2Khả dụng qua APIMột phần: cần Files API

Video · Mô hình video của OpenAI cho text-to-video và image-to-video với mô phỏng thế giới chân thực, âm thanh đồng bộ, clip 10s/15s, đầu ra ngang/dọc và tùy chọn xóa watermark.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

10000 ký tự

Media tham chiếu

image · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "sora-2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "n_frames": "10",
    "aspect_ratio": "landscape",
    "remove_watermark": "false",
    "upload_method": "s3"
  }
}

Quy tắc tham chiếu

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

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
n_frames	select	Không	10	-	10, 15
aspect_ratio	select	Không	landscape	-	landscape, portrait
remove_watermark	select	Không	false	-	false, true
upload_method	select	Không	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerKhả dụng qua APIURL input sẵn sàng

Video · Mô hình hậu xử lý xóa watermark của Sora trên Rivya dành cho các liên kết chia sẻ Sora công khai đã hoàn thiện. Dùng sau khi video đã xong, khi nhiệm vụ còn lại là xóa watermark và chọn giao tới S3 hoặc OSS.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

URL input sẵn sàng

Input

url

Giới hạn prompt

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "sora-watermark-remover",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "video_url": "https://sora.chatgpt.com/p/...",
    "upload_method": "s3"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mô hình này nhận public URL input qua model parameters.

Parameters

key	Type	Bắt buộc	Default	Range	Options
video_url	text	Có	-	-	-
upload_method	select	Có	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleKhả dụng qua APICần Files API

Video · Trình upscale video cấp giao hàng của Topaz trên Rivya dành cho các clip đã được duyệt và chỉ cần rõ hơn khi xuất file. Dùng khi cảnh quay, chuyển động và timing đã đúng, còn vấn đề còn lại là độ phân giải hoặc độ sắc nét của file cuối.

API guide Trang mô hình

Tín dụng cơ bản

Mode

video-to-video

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

video · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Video nguồn: Tải lên 1 clip nguồn bạn muốn giữ lại. Tùy chọn này cải thiện độ rõ giao hàng thay vì thay đổi cảnh quay.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
upscale_factor	select	Không	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityKhả dụng qua APIMột phần: cần Files API

Video · Biến thể ưu tiên chất lượng của Google Veo 3.1 cho text-to-video premium và tạo dẫn dắt bằng hình ảnh. Hình ảnh trung thực hơn, chuyển động thực hơn và âm thanh nền mặc định khiến nó trở thành tùy chọn Veo cao cấp hơn của Rivya.

API guide Trang mô hình

Tín dụng cơ bản

150

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Chữ watermark tùy chọn",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 2 tệp hình ảnh cho dự án dẫn dắt bằng hình ảnh được hỗ trợ.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	16:9	-	16:9, 9:16, Auto
watermark	text	Không	-	-	-
seeds	number	Không	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Không	true	-	true, false

Veo3.1 Fast

veo3-1-fastKhả dụng qua APIMột phần: cần Files API

Video · Biến thể nhanh của Google Veo 3.1 với hỗ trợ ba chế độ: text-to-video, image-to-video và reference-to-video. Tối đa 3 ảnh tham chiếu, âm thanh native và điều khiển tỷ lệ khung hình theo từng chế độ giúp nó hữu ích cho các clip điện ảnh nhanh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video, reference-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 3 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "veo3-1-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "watermark": "Chữ watermark tùy chọn",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 3 tệp hình ảnh cho dự án hình ảnh và dự án dẫn dắt bằng tham chiếu.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
generationType	select	Không	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	Không	16:9	-	16:9, 9:16, Auto
watermark	text	Không	-	-	-
seeds	number	Không	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Không	true	-	true, false

Veo3.1 Lite

veo3-1-liteKhả dụng qua APIMột phần: cần Files API

Video · Biến thể chi phí thấp nhất của Google Veo 3.1. Rivya hiện chỉ mở nhóm ổn định nhỏ nhất: text-to-video và image-to-video với giá cố định `10` credit mỗi lần tạo.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-video, image-to-video

API input

Một phần: cần Files API

Input

text, file

Giới hạn prompt

5000 ký tự

Media tham chiếu

image · 2 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Chữ watermark tùy chọn",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

Quy tắc tham chiếu

Ảnh tham chiếu: Tải lên tối đa 2 tệp hình ảnh cho dự án dẫn dắt bằng hình ảnh được hỗ trợ.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt hoặc URL modes có thể gọi được hiện tại. Reference-media modes vẫn cần hỗ trợ upload Files API. Files API

Parameters

key	Type	Bắt buộc	Default	Range	Options
aspectRatio	select	Không	16:9	-	16:9, 9:16, Auto
watermark	text	Không	-	-	-
seeds	number	Không	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	Không	true	-	true, false

Suno Music

suno-musicKhả dụng qua APIText input sẵn sàng

Âm thanh · Suno Music là mô hình text-to-music của Rivya để biến một brief ngắn thành bản nháp bài hát đầu tiên, có hoặc không có vocal. Nó giữ điểm vào cố định `12` credit và mở `Extend Music` làm bước tiếp theo sau khi track thành công.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-audio

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

500 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "suno-music",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
model	select	Không	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	Không	false	-	false, true

Suno Sounds

suno-soundsKhả dụng qua APIText input sẵn sàng

Âm thanh · Suno Sounds là mô hình text-to-sound nhẹ của Rivya cho ambience loop, âm thanh nền và phác thảo âm thanh ngắn. Nó giữ giá cố định được ghi rõ là `3` credit mỗi lần tạo và cho phép kết quả thành công tiếp tục sang `Vocal Separation`.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-audio

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

500 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "suno-sounds",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
model	select	Không	V5	-	V5, V5_5
soundLoop	select	Không	false	-	false, true
soundTempo	number	Không	-	min 1 / max 300 / step 1	-
soundKey	select	Không	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B

Suno Lyrics

suno-lyricsKhả dụng qua APIText input sẵn sàng

Âm thanh · Suno Lyrics là mô hình tạo lời bài hát của Rivya để biến một chủ đề hoặc tâm trạng thành lời ca với chi phí cố định `1` credit mỗi yêu cầu.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-audio

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

200 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "suno-lyrics",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

Không cần tham số mô hình bổ sung.

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3Khả dụng qua APIText input sẵn sàng

Âm thanh · Mô hình đối thoại nhiều người nói của ElevenLabs trên Rivya. Mô hình được xây dựng cho tạo giọng nói theo vai, với gán giọng riêng cho từng nhân vật, điều khiển stability và nhịp đọc sẵn sàng cho đối thoại trong podcast, phỏng vấn và cảnh nhân vật.

API guide Trang mô hình

Tín dụng cơ bản

Mode

dialogue-to-audio

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
default_voice	select	Không	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	Không	0.5	-	0, 0.5, 1
language_code	text	Không	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5Khả dụng qua APIText input sẵn sàng

Âm thanh · Mô hình chuyển văn bản thành giọng nói tốc độ cao của ElevenLabs trên Rivya. Với khả năng tạo giọng độ trễ thấp cùng các điều khiển độ ổn định, độ tương đồng, phong cách và tốc độ, mô hình này phù hợp cho bản nháp lồng tiếng nhanh và dự án TTS tương tác.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-speech

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Ngữ cảnh tùy chọn trước dòng này",
    "next_text": "Ngữ cảnh tùy chọn sau dòng này",
    "language_code": "Mã locale tùy chọn như en hoặc zh"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
voice	select	Có	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Không	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Không	0.75	min 0 / max 1 / step 0.05	-
style	number	Không	0	min 0 / max 1 / step 0.05	-
speed	number	Không	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Không	false	-	false, true
previous_text	text	Không	-	-	-
next_text	text	Không	-	-	-
language_code	text	Không	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2Khả dụng qua APIText input sẵn sàng

Âm thanh · Mô hình text-to-speech đa ngôn ngữ của ElevenLabs trên Rivya, hỗ trợ khoảng 30 ngôn ngữ với tự động nhận diện. Đây là lựa chọn mạnh hơn cho bản địa hóa, phân phối xuyên ngôn ngữ và voiceover đa ngôn ngữ tự nhiên hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-speech

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "elevenlabs-multilingual-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
voice	select	Có	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	Không	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	Không	0.75	min 0 / max 1 / step 0.05	-
style	number	Không	0	min 0 / max 1 / step 0.05	-
speed	number	Không	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	Không	false	-	false, true
previous_text	text	Không	-	-	-
next_text	text	Không	-	-	-
language_code	text	Không	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2Khả dụng qua APIText input sẵn sàng

Âm thanh · Mô hình text-to-sound của ElevenLabs trên Rivya cho hiệu ứng ngắn, chuyển cảnh và loop ambience. Tạo clip âm thanh 0.5–22 giây với prompt influence có thể điều chỉnh, chế độ loop và 19 định dạng đầu ra cho dự án chỉnh sửa, sản phẩm hoặc game.

API guide Trang mô hình

Tín dụng cơ bản

Mode

text-to-audio

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

5000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Parameters

key	Type	Bắt buộc	Default	Range	Options
loop	select	Không	false	-	false, true
duration_seconds	number	Không	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	Không	0.3	min 0 / max 1 / step 0.05	-
output_format	select	Không	mp3_44100_128	-	mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192

ElevenLabs Audio Isolation

elevenlabs-audio-isolationKhả dụng qua APICần Files API

Âm thanh · Mô hình dọn âm thanh và tách giọng của ElevenLabs trên Rivya. Tải lên một bản ghi để tách vocal, loại bỏ tiếng ồn nền và làm sạch âm thanh lời nói trước khi chỉnh sửa hoặc xuất bản.

API guide Trang mô hình

Tín dụng cơ bản

Mode

audio-to-audio

API input

Cần Files API

Input

file

Giới hạn prompt

Media tham chiếu

audio · 1 file

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

Không có ví dụ Public API có thể chạy cho mô hình này.

Quy tắc tham chiếu

Âm thanh nguồn: Tải lên một tệp âm thanh và Rivya sẽ tách, làm sạch track mục tiêu.

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Mode dựa trên file cần /api/v1/files trước khi có thể hiển thị như ví dụ API-ready hoàn chỉnh. Files API

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.5

gpt-5-5-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat GPT nâng cao của OpenAI trên Rivya cho suy luận phức tạp, phân tích có nhận biết hình ảnh, tổng hợp nghiên cứu và viết có cấu trúc khi brief cần nhiều khoảng xử lý hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.4

gpt-5-4-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI cao cấp hơn của OpenAI trên Rivya, với khả năng xử lý đầu vào có cấu trúc tốt hơn, kiểm soát suy luận mạnh hơn và các dự án hội thoại thiên về công cụ cho những nhiệm vụ phân tích và viết phức tạp hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-4-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.4 Codex

gpt-5.4-codex-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình Codex cao cấp hơn của OpenAI trên Rivya, với năng lực lập trình mạnh hơn, suy luận có cấu trúc và cộng tác thiên về công cụ cho các dự án phát triển cấp repo đòi hỏi cao.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5.4-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.3 Codex

gpt-5-3-codex-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình Codex mới nhất và mạnh nhất của OpenAI trên Rivya. Mô hình kết hợp chất lượng tạo code hiện đại với suy luận agentic sâu hơn cho những dự án phát triển đòi hỏi cao nhất.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-3-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.2

gpt-5-2-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI GPT chủ lực của OpenAI trên Rivya, với suy luận nâng cao, hỗ trợ thị giác cho tối đa 6 ảnh và cửa sổ ngữ cảnh 20K ký tự. Đây là lựa chọn GPT tổng quát mạnh cho nghiên cứu, lập kế hoạch, viết và phân tích có nhận biết hình ảnh.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-2-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.2 Codex

gpt-5-2-codex-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình Codex nâng cao hơn của OpenAI trên Rivya, với suy luận mạnh hơn cho các tác vụ kỹ thuật phức tạp. Mô hình được tối ưu cho lập trình agentic dài hạn, quyết định kiến trúc và refactor lớn khi tạo code đơn thuần là chưa đủ.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-2-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5.1 Codex

gpt-5-1-codex-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình Codex nâng cấp của OpenAI trên Rivya, với độ chính xác code tốt hơn và suy luận mạnh hơn cho các tác vụ lập trình dạng agent. Mô hình giữ cùng dự án nhận biết repo, đầu ra dài, đồng thời cải thiện refactor nhiều file và chỉnh sửa code an toàn hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-1-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

GPT-5 Codex

gpt-5-codex-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình GPT-5 Codex chuyên về code của OpenAI trên Rivya cho debug, lập kế hoạch triển khai, refactor và giải quyết vấn đề kỹ thuật với hỗ trợ thị giác.

API guide Trang mô hình

Tín dụng cơ bản

Mode

responses

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gpt-5-codex-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Gemini 3.1 Pro

gemini-3-1-pro-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI Gemini mới nhất và mạnh nhất của Google trên Rivya. Với suy luận, thị giác và khả năng tuân thủ chỉ dẫn ở cấp cao, đây là lựa chọn Gemini mạnh nhất cho các tác vụ phân tích và sáng tạo đòi hỏi cao.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gemini-3-1-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Gemini 3 Pro

gemini-3-pro-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI Gemini có chiều sâu cao hơn của Google trên Rivya. Với suy luận mạnh hơn Gemini 2.5 Pro và hỗ trợ thị giác, mô hình này phù hợp hơn cho tổng hợp nghiên cứu, viết kỹ thuật và phân tích đa phương thức thận trọng hơn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gemini-3-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Gemini 3 Flash

gemini-3-flash-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI nhanh thế hệ mới của Google trên Rivya. Với chi phí token còn thấp hơn Gemini 2.5 Flash và suy luận mạnh hơn, mô hình này được xây dựng cho chat đa phương thức khối lượng lớn, phân loại ảnh chụp màn hình và công việc trợ lý tốc độ cao.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gemini-3-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Gemini 2.5 Pro

gemini-2-5-pro-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI Gemini nâng cao hơn của Google trên Rivya. Với khả năng suy luận mạnh hơn Flash, hỗ trợ thị giác và ngữ cảnh 20K, mô hình này phù hợp hơn cho tổng hợp nghiên cứu, phân tích tài liệu và viết có cấu trúc ở mức 2 credit.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gemini-2-5-pro-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Gemini 2.5 Flash

gemini-2-5-flash-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat AI nhanh nhất và tiết kiệm nhất của Google trên Rivya. Với mức 1 credit cho mỗi lượt dùng và hỗ trợ thị giác cho tối đa 6 ảnh, mô hình này phù hợp cho hỏi đáp nhanh, tóm tắt vòng đầu, phân loại ảnh chụp màn hình và hỗ trợ AI hằng ngày.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text, file

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "gemini-2-5-flash-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Image attachments phải dùng giá trị file_id của Files API.

Parameters

Không cần tham số mô hình bổ sung.

Claude Opus 4.7

claude-opus-4-7-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude flagship của Anthropic trên Rivya cho suy luận sâu, tổng hợp cẩn trọng, viết cấp điều hành và công việc văn bản có tác động cao.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-opus-4-7-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Claude Opus 4.6

claude-opus-4-6-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude AI flagship của Anthropic trên Rivya. Mô hình này được xây dựng cho suy luận sâu, phân tích phức tạp và viết chất lượng cao trong các dự án đòi hỏi cao, rủi ro lớn.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-opus-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Claude Sonnet 4.6

claude-sonnet-4-6-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude AI cân bằng của Anthropic trên Rivya. Mô hình giữ khả năng suy luận dài mạnh và phân tích cẩn trọng cho dự án nội dung, nghiên cứu và coding mà không phải nhảy lên mức chi của Opus.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-sonnet-4-6-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Claude Opus 4.5

claude-opus-4-5-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude AI flagship của Anthropic trên Rivya. Mô hình này xuất sắc ở suy luận sâu, phân tích phức tạp và viết ở cấp chuyên gia, là lựa chọn premium cho các tác vụ AI quan trọng.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-opus-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Claude Sonnet 4.5

claude-sonnet-4-5-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude AI cân bằng của Anthropic trên Rivya. Mô hình mạnh về viết tinh tế, phân tích cẩn trọng và phản hồi có ý thức an toàn, là một lựa chọn Claude vững cho sáng tạo nội dung và nghiên cứu.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-sonnet-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Claude Haiku 4.5

claude-haiku-4-5-chatKhả dụng qua APIText input sẵn sàng

Chat · Mô hình chat Claude AI nhẹ của Anthropic trên Rivya. Mô hình này được tinh chỉnh cho tốc độ, hiệu quả chi phí và hiệu suất chat hằng ngày ổn định trong các dự án tần suất cao, nơi bạn muốn giọng điệu Claude mà không cần chi premium.

API guide Trang mô hình

Tín dụng cơ bản

Mode

chat-completion

API input

Text input sẵn sàng

Input

text

Giới hạn prompt

20000 ký tự

Media tham chiếu

Request

POST /api/v1/generations

Auth

Khóa API Bearer

Idempotency-Key

Đề xuất

Body

{
  "model": "claude-haiku-4-5-chat",
  "prompt": "A clean editorial product image on a soft studio background"
}

Quy tắc tham chiếu

Kết quả

Create response trả về public task id. Poll GET /api/v1/generations/{taskId} cho đến khi status là succeeded hoặc failed.

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API hỗ trợ lượt non-streaming và SSE streaming trong Public API v1. Mô hình chat này không hỗ trợ image attachments.

Parameters

Không cần tham số mô hình bổ sung.

Tham chiếu API mô hình

Cách đọc tham chiếu này

Mẫu request

Tham chiếu mô hình động

Dùng reference này với debugger

Z-Image

Body

Parameters

Nano Banana 2

Body

Parameters

Nano Banana Pro

Body

Parameters

Nano Banana

Body

Parameters

GPT Image 2

Body

Parameters

GPT Image 1.5

Body

Parameters

4o Image

Body

Parameters

Seedream 5.0 Lite

Body

Parameters

Seedream 4.5

Body

Parameters

Seedream 4.0

Body

Parameters

Seedream 3.0

Body

Parameters

Grok Imagine

Body

Parameters

Flux 2 Pro

Body

Parameters

Flux 2 Flex

Body

Parameters

Flux Kontext Max

Body

Parameters

Flux Kontext Pro

Body

Parameters

Qwen2 Image

Body

Parameters

Qwen Image

Body

Parameters

Midjourney

Body

Parameters

Recraft Remove Background

Body

Parameters

Recraft Crisp Upscale

Body

Parameters

Wan 2.7 Image Pro

Body

Parameters

Wan 2.7 Image

Body

Parameters

Google Imagen4 Ultra

Body

Parameters

Google Imagen4

Body

Parameters