查詢 Rivya API 模型 ID、可用狀態、支援模式、參數表、提示詞限制、參考媒體規則和模型詳情連結。

這個頁面是 Rivya API v1 的模型層級 API 參考。

下方表格由 /api/v1/models 使用的同一份模型目錄和公開 serializer 生成，不是手動寫死的固定模型數量。

如何閱讀這份參考

對於非同步圖片、影片和音訊模型，請使用模型 id 作為 model，並放在 POST /api/v1/generations 中。
在 POST /api/v1/chat/completions 中使用 chat model IDs。
生成提示文字使用頂層 prompt。
Chat API 回合使用頂層 message。
將非同步模型專屬欄位放在 params 內。
建立整合前先閱讀 api_input_status。available_text 和 available_url_input 不需要檔案上傳即可測試；partial_requires_files 代表只有部分模式需要 Files API；requires_files_api 代表呼叫模型前需要先透過 Files API 上傳參考媒體。
對於聊天模型，請閱讀 chat_capabilities，確認非串流支援、SSE 串流支援、圖片 file_id 附件、web search、thoughts 和 reasoning effort。
模型詳情頁提供產品層級指引和範例。

Request Pattern

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

JavaScript 和 Python 範例請見建立生成任務。

Chat request shape：

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Chat 範例請見 Chat API。

動態模型參考

搭配線上除錯器使用這份參考

先從 Quickstart 確認呼叫流程，再在這裡核對模型欄位，最後到 Developers 除錯器執行 mock 或登入後的真實請求。

API Quickstart 線上除錯器

Z-Image

z-imageAPI 可呼叫文字輸入可用

圖片 · 阿里巴巴的輕量文字轉圖片模型。以 1 點數即可快速生成單張圖片，支援 5 種長寬比，適合快速概念草稿和社群媒體視覺。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

1000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16

Nano Banana 2

nano-banana-2API 可呼叫部分可用：需要 Files API

圖片 · Google 的新一代圖片模型，具備 4K 解析度、15 種長寬比（包含極端 8:1）、Google Search 真實脈絡依據，以及最多 14 張參考圖片，是 Rivya 上最靈活的圖片生成器。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image · 14 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 14 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	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	否	1K	-	1K, 2K, 4K
output_format	select	否	jpg	-	jpg, png
google_search	select	否	false	-	false, true

Nano Banana Pro

nano-banana-proAPI 可呼叫部分可用：需要 Files API

圖片 · Google 的高階圖片模型，支援 4K 輸出、11 種長寬比和最多 8 張參考圖片。針對高保真品牌與行銷活動視覺最佳化，具備更好的細節和色彩準確度。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

10000 字元

參考素材

image · 8 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 8 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	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	否	1K	-	1K, 2K, 4K
output_format	select	否	png	-	png, jpg

Nano Banana

nano-bananaAPI 可呼叫部分可用：需要 Files API

圖片 · Google 的靈活圖片模型，支援文字轉圖片和圖片轉圖片，包含 11 種長寬比、最多 10 張參考圖片，以及 PNG/JPEG 輸出。很適合人像、產品構圖和更寬的落地頁視覺。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 10 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 10 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
imageSize	select	否	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	否	png	-	png, jpeg

GPT Image 2

gpt-image-2API 可呼叫部分可用：需要 Files API

圖片 · OpenAI 在 Rivya 上較新的 GPT Image 模型，支援 text-to-image、image-to-image、最多 16 張參考圖片，以及清楚的 1K / 2K / 4K 點數層級。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image · 16 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 為 GPT Image 2 image-to-image 任務上傳最多 16 張圖片參考。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	auto, 1:1, 9:16, 16:9, 4:3, 3:4
resolution	select	否	1K	-	1K, 2K, 4K

GPT Image 1.5

gpt-image-1-5API 可呼叫部分可用：需要 Files API

圖片 · OpenAI 的圖片模型，具備中等/高品質兩個品質層級，並支援最多 16 張參考圖片。擅長遵循複雜指令，並渲染空間關係準確的連貫場景。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

參考素材

image · 16 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 為圖片專案上傳最多 16 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
quality	select	否	medium	-	medium, high
aspect_ratio	select	否	1:1	-	1:1, 2:3, 3:2

4o Image

4o-imageAPI 可呼叫文字輸入可用

圖片 · OpenAI 的 4o Image 模型現在已在 Rivya 作為專用文生圖路徑提供。目前頁面設定刻意保持精簡：提示詞加上 3 種支援比例，並以固定每張圖片 3 點數計價。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
size	select	否	1:1	-	1:1, 3:2, 2:3

Seedream 5.0 Lite

seedream-5-liteAPI 可呼叫部分可用：需要 Files API

圖片 · 字節跳動較輕量的 Seedream 圖片模型，文字轉圖片和圖片編輯共用同一套價格。它支援 8 種長寬比、最多 14 張參考圖片，目前每次執行花費 6 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

3000 字元

參考素材

image · 14 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案可上傳最多 14 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	否	basic	-	basic, high

Seedream 4.5

seedream-4-5API 可呼叫部分可用：需要 Files API

圖片 · 字節跳動的高階圖片模型，具備 2K/4K 品質級別、8 種長寬比，以及最多 14 張參考圖片。以電影感調色和豐富紋理細節見長，適合時尚和生活風格視覺。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

3000 字元

參考素材

image · 14 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案可上傳最多 14 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	否	basic	-	basic, high

Seedream 4.0

seedream-4-0API 可呼叫部分可用：需要 Files API

圖片 · Seedream 4.0 是 Rivya 上均衡的字節跳動圖片模型，適合文字轉圖片生成、參考圖編輯，以及需要明確輸出控制的專案。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 10 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: Seedream 4.0 編輯路徑可上傳最多 10 張圖片。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
image_size	select	否	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	否	1K	-	1K, 2K, 4K
max_images	number	否	1	min 1 / max 6 / step 1	-
seed	number	否	-	min 0 / max 2147483647 / step 1	-
nsfw_checker	select	否	false	-	false, true

Seedream 3.0

seedream-3-0API 可呼叫文字輸入可用

圖片 · Seedream 3.0 現在作為獨立舊版圖片模型回到 Rivya。它目前只保留公開文字轉圖片路徑，每次執行花費 5 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
guidance_scale	number	否	2.5	min 1 / max 10 / step 0.1	-
seed	number	否	-	min 0 / max 2147483647	-

Grok Imagine

grok-imagineAPI 可呼叫部分可用：需要 Files API

圖片 · xAI 的圖片模型，具備強烈創意詮釋能力和 5 種長寬比。單張圖片生成聚焦藝術表現和非傳統視覺風格。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 為圖片專案上傳最多 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16
enable_pro	select	否	false	-	false, true

Flux 2 Pro

flux-2-proAPI 可呼叫部分可用：需要 Files API

圖片 · Black Forest Labs 的 320 億參數旗艦模型。支援文生圖和圖生圖，最多 8 張參考圖、2K 解析度，以及精準的圖片內文字渲染，專為產品攝影和品牌視覺打造。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 8 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 可為圖片專案上傳最多 8 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	否	1K	-	1K, 2K

Flux 2 Flex

flux-2-flexAPI 可呼叫部分可用：需要 Files API

圖片 · Flux 2 系列中偏向編輯的變體。它擅長結構調整和風格轉換，最多支援 8 張參考圖與 2K 解析度，適合在既有視覺上反覆迭代。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 8 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 可為圖片專案上傳最多 8 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
resolution	select	否	1K	-	1K, 2K

Flux Kontext Max

flux-kontext-maxAPI 可呼叫部分可用：需要 Files API

圖片 · Black Forest Labs 強化版 Flux Kontext 模型，面向更高要求的提示詞生成和圖片編輯任務。Rivya 目前將文生圖和圖生圖保留在同一個非同步專案中，並依平台現行政策固定以每次 8 點數計價。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選浮水印文字"
  }
}

參考素材規則

參考圖片: 可為圖片編輯專案上傳最多 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	否	jpeg	-	jpeg, png
enableTranslation	select	否	true	-	true, false
promptUpsampling	select	否	false	-	false, true
safetyTolerance	number	否	2	min 0 / max 6	-
watermark	text	否	-	-	-

Flux Kontext Pro

flux-kontext-proAPI 可呼叫部分可用：需要 Files API

圖片 · Black Forest Labs 較低成本的 Flux Kontext 專案，適合文生圖和單圖編輯。Rivya 目前在同一個非同步圖片專案中公開文生圖與圖生圖，並依現行平台定價政策，兩種模式皆採固定 4 點數計價。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選浮水印文字"
  }
}

參考素材規則

參考圖片: 可為圖片編輯專案上傳最多 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
outputFormat	select	否	jpeg	-	jpeg, png
enableTranslation	select	否	true	-	true, false
promptUpsampling	select	否	false	-	false, true
safetyTolerance	number	否	2	min 0 / max 6	-
watermark	text	否	-	-	-

Qwen2 Image

qwen2-imageAPI 可呼叫部分可用：需要 Files API

圖片 · 阿里巴巴的 Qwen2 圖片模型目前在 Rivya 上整合為一個固定價格圖片專案。它安全覆蓋文字轉圖片和圖片轉圖片，採用兩份公開文件都暴露的共同長寬比子集，並提供 PNG/JPEG 輸出、隨機種子重用和簡單 NSFW 開關。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

800 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
image_size	select	否	16:9	-	1:1, 3:4, 4:3, 9:16, 16:9
output_format	select	否	png	-	png, jpeg
seed	number	否	-	min 0	-
nsfw_checker	select	否	false	-	false, true

Qwen Image

qwen-imageAPI 可呼叫部分可用：需要 Files API

圖片 · 阿里巴巴 Qwen 系列的圖片模型，具備 HD 預設（方形、直向、橫向）和 PNG/JPEG 輸出。擅長中文提示詞和具文化細節的視覺生成。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
output_format	select	否	png	-	png, jpeg

Midjourney

midjourneyAPI 可呼叫部分可用：需要 Files API

圖片 · Midjourney 的 V7 圖像模型，支援文字轉圖片和圖片轉圖片，包含 Niji 動漫模式、3 種速度級別（Relaxed/Fast/Turbo）、風格參考，以及由 Omni Reference 驅動的一致性。它仍是電影感藝術、插畫和情緒板的標竿。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

2000 字元

參考素材

image · 4 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 4 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
speed	select	否	relaxed	-	relaxed, fast, turbo
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3
version	select	否	7	-	7, 6.1, 6, niji7, niji6

Recraft Remove Background

recraft-remove-backgroundAPI 可呼叫需要 Files API

圖片 · Recraft 在 Rivya 上的去背景模型，適合從一張既有圖片中分離主體。當下一步需要透明素材、乾淨去背圖，或沒有原始背景的來源圖片時，可以使用它。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

來源圖片: 請僅上傳 1 張圖片。主體邊緣越乾淨，去背結果通常越乾淨。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

不需要額外模型參數。

Recraft Crisp Upscale

recraft-crisp-upscaleAPI 可呼叫需要 Files API

圖片 · Recraft 在 Rivya 上的輕量圖片放大模型，適合對一張已確認的靜態圖片做低成本銳化和清晰度補強。當選定圖片只需要匯出前的便宜修飾，而不是更重的交付級放大時，可以使用它。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

來源圖片: 請僅上傳 1 張圖片。這個選項適合跑一輪快速、低成本的修飾。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

不需要額外模型參數。

Wan 2.7 Image Pro

wan-2-7-image-proAPI 可呼叫部分可用：需要 Files API

圖片 · 阿里巴巴較高階的 Wan 2.7 圖片模型，目前在 Rivya 上作為文字轉圖片和圖片編輯的獨立圖片入口。透過明確限制每次生成單張輸出圖片，價格固定為每次執行 12 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 9 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 上傳最多 9 個圖片檔案，用於圖片編輯專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	否	2K	-	1K, 2K
watermark	select	否	false	-	false, true
seed	number	否	-	min 0 / max 2147483647 / step 1	-

Wan 2.7 Image

wan-2-7-imageAPI 可呼叫部分可用：需要 Files API

圖片 · 阿里巴巴標準版 Wan 2.7 圖片模型在 Rivya 上作為自己的圖片入口，支援文字轉圖片和圖片編輯，目前每次執行需要 5 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 9 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 上傳最多 9 個圖片檔案，用於圖片編輯專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8
resolution	select	否	2K	-	1K, 2K
watermark	select	否	false	-	false, true
seed	number	否	-	min 0 / max 2147483647	-

Google Imagen4 Ultra

google-imagen4-ultraAPI 可呼叫文字輸入可用

圖片 · Google Imagen4 Ultra 是 Rivya 高階的 Imagen 文生圖檔位。它目前以固定 12 點數的單張圖片專案整合，提供公開的提示詞、反向提示詞、長寬比和種子值控制。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "可選：要避免的內容",
    "seed": "可選種子值"
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	否	-	-	-
seed	text	否	-	-	-

Google Imagen4

google-imagen4API 可呼叫文字輸入可用

圖片 · Google Imagen4 是 Rivya 標準的 Imagen 文生圖檔位。它目前以固定 8 點數的單張圖片專案整合，提供公開的提示詞、反向提示詞、長寬比和種子值控制。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "google-imagen4",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "可選：要避免的內容",
    "seed": "可選種子值"
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	1:1	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	否	-	-	-
seed	text	否	-	-	-

Google Imagen4 Fast

google-imagen4-fastAPI 可呼叫文字輸入可用

圖片 · Google Imagen4 Fast 是 Rivya 輕量級的 Imagen 文生圖檔位。它目前保留單張圖片專案，採固定 4 點數定價，並公開提示詞、反向提示詞、長寬比和種子值控制，不開放多圖輸出。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "google-imagen4-fast",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "16:9",
    "negative_prompt": "可選：要避免的內容",
    "seed": 0
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
aspect_ratio	select	否	16:9	-	1:1, 16:9, 9:16, 3:4, 4:3
negative_prompt	text	否	-	-	-
seed	number	否	-	min 0	-

Topaz Image Upscaler

topaz-image-upscaleAPI 可呼叫需要 Files API

圖片 · Topaz 在 Rivya 上的交付級圖片放大工具，適合已核准靜態圖需要真正提升尺寸時使用。當構圖已經定稿，剩下的問題是匯出解析度、審稿尺寸或印刷準備度時使用它。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

來源圖片: 上傳一張你想保留的已核准圖片。這個選項用於放大，不是創意重新編輯。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
upscale_factor	select	否	1	-	1, 2, 4, 8

Ideogram V3

ideogram-v3API 可呼叫文字輸入可用

圖片 · Ideogram V3 是 Rivya 的 text-to-image 模型，適合文字渲染、海報版式和設計優先的圖片提示詞。目前價格為 TURBO 4 點數、BALANCED 7 點數、QUALITY 10 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-image

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選的避免內容"
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
rendering_speed	select	否	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	否	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	否	true	-	true, false
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	否	-	min 0	-
negative_prompt	text	否	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframeAPI 可呼叫需要 Files API

圖片 · Ideogram V3 Reframe 目前在 Rivya 以單圖重構專案接入，並按渲染速度定價。目前價格為 TURBO 4 點數、BALANCED 7 點數、QUALITY 10 點數。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 為這個專案上傳剛好 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
rendering_speed	select	否	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	否	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	否	-	min 0	-

Ideogram V3 Remix

ideogram-v3-remixAPI 可呼叫需要 Files API

圖片 · Ideogram V3 Remix 目前在 Rivya 以單圖 remix 專案接入，並按渲染速度定價。目前價格為 TURBO 4 點數、BALANCED 7 點數、QUALITY 10 點數。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 為這個專案上傳剛好 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
rendering_speed	select	否	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	否	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN
expand_prompt	select	否	true	-	true, false
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	否	-	min 0	-
strength	number	否	0.8	min 0.01 / max 1	-
negative_prompt	text	否	-	-	-

Ideogram Character

ideogram-characterAPI 可呼叫需要 Files API

圖片 · 面向角色一致性的選項，可把一張已核准的角色圖片延展到新場景、服裝和格式。當身份保留比廣泛圖片編輯更重要，且一次只需要一張輸出圖片時使用它。

接入文件模型頁面

基礎點數

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

角色參考圖片: 上傳 1 張清楚的角色參考圖片。這個選項會忽略多餘圖片，並把輸出維持為單一結果。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
rendering_speed	select	否	BALANCED	-	TURBO, BALANCED, QUALITY
style	select	否	AUTO	-	AUTO, REALISTIC, FICTION
expand_prompt	select	否	true	-	true, false
image_size	select	否	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
seed	number	否	-	min 0	-
negative_prompt	text	否	-	-	-

Seedance 2.0

seedance-2API 可呼叫文字輸入可用

影片 · 字節跳動完整的 Seedance 2.0 影片模型，明確支援純提示詞生成、畫面驅動動畫和多模態參考生成。Rivya 保持文件中的角色拆分清楚可見，讓畫面輸入和多模態參考彼此互斥，而不是混成一個模糊的上傳區。

接入文件模型頁面

基礎點數

175

支援模式

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

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

2500 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
seedance_scene	select	否	text	-	text, frames, reference
resolution	select	否	720p	-	480p, 720p
aspect_ratio	select	否	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	否	5	min 4 / max 15	-
generate_audio	select	否	true	-	true, false
return_last_frame	select	否	false	-	false, true
web_search	select	否	false	-	false, true
nsfw_checker	select	否	false	-	false, true

Seedance 2.0 Fast

seedance-2-fastAPI 可呼叫文字輸入可用

影片 · 字節跳動更快的 Seedance 2.0 影片模型，具備完整場景路由，可用於純提示詞生成、畫面驅動的圖片動畫，以及多模態參考影片生成。Rivya 保持文件中的場景拆分清楚可見，避免首幀/尾幀輸入與參考圖片、影片和音訊角色混淆。

接入文件模型頁面

基礎點數

140

支援模式

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

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

2500 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
seedance_scene	select	否	text	-	text, frames, reference
resolution	select	否	720p	-	480p, 720p
aspect_ratio	select	否	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive
duration	number	否	5	min 4 / max 15	-
generate_audio	select	否	true	-	true, false
return_last_frame	select	否	false	-	false, true
web_search	select	否	false	-	false, true
nsfw_checker	select	否	false	-	false, true

Seedance 1.5 Pro

seedance-1-5-proAPI 可呼叫部分可用：需要 Files API

影片 · 字節跳動的旗艦影片模型，支援文字轉影片和圖片轉影片，並具備原生音畫同步。480p-1080p、4-12 秒片段、6 種長寬比、動態/固定鏡頭控制、可選音訊生成，以及唇形同步支援。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

2500 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案可上傳最多 2 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	480p, 720p, 1080p
duration	select	否	8	-	4, 8, 12
generate_audio	select	否	false	-	false, true
aspectRatio	select	否	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9
fixed_lens	select	否	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-proAPI 可呼叫部分可用：需要 Files API

影片 · 字節跳動的 Seedance 1.0 Pro 模型，在 Rivya 上作為標準 1.0 Pro 選項，同時支援文字轉影片和圖片轉影片。它讓目前頁面設定與公開 V1 Pro 文件保持一致，提供解析度、時長、鏡頭鎖定、隨機種子和安全檢查控制。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

10000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片轉影片執行可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	480p, 720p, 1080p
duration	select	否	5	-	5, 10
aspect_ratio	select	否	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16
camera_fixed	select	否	false	-	false, true
seed	number	否	-1	min -1 / max 2147483647	-
enable_safety_checker	select	否	true	-	true, false

Seedance 1.0 Pro Fast

seedance-1-0-pro-fastAPI 可呼叫需要 Files API

影片 · 字節跳動的快速圖生影片模型。可將單張參考圖片動畫化為 720p/1080p 的 5 秒或 10 秒片段，當你需要快速從靜態圖得到影片時，它為速度最佳化。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

10000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 上傳 1 張來源圖片，將它動畫化為影片。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	720p, 1080p
duration	select	否	5	-	5, 10

Seedance 1.0 Lite

seedance-1-0-liteAPI 可呼叫部分可用：需要 Files API

影片 · 字節跳動的 Seedance 1.0 Lite 模型在 Rivya 上作為較輕量的 1.0 選項，同時支援文字轉影片和圖片轉影片。它遵循公開 V1 Lite 參數集，目前使用比 Seedance 1.0 Pro 更低的價格級距。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

10000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片轉影片可上傳 1 張來源圖片；如果也想提供可選尾幀，則上傳 2 張圖片。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	480p, 720p, 1080p
duration	select	否	5	-	5, 10
aspect_ratio	select	否	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16, 9:21
camera_fixed	select	否	false	-	false, true
seed	number	否	-1	min -1 / max 2147483647	-
enable_safety_checker	select	否	true	-	true, false

HappyHorse 1.0

happyhorse-1-0API 可呼叫部分可用：需要 Files API

影片 · Rivya 上靈活的 AI 影片模型，可從同一個公開模型頁處理 text-to-video、單張圖片動態、多圖參考影片，以及影片編輯。

接入文件模型頁面

基礎點數

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image, video · 10 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考媒體: 未附加影片時最多使用 9 張圖片；影片編輯時使用 1 段影片，並可搭配最多 5 張圖片參考。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	1080p	-	720p, 1080p
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
duration	number	否	5	min 3 / max 15	-
audio_setting	select	否	auto	-	auto, origin
seed	number	否	0	min 0 / max 2147483647	-

Wan 2.7 Video

wan-2-7-videoAPI 可呼叫部分可用：需要 Files API

影片 · 阿里巴巴較新的 Wan 影片系列，依解析度與時長計費。Rivya 目前在同一個模型位置開放文字轉影片、圖片轉影片和影片編輯，5s 720p 從 80 點數起。

接入文件模型頁面

基礎點數

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image, video · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選的排除項或要避免的失敗模式。",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

參考素材規則

參考媒體: 上傳最多 2 個素材。圖片轉影片可使用最多 2 張圖片；影片編輯可使用 1 段影片加 1 張可選圖片。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	720p, 1080p
duration	select	否	5	-	5, 10, 15
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4
negative_prompt	text	否	-	-	-
prompt_extend	select	否	true	-	true, false
watermark	select	否	false	-	false, true
audio_setting	select	否	auto	-	auto, origin
seed	number	否	-	min 0 / max 2147483647	-

Wan 2.6

wan-2-6API 可呼叫部分可用：需要 Files API

影片 · 阿里巴巴在 Rivya 上的三模式 Wan 選項：文字轉影片、圖片轉影片和來源影片編輯都在同一個專案中。它支援 720p/1080p、5 到 15 秒片段，並且一次使用一張圖片或一段來源影片。

接入文件模型頁面

基礎點數

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image, video · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考媒體: 上傳最多 1 個圖片 / 影片檔案，用於圖片 / 影片專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	720p, 1080p
duration	select	否	5	-	5, 10, 15

Wan 2.5 Video

wan-2-5-videoAPI 可呼叫部分可用：需要 Files API

影片 · Wan 2.5 目前在 Rivya 上作為文字轉影片和圖片轉影片的共用入口。現行價格為 `720p_5 = 60`、`720p_10 = 120`、`1080p_5 = 100`、`1080p_10 = 200` 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選的排除項或要避免的失敗模式。",
    "nsfw_checker": "false"
  }
}

參考素材規則

參考圖片: 上傳最多 1 個圖片檔案，用於圖片轉影片模式。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	720p, 1080p
duration	select	否	5	-	5, 10
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1
enable_prompt_expansion	select	否	false	-	false, true
seed	number	否	-	min 0 / max 2147483647	-
negative_prompt	text	否	-	-	-
nsfw_checker	select	否	false	-	false, true

Wan 2.2 A14B Turbo

wan-2-2-a14b-turboAPI 可呼叫部分可用：需要 Files API

影片 · Wan 2.2 A14B Turbo 目前在 Rivya 上同時涵蓋文字轉影片、圖片轉影片，以及由一張圖片加一段音訊驅動的影片路徑。現行價格為文字或圖片生成 `480p = 8`、`720p = 12`，圖片加音訊驅動時為 `480p = 16`、`580p = 20`、`720p = 24`。

接入文件模型頁面

基礎點數

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選的排除項或要避免的失敗模式。",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

參考素材規則

參考媒體: 上傳最多 2 個素材。文字模式不需要素材，圖片轉影片使用 1 張圖片，圖片加音訊驅動路徑使用 1 張圖片加 1 段音訊。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	480p, 580p, 720p
aspect_ratio	select	否	16:9	-	16:9, 9:16
enable_prompt_expansion	select	否	false	-	false, true
seed	number	否	-	min 0 / max 2147483647	-
acceleration	select	否	none	-	none, regular
num_frames	number	否	80	min 40 / max 120 / step 1	-
frames_per_second	number	否	16	min 4 / max 60 / step 1	-
negative_prompt	text	否	-	-	-
num_inference_steps	number	否	27	min 2 / max 40 / step 1	-
guidance_scale	number	否	3.5	min 1 / max 10 / step 0.1	-
shift	number	否	5	min 1 / max 10 / step 0.1	-
enable_safety_checker	select	否	true	-	true, false

Wan Animate Replace

wan-2-2-animate-replaceAPI 可呼叫URL 輸入可用

影片 · Wan 在 Rivya 上的角色替換影片模型，用於替換既有片段中出現的人物或主體。當動作已經正確、只需要改變可見主體時，使用一個公開來源影片 URL、一個公開替換圖片 URL 和一個解析度級別即可。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

URL 輸入可用

輸入類型

url

Prompt 上限

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型支援透過模型參數傳入公開 URL。

參數

key	類型	必填	預設值	範圍	選項
video_url	text	否	-	-	-
image_url	text	否	-	-	-
resolution	select	否	480p	-	480p, 580p, 720p

Hailuo 2.3

hailuo-2-3API 可呼叫需要 Files API

影片 · MiniMax 的 image-to-video 模型，具備 Standard/Pro 品質層級、768P/1080P 解析度，以及 6 秒或 10 秒短片。以從靜態圖片產生更順暢動作和自然轉場而聞名。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 為圖片專案上傳最多 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
quality	select	否	standard	-	standard, pro
resolution	select	否	768P	-	768P, 1080P
duration	select	否	6	-	6, 10

Hailuo Pro

hailuo-proAPI 可呼叫部分可用：需要 Files API

影片 · MiniMax 較舊的 Hailuo Pro 影片模型在這裡以固定 Pro 層級接入，同時支援文字轉影片和圖片轉影片。圖片模式接受 1 或 2 張參考圖片，第二張圖片會作為尾幀使用，目前每次生成消耗 57 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

1500 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片模式接受最多 2 張圖片，第二張圖片會成為尾幀。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
prompt_optimizer	select	否	false	-	false, true

Hailuo Standard

hailuo-standardAPI 可呼叫部分可用：需要 Files API

影片 · MiniMax 較舊的 Hailuo Standard 影片模型，在這裡統一作為同時支援文字轉影片和圖片轉影片的一個模型。圖片模式接受 1 或 2 張參考圖片，第二張圖片會作為尾幀使用，目前已驗證的公開價格層級為 12 到 50 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

1500 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片模式接受最多 2 張圖片，第二張圖片會成為尾幀。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	6	-	6, 10
resolution	select	否	512P	-	512P, 768P
prompt_optimizer	select	否	false	-	false, true

Kling 3.0

kling-3-0API 可呼叫部分可用：需要 Files API

影片 · 快手的高階影片模型，支援文生影片與圖生影片，提供 Standard (720P) / Pro (1080P) 級別、單鏡頭或多鏡頭結構、3-15 秒時長、可選音訊生成，以及最多 2 張參考圖。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

2000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考素材: 圖生影片專案總共最多可上傳 2 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
mode	select	否	pro	-	std, pro
multi_shots	select	否	false	-	false, true
duration	select	否	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
sound	select	否	false	-	false, true
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1

Kling 3.0 motion-control

kling-3-0-motion-controlAPI 可呼叫需要 Files API

影片 · 更新一代的 Kling motion-control 選項，可用一張參考圖加一段動作影片驅動單一主體，並明確選擇背景來源。當你需要動作遷移，同時也想更強地控制場景應來自影片或圖片時，適合使用它。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

2500 字元

參考素材

image, video · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖 + 動作影片: 請上傳剛好 1 張角色圖和 1 段動作片段。當你需要同時控制朝向和背景來源時，使用 3.0。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
mode	select	否	pro	-	std, pro
character_orientation	select	否	video	-	video, image
background_source	select	否	input_video	-	input_video, input_image

Kling 2.6

kling-2-6API 可呼叫部分可用：需要 Files API

影片 · 快手的影片模型，支援可選音訊生成、5 秒 / 10 秒片段和 3 種長寬比。擅長人物動作和富有表現力的角色動畫，並具備自然的物理效果。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

1000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖像專案最多可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
sound	select	否	false	-	false, true
aspect_ratio	select	否	1:1	-	1:1, 16:9, 9:16

Kling 2.6 motion-control

kling-2-6-motion-controlAPI 可呼叫需要 Files API

影片 · 這是專為動作遷移設計的專案，可用一張參考圖加一段動作影片驅動單一主體。當你想用較低成本完成 Kling motion-control 測試，且不需要 Kling 3.0 motion-control 額外的場景控制時，適合使用它。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

2500 字元

參考素材

image, video · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖 + 動作影片: 請上傳剛好 1 張角色圖和 1 段動作片段。兩者都應清楚呈現頭部、肩膀和軀幹。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
mode	select	否	720p	-	720p, 1080p
character_orientation	select	否	video	-	video, image

Kling V2.5 Turbo Pro

kling-v2-5-turbo-proAPI 可呼叫部分可用：需要 Files API

影片 · 快手的 Kling V2.5 Turbo Pro 影片模型，現在同時支援文字轉影片和圖片轉影片。公開價格證據清楚涵蓋文字和圖片兩種 5 秒與 10 秒級別，因此 Rivya 直接映射為 42 / 84 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

2500 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "描述影片應避免的內容",
    "cfg_scale": 0.5
  }
}

參考素材規則

參考圖片: 可選上傳最多 2 張圖片以切換到圖片轉影片模式；第二張圖片會映射到尾幀。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	否	-	-	-
cfg_scale	number	否	0.5	min 0 / max 1	-

Kling V2.1 Master

kling-v2-1-masterAPI 可呼叫部分可用：需要 Files API

影片 · 快手較舊的 Kling V2.1 Master 影片模型現在在 Rivya 上同時支援文生影片和圖生影片。目前價格為 5 秒 160 點數，10 秒 320 點數。

接入文件模型頁面

基礎點數

160

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "描述影片應避免的內容",
    "cfg_scale": 0.5
  }
}

參考素材規則

參考圖片: 可選上傳一張圖片以切換到圖生影片模式；留空則保持文字模式。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1
negative_prompt	text	否	-	-	-
cfg_scale	number	否	0.5	min 0 / max 1	-

Kling V2.1 Pro

kling-v2-1-proAPI 可呼叫需要 Files API

影片 · 快手較舊的 Kling V2.1 Pro 圖生影片模型支援首幀加可選尾幀圖片。目前價格為 5 秒 50 點數，10 秒 100 點數。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 圖片模式最多接受 2 個圖片檔案，第二張圖片會映射到尾幀。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
negative_prompt	text	否	-	-	-
cfg_scale	number	否	0.5	min 0 / max 1	-

Kling V2.1 Standard

kling-v2-1-standardAPI 可呼叫需要 Files API

影片 · 快手較舊的 Kling V2.1 Standard 圖生影片模型。目前價格為 5 秒 25 點數，10 秒 50 點數。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

參考圖片: 圖片模式最多接受 1 個圖片檔案作為第一幀。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
negative_prompt	text	否	-	-	-
cfg_scale	number	否	0.5	min 0 / max 1	-

Kling AI Avatar Pro

kling-ai-avatar-proAPI 可呼叫需要 Files API

影片 · 快手的 Kling AI Avatar Pro 高品質說話頭像模型，使用一張人物肖像加一段音訊生成口型同步的頭像影片。Rivya 目前以固定每次生成 16 點數計價。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

人物肖像與音訊: 上傳一張人物肖像和一段音訊。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

不需要額外模型參數。

Kling AI Avatar Standard

kling-ai-avatar-standardAPI 可呼叫需要 Files API

影片 · 快手的 Kling AI Avatar Standard 說話頭像模型，使用一張人物肖像加一段音訊生成口型同步的頭像影片。Rivya 目前以固定每次生成 8 點數計價。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

人物肖像與音訊: 上傳一張人物肖像和一段音訊。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

不需要額外模型參數。

Infinitalk

infinitalkAPI 可呼叫需要 Files API

影片 · Infinitalk 是一款以人物肖像和音訊驅動的說話影片模型。目前費用按解析度和音訊時長計算：480p = 每秒 3 點數，720p = 每秒 12 點數。

接入文件模型頁面

基礎點數

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

人物肖像與音訊: 上傳一張人物肖像和一段音訊。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
resolution	select	否	480p	-	480p, 720p
seed	number	否	-	min 10000 / max 1000000	-

Runway

runwayAPI 可呼叫部分可用：需要 Files API

影片 · Runway 是一個獨立影片模型，同時支援文字轉影片和圖片轉影片。公開價格證據目前只確認 6 個生成級別，因此 Rivya 保持在已驗證集合：`720p_5 = 12`、`720p_10 = 30`、`1080p_5 = 30`。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

1800 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "runway",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "duration": "5",
    "quality": "720p",
    "aspectRatio": "16:9",
    "waterMark": "留空即可停用水印"
  }
}

參考素材規則

參考圖片: 可選上傳一張圖片以切換到圖片轉影片模式；留空則維持文字模式。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
duration	select	否	5	-	5, 10
quality	select	否	720p	-	720p, 1080p
aspectRatio	select	否	16:9	-	16:9, 4:3, 1:1, 3:4, 9:16
waterMark	text	否	-	-	-

Runway Aleph

runway-alephAPI 可呼叫需要 Files API

影片 · 面向來源影片轉換的專案，可將既有片段改寫成新的視覺結果。當動作來自你的輸入素材、創意方向由提示詞決定，且需要固定 90 點數價格時，請使用 Aleph。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

video, image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

輸入素材: 上傳你希望 Aleph 轉換的來源片段。只有在需要額外風格或主體引導時，才加入一張可選靜態圖片。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9
waterMark	text	否	-	-	-
seed	number	否	-	min 0 / max 2147483647	-

Luma Modify Video

luma-modify-videoAPI 可呼叫需要 Files API

影片 · 獨立的來源影片改寫專案，用於將一段現有片段推向新的視覺方向。當提示詞應轉化素材本身，而不只是讓匯出結果更清晰時，適合使用它。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

video · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

輸入影片: 上傳一段你想轉化的短來源片段。這個選項會改寫素材，而不是單純增強素材。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
watermark	text	否	-	-	-

Grok Imagine Video

grok-imagine-videoAPI 可呼叫部分可用：需要 Files API

影片 · xAI 的影片模型，具備 Fun/Normal/Spicy 創意模式和 5 種長寬比。以獨特風格預設對應不同創意調性，從玩味、電影感到更前衛的方向都能覆蓋。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 為圖片專案上傳最多 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
mode	select	否	normal	-	fun, normal, spicy
duration	number	否	6	min 6 / max 30 / step 1	-
resolution	select	否	480p	-	480p, 720p
aspect_ratio	select	否	2:3	-	1:1, 16:9, 9:16, 2:3, 3:2

Sora 2 Pro

sora-2-proAPI 可呼叫部分可用：需要 Files API

影片 · Sora 2 的高階級別，具備標準/高品質模式、10 秒/15 秒片段，以及水印移除。細節、光線和動作保真度更強，適合專業影片製作。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

10000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
size	select	否	-	-	standard, high
n_frames	select	否	10	-	10, 15
aspect_ratio	select	否	landscape	-	landscape, portrait
remove_watermark	select	否	false	-	false, true
upload_method	select	否	s3	-	s3, oss

Sora 2

sora-2API 可呼叫部分可用：需要 Files API

影片 · OpenAI 的影片模型，支援文字轉影片和圖片轉影片，具備真實世界模擬、同步音訊、10 秒/15 秒片段、橫向/直向輸出，以及可選水印移除。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

10000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片專案最多可上傳 1 個圖片檔案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
n_frames	select	否	10	-	10, 15
aspect_ratio	select	否	landscape	-	landscape, portrait
remove_watermark	select	否	false	-	false, true
upload_method	select	否	s3	-	s3, oss

Sora Watermark Remover

sora-watermark-removerAPI 可呼叫URL 輸入可用

影片 · Sora 在 Rivya 上的水印移除後處理模型，適用於已完成的公開 Sora 分享連結。請在影片本身已完成、剩餘工作只是移除水印並選擇 S3 或 OSS 交付時使用它。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

URL 輸入可用

輸入類型

url

Prompt 上限

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型支援透過模型參數傳入公開 URL。

參數

key	類型	必填	預設值	範圍	選項
video_url	text	是	-	-	-
upload_method	select	是	s3	-	s3, oss

Topaz Video Upscaler

topaz-video-upscaleAPI 可呼叫需要 Files API

影片 · Topaz 在 Rivya 上的交付級影片放大工具，適合已核准片段只需要在匯出時提升清晰度時使用。當鏡頭、動作和節奏都已經正確，剩下的問題是解析度或最終檔案銳利度時使用它。

接入文件模型頁面

基礎點數

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

video · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

來源影片: 上傳一段你想保留的來源片段。這個選項改善交付清晰度，而不是改變鏡頭。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

key	類型	必填	預設值	範圍	選項
upscale_factor	select	否	2	-	1, 2, 4

Veo3.1 Quality

veo3-1-qualityAPI 可呼叫部分可用：需要 Files API

影片 · Google Veo 3.1 的品質優先變體，適合高階文字轉影片和圖片引導生成。更高保真的畫面、更強的動作真實感，以及預設背景音訊，使它成為 Rivya 上更高階的 Veo 選項。

接入文件模型頁面

基礎點數

150

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "veo3-1-quality",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "可選水印文字",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 上傳最多 2 個圖片檔案，用於目前支援的圖片引導專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	16:9	-	16:9, 9:16, Auto
watermark	text	否	-	-	-
seeds	number	否	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	否	true	-	true, false

Veo3.1 Fast

veo3-1-fastAPI 可呼叫部分可用：需要 Files API

影片 · Google Veo 3.1 的快速變體，支援三種模式：文字轉影片、圖片轉影片、參考圖轉影片。最多 3 張參考圖、原生音訊，以及依模式調整的長寬比控制，讓它適合快速製作電影感短片。

接入文件模型頁面

基礎點數

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 3 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選水印文字",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 上傳最多 3 個圖片檔案，用於圖片和參考圖驅動的專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
generationType	select	否	FIRST_AND_LAST_FRAMES_2_VIDEO	-	FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	否	16:9	-	16:9, 9:16, Auto
watermark	text	否	-	-	-
seeds	number	否	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	否	true	-	true, false

Veo3.1 Lite

veo3-1-liteAPI 可呼叫部分可用：需要 Files API

影片 · Google Veo 3.1 的最低成本變體。Rivya 目前只開放最小穩定子集：文字轉影片和圖片轉影片，固定每次生成 `10` 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "veo3-1-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "可選水印文字",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 上傳最多 2 個圖片檔案，用於目前支援的圖片驅動專案。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Prompt 或 URL 模式可能已經可呼叫；參考素材模式仍需要 Files API 上傳支援。 Files API

參數

key	類型	必填	預設值	範圍	選項
aspectRatio	select	否	16:9	-	16:9, 9:16, Auto
watermark	text	否	-	-	-
seeds	number	否	-	min 10000 / max 99999 / step 1	-
enableTranslation	select	否	true	-	true, false

Suno Music

suno-musicAPI 可呼叫文字輸入可用

音訊 · Suno Music 是 Rivya 的文字轉音樂模型，可將一段簡短需求轉成有人聲或純音樂的第一版歌曲草稿。它保留固定 `12` 點數入口，並在音軌成功生成後提供 `Extend Music` 作為下一步。

接入文件模型頁面

基礎點數

支援模式

text-to-audio

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

500 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
model	select	否	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5
instrumental	select	否	false	-	false, true

Suno Sounds

suno-soundsAPI 可呼叫文字輸入可用

音訊 · Suno Sounds 是 Rivya 的輕量文字轉聲音模型，適合環境聲循環、背景音和短聲音草稿。它保留已記錄的固定價格：每次生成 `3` 點數，並允許成功結果繼續進入 `Vocal Separation`。

接入文件模型頁面

基礎點數

支援模式

text-to-audio

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

500 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
model	select	否	V5	-	V5, V5_5
soundLoop	select	否	false	-	false, true
soundTempo	number	否	-	min 1 / max 300 / step 1	-
soundKey	select	否	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-lyricsAPI 可呼叫文字輸入可用

音訊 · Suno Lyrics 是 Rivya 的歌詞生成模型，可將一個主題或情緒轉成歌曲文字，每次請求固定花費 `1` 點數。

接入文件模型頁面

基礎點數

支援模式

text-to-audio

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

200 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

不需要額外模型參數。

ElevenLabs Dialogue V3

elevenlabs-dialogue-v3API 可呼叫文字輸入可用

音訊 · ElevenLabs 在 Rivya 上的多說話者對白模型。它為角色式語音生成而設計，支援個別語音分配、穩定性控制，以及適合 Podcast、訪談和角色場景的對白節奏。

接入文件模型頁面

基礎點數

支援模式

dialogue-to-audio

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
default_voice	select	否	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will
stability	select	否	0.5	-	0, 0.5, 1
language_code	text	否	-	-	-

ElevenLabs Turbo 2.5

elevenlabs-turbo-2-5API 可呼叫文字輸入可用

音訊 · ElevenLabs 在 Rivya 上的快速文本轉語音模型。它提供低延遲語音生成，並可調整穩定性、相似度、風格和速度，適合快速製作旁白草稿與互動式 TTS 專案。

接入文件模型頁面

基礎點數

支援模式

text-to-speech

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "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": "可選：上一段上下文",
    "next_text": "可選：下一段上下文",
    "language_code": "可選：如 en 或 zh"
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
voice	select	是	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	否	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	否	0.75	min 0 / max 1 / step 0.05	-
style	number	否	0	min 0 / max 1 / step 0.05	-
speed	number	否	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	否	false	-	false, true
previous_text	text	否	-	-	-
next_text	text	否	-	-	-
language_code	text	否	-	-	-

ElevenLabs Multilingual V2

elevenlabs-multilingual-v2API 可呼叫文字輸入可用

音訊 · ElevenLabs 在 Rivya 上的多語文本轉語音模型，支援約 30 種語言並可自動偵測。它更適合在地化、跨語言交付，以及更自然的多語 voiceover。

接入文件模型頁面

基礎點數

支援模式

text-to-speech

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
voice	select	是	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8
stability	number	否	0.5	min 0 / max 1 / step 0.05	-
similarity_boost	number	否	0.75	min 0 / max 1 / step 0.05	-
style	number	否	0	min 0 / max 1 / step 0.05	-
speed	number	否	1	min 0.7 / max 1.2 / step 0.05	-
timestamps	select	否	false	-	false, true
previous_text	text	否	-	-	-
next_text	text	否	-	-	-
language_code	text	否	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2API 可呼叫文字輸入可用

音訊 · ElevenLabs 在 Rivya 上的文本轉聲音模型，適合短音效、轉場和環境循環。可生成 0.5–22 秒音訊片段，並調整提示詞影響、循環模式和 19 種輸出格式，用於剪輯、產品或遊戲專案。

接入文件模型頁面

基礎點數

支援模式

text-to-audio

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

5000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

參數

key	類型	必填	預設值	範圍	選項
loop	select	否	false	-	false, true
duration_seconds	number	否	3	min 0.5 / max 22 / step 0.5	-
prompt_influence	number	否	0.3	min 0 / max 1 / step 0.05	-
output_format	select	否	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-isolationAPI 可呼叫需要 Files API

音訊 · ElevenLabs 在 Rivya 上的音訊清理與語音隔離模型。上傳一段錄音即可分離人聲、移除背景噪音，並在編輯或發布前清理 spoken audio。

接入文件模型頁面

基礎點數

支援模式

audio-to-audio

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

audio · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

這個模型不顯示可執行的 Public API 範例。

參考素材規則

來源音訊: 上傳一個音訊檔案，Rivya 會隔離並清理目標音軌。

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

基於文件的模式需要 /api/v1/files 完成後，才能顯示為完整 API-ready 範例。 Files API

參數

不需要額外模型參數。

GPT-5.5

gpt-5-5-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上的進階 GPT 對話模型，適合在任務簡報需要更多推理空間時處理複雜推理、圖像輔助分析、研究統整和結構化寫作。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.4

gpt-5-4-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上更高階的 AI 對話模型，具備更強的結構化輸入處理、推理控制和工具導向對話專案能力，適合更複雜的分析與寫作任務。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.4 Codex

gpt-5.4-codex-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上更高階的 Codex 模型，為要求較高的 repo 級開發專案提供更強的程式碼能力、結構化推理和工具導向協作。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.3 Codex

gpt-5-3-codex-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上最新、能力最強的 Codex 模型。它結合最先進的程式碼生成能力與更深入的代理式推理，適合最嚴苛的開發專案。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.2

gpt-5-2-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上的旗艦 AI 對話模型，具備進階推理、最多 6 張圖片的視覺支援，以及 20K 字元 context window。它是適合研究、規劃、寫作和圖片感知分析的強力通用 GPT 選項。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.2 Codex

gpt-5-2-codex-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上更進階的 Codex 模型，為複雜工程任務提供更強推理。它針對長週期代理式編碼、架構決策，以及單純程式碼生成不足以處理的大型重構進行最佳化。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5.1 Codex

gpt-5-1-codex-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上升級版的 Codex 模型，具備更高程式碼準確度，也為代理式編碼任務提供更強推理。它保留同一個長輸出、理解 repo 的專案，同時改善多文件重構和更安全的程式碼編修。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

GPT-5 Codex

gpt-5-codex-chatAPI 可呼叫文字輸入可用

對話 · OpenAI 在 Rivya 上的 GPT-5 Codex 程式碼專用模型，適合除錯、實作規劃、重構，以及支援視覺理解的技術問題求解。

接入文件模型頁面

基礎點數

支援模式

responses

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Gemini 3.1 Pro

gemini-3-1-pro-chatAPI 可呼叫文字輸入可用

對話 · Google 在 Rivya 上最新、能力最強的 Gemini AI 對話模型。具備頂級推理、視覺能力和指令遵循能力，是高要求分析與創意任務中最強的 Gemini 選項。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Gemini 3 Pro

gemini-3-pro-chatAPI 可呼叫文字輸入可用

對話 · Google 在 Rivya 上深度更高的 Gemini AI 對話模型。推理能力比 Gemini 2.5 Pro 更強，並支援視覺輸入，更適合研究綜整、技術寫作和更審慎的多模態分析。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Gemini 3 Flash

gemini-3-flash-chatAPI 可呼叫文字輸入可用

對話 · Google 在 Rivya 上的新一代快速 AI 對話模型。token 成本比 Gemini 2.5 Flash 更低，推理能力也更強，專為高用量多模態對話、截圖分流和快速助理工作打造。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Gemini 2.5 Pro

gemini-2-5-pro-chatAPI 可呼叫文字輸入可用

對話 · Google 在 Rivya 上更進階的 Gemini AI 對話模型。推理能力比 Flash 更強，支援視覺輸入和 20K context，適合研究綜整、文件分析和結構化寫作，每次使用 2 點數。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Gemini 2.5 Flash

gemini-2-5-flash-chatAPI 可呼叫文字輸入可用

對話 · Google 在 Rivya 上最快、也最實惠的 AI 對話模型。每次使用 1 點數，並支援最多 6 張圖片的視覺輸入，適合快速問答、初稿摘要、截圖分流和日常 AI 協助。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。圖片附件必須使用 Files API 回傳的 file_id。

參數

不需要額外模型參數。

Claude Opus 4.7

claude-opus-4-7-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的旗艦 Claude 聊天模型，適合深度推理、謹慎整合、主管寫作和高影響力文字工作。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Opus 4.6

claude-opus-4-6-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的旗艦 Claude AI 聊天模型。它為深度推理、複雜分析和高品質寫作而設計，適合要求高、風險高的專案。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Sonnet 4.6

claude-sonnet-4-6-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的均衡型 Claude AI 聊天模型。它保留強大的長文推理和謹慎分析，適合內容、研究和程式設計專案，同時不必直接跳到 Opus 層級的花費。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Opus 4.5

claude-opus-4-5-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的旗艦 Claude AI 聊天模型。它擅長深度推理、複雜分析和專家級寫作，是處理關鍵 AI 任務時的高階選擇。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Sonnet 4.5

claude-sonnet-4-5-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的均衡型 Claude AI 聊天模型。它擅長細膩寫作、謹慎分析和注重安全的回應，是內容創作和研究中很穩的 Claude 選項。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Haiku 4.5

claude-haiku-4-5-chatAPI 可呼叫文字輸入可用

聊天 · Anthropic 在 Rivya 上的輕量 Claude AI 聊天模型。它針對速度、成本效率和穩定的日常聊天表現調整，適合想要 Claude 語氣但不想使用高階方案成本的高頻專案。

接入文件模型頁面

基礎點數

支援模式

chat-completion

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

結果讀取

建立回應會回傳公開 task id。繼續輪詢 GET /api/v1/generations/{taskId}，直到狀態變為 succeeded 或 failed。

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

Chat API 在 Public API v1 中支援 non-streaming 和 SSE streaming 回合。這個 Chat 模型不支援圖片附件。

參數

不需要額外模型參數。

模型 API 參考

如何閱讀這份參考

Request Pattern

動態模型參考

搭配線上除錯器使用這份參考

Z-Image

請求體

參數

Nano Banana 2

請求體

參數

Nano Banana Pro

請求體

參數

Nano Banana

請求體

參數

GPT Image 2

請求體

參數

GPT Image 1.5

請求體

參數

4o Image

請求體

參數

Seedream 5.0 Lite

請求體

參數

Seedream 4.5

請求體

參數

Seedream 4.0

請求體

參數

Seedream 3.0

請求體

參數

Grok Imagine

請求體

參數

Flux 2 Pro

請求體

參數

Flux 2 Flex

請求體

參數

Flux Kontext Max

請求體

參數

Flux Kontext Pro

請求體

參數

Qwen2 Image

請求體

參數

Qwen Image

請求體

參數

Midjourney

請求體

參數

Recraft Remove Background

請求體

參數

Recraft Crisp Upscale

請求體

參數

Wan 2.7 Image Pro

請求體

參數

Wan 2.7 Image

請求體

參數

Google Imagen4 Ultra

請求體

參數

Google Imagen4

請求體

參數