查詢 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 上傳參考媒體。
對於全部五個 Image5 模型，請保留原始模型綁定 Files API 回應中的 width、height、size_bytes 和 image_dimensions_token，並分別以 width、height、sizeBytes 和 imageDimensionsToken 傳送；token 缺失或過期時請重新上傳。Layer Decomposition 還要求恰好一張圖片，且圖片必須符合文件所述的幾何限制。
Grok Imagine Image 2.0 對標準圖片編輯使用的 1–5 張參考圖片，採用相同的已簽名圖片欄位。只有提示詞的請求會使用文字轉圖片；加入已簽名參考圖片後會切換為圖片編輯。auto 僅供圖片編輯使用，Segment Map 與 Segment Edit 仍不可用。
對於 Video8 影片參考，請保留 duration_seconds、duration_token、video_width、video_height、frames_per_second、video_bitrate_mbps、video_file_size_bytes 和 video_metadata_token。請分別以 durationSeconds、durationToken、width、height、framesPerSecond、videoBitrateMbps、sizeBytes 和 videoMetadataToken 傳送；任一已簽名 token 缺失或過期時，請重新上傳。
Wan 3.0 提供互斥的文字、首/尾影格與多模態參考場景，並支援 Standard 或 Prime、480P/720P/1080P、六種長寬比、明確指定的 2–30 秒或智慧播放時間、生成音訊與 seed。圖片使用已簽名的 MIME 類型、尺寸與檔案位元組大小；影片還需要已簽名的播放時間與影片 metadata；音訊播放時間 token 則綁定 MIME 類型與檔案位元組大小。智慧播放時間會預留 30 秒，且不可與參考影片一起使用。檔案轉影片與連結轉影片捷徑仍不可用。
模型專屬 Files API 限制比檔案類型的一般預設值更嚴格。上傳時請使用目標模型 ID，讓不支援的類型、MIME 類型、位元組大小、播放時間、尺寸、影格率和位元率能在預留點數前失敗。
對於聊天模型，請閱讀 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。

動態模型參考

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

先從快速入門確認呼叫流程，再在這裡核對模型欄位，最後到開發者除錯器執行模擬流程或登入後的真實請求。

API 快速入門線上除錯器

Z-Image

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

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

接入文件模型頁面

基礎點數

per_image · default=0.8 · ⌈total⌉

支援模式

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

圖片 · Nano Banana 2 是 Rivya 較新的 Nano Banana 圖片模型，適合品牌視覺、產品圖片和參考圖主導的創意草稿，尤其是當你想要比基礎級別更當前的 Google 圖片路徑時。

接入文件模型頁面

基礎點數

per_image · 1K=5 · 2K=8 · 4K=12 · ⌈total⌉

支援模式

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

參考素材規則

參考圖片: 圖片專案最多可上傳 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

Nano Banana Pro

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

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

接入文件模型頁面

基礎點數

per_image · 1K=8 · 2K=8 · 4K=14 · ⌈total⌉

支援模式

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 輸出。很適合人像、產品構圖和更寬的登陸頁視覺。

接入文件模型頁面

基礎點數

per_request · text_to_image=3 · image_to_image=3 · ⌈total⌉

支援模式

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 點數層級。

接入文件模型頁面

基礎點數

per_image · 1K=3 · 2K=5 · 4K=8 · ⌈total⌉

支援模式

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 張參考圖片。擅長遵循複雜指令，並渲染空間關係準確的連貫場景。

接入文件模型頁面

基礎點數

per_image · medium=4 · high=22 · ⌈total⌉

支援模式

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 點數計價。

接入文件模型頁面

基礎點數

per_request · text_to_image=3 · ⌈total⌉

支援模式

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 點數。

接入文件模型頁面

基礎點數

per_image · default=5.5 · ⌈total⌉

支援模式

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",
    "output_format": "png",
    "nsfw_checker": "true"
  }
}

參考素材規則

參考圖片: 圖片專案可上傳最多 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, ultra
output_format	select	否	png	-	png, jpeg
nsfw_checker	select	否	true	-	false, true

Seedream 4.5

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

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

接入文件模型頁面

基礎點數

per_image · default=6.5 · ⌈total⌉

支援模式

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-0此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

圖片 · Seedream 4.0 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 10 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Seedream 3.0

seedream-3-0此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

圖片 · Seedream 3.0 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Grok Imagine

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

圖片 · xAI 的圖片模型，具備強烈創意詮釋能力和 5 種長寬比。標準文字請求會傳回 2 張圖，品質請求則傳回 4 張。

接入文件模型頁面

基礎點數

per_request · standard=4 · standard_output_images=2 · quality=5 · quality_output_images=4 · image_to_image=4 · ⌈total⌉

支援模式

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",
    "nsfw_checker": "false",
    "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
nsfw_checker	select	否	false	-	false, true
enable_pro	select	否	false	-	false, true

Flux 2 Pro

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

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

接入文件模型頁面

基礎點數

per_image · 1K=5 · 2K=7 · ⌈total⌉

支援模式

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",
    "nsfw_checker": "false"
  }
}

參考素材規則

參考圖片: 可為圖片專案上傳最多 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
nsfw_checker	select	否	false	-	false, true

Flux 2 Flex

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

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

接入文件模型頁面

基礎點數

per_image · 1K=14 · 2K=24 · ⌈total⌉

支援模式

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",
    "nsfw_checker": "false"
  }
}

參考素材規則

參考圖片: 可為圖片專案上傳最多 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
nsfw_checker	select	否	false	-	false, true

Flux Kontext Max

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

圖片 · BFL 目前將 FLUX.1 Kontext [max] 標為上一代，並建議新專案使用 FLUX.2。 Black Forest Labs 強化版 Flux Kontext 模型，適合要求較高、由提示詞引導的生成與圖片編輯。Rivya 在同一個模型頁面提供文生圖和圖生圖，固定每次執行 8 點數。

接入文件模型頁面

基礎點數

per_image · default=8 · ⌈total⌉

支援模式

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

圖片 · BFL 目前將 FLUX.1 Kontext [pro] 標示為上一代，並建議新專案使用 FLUX.2。 Black Forest Labs 較低成本的 Flux Kontext 模型，適合文生圖和單圖編輯。Rivya 在同一個模型頁面提供兩種模式，固定每次執行 4 點數。

接入文件模型頁面

基礎點數

per_image · default=4 · ⌈total⌉

支援模式

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 開關。

接入文件模型頁面

基礎點數

per_image · default=5.6 · ⌈total⌉

支援模式

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, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21: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 輸出。擅長中文提示詞和具文化細節的視覺生成。

接入文件模型頁面

基礎點數

per_output_megapixel · default=4 · ⌈total⌉

支援模式

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

midjourney此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

圖片 · Midjourney 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 4 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: Midjourney 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Recraft Remove Background

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

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

接入文件模型頁面

基礎點數

per_image · default=1 · ⌈total⌉

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源圖片: 僅上傳 1 張 JPG、PNG 或 WebP 圖片，最大 5 MB、16 MP，寬高皆須為 256–4096 px。

結果讀取

建立回應會回傳公開 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 上的輕量圖片放大模型，適合對一張已確認的靜態圖片做低成本銳化和清晰度補強。當選定圖片只需要匯出前的便宜修飾，而不是更重的交付級放大時，可以使用它。

接入文件模型頁面

基礎點數

per_image · default=0.5 · ⌈total⌉

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源圖片: 僅上傳 1 張 JPG、PNG 或 WebP 圖片，最大 10 MB。

結果讀取

建立回應會回傳公開 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

圖片 · 在 Rivya 上，Wan 2.7 Image Pro 目前支援文字轉圖片和圖片轉圖片。它也可以使用最多 9 張參考圖片。每張圖片固定 12 點數; 每次請求回傳一張圖片.

接入文件模型頁面

基礎點數

per_image · default=12 · ⌈total⌉

支援模式

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 個圖片檔案，用於圖片編輯專案。 JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

結果讀取

建立回應會回傳公開 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

圖片 · 在 Rivya 上，Wan 2.7 Image 目前支援文字轉圖片和圖片轉圖片。它也可以使用最多 9 張參考圖片。每張圖片固定 5 點數; 每次請求回傳一張圖片.

接入文件模型頁面

基礎點數

per_image · default=4.8 · ⌈total⌉

支援模式

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 個圖片檔案，用於圖片編輯專案。 JPEG / PNG / WebP · ≤ 10 MB · ≥ 240 × 240 px.

結果讀取

建立回應會回傳公開 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 點數的單張圖片專案整合，提供公開的提示詞、反向提示詞、長寬比和種子值控制。

接入文件模型頁面

基礎點數

per_image · default=12 · ⌈total⌉

支援模式

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, auto
negative_prompt	text	否	-	-	-
seed	text	否	-	-	-

Google Imagen4

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

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

接入文件模型頁面

基礎點數

per_request · default=8 · ⌈total⌉

支援模式

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, auto
negative_prompt	text	否	-	-	-
seed	text	否	-	-	-

Google Imagen4 Fast

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

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

接入文件模型頁面

基礎點數

per_request · default=4 · ⌈total⌉

支援模式

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": 1
  }
}

參考素材規則

結果讀取

建立回應會回傳公開 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, auto
negative_prompt	text	否	-	-	-
seed	number	否	-	-	-

Topaz Image Upscaler

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

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

接入文件模型頁面

基礎點數

per_image · 2K=10 · 4K=20 · 8K=40 · ⌈total⌉

支援模式

image-to-image

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源圖片: 僅限 1 張 JPEG、PNG 或 WebP 圖片，最大 10 MB；輸出最長邊 ≤ 8192 px。

結果讀取

建立回應會回傳公開 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

Ideogram V3

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

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

接入文件模型頁面

基礎點數

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

支援模式

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": 1,
    "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	否	-	-	-
negative_prompt	text	否	-	-	-

Ideogram V3 Reframe

ideogram-v3-reframe此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

圖片 · Ideogram V3 Reframe 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: Ideogram V3 Reframe 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Ideogram V3 Remix

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

圖片 · Ideogram V3 Remix: 每張圖 TURBO 4 / BALANCED 7 / QUALITY 10 點數. 可選 1–4 張輸出。總價按單張價格乘以所選張數計算，並向上取整為整數點數。

接入文件模型頁面

基礎點數

per_image · TURBO=3.5 · BALANCED=7 · QUALITY=10 · ⌈total⌉

支援模式

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
num_images	select	否	1	-	1, 2, 3, 4
seed	number	否	-	-	-
strength	number	否	0.8	min 0.01 / max 1	-
negative_prompt	text	否	-	-	-

Ideogram Character

ideogram-characterAPI 可呼叫需要 Files API

圖片 · 面向角色一致性的選項，可把一張已核准的角色圖片延展到新場景、服裝和格式。當角色識別特徵比廣泛圖片編輯更重要，且一次只需要一張輸出圖片時使用它。每張圖 TURBO 12 / BALANCED 18 / QUALITY 24 點數. 可選 1–4 張輸出。總價按單張價格乘以所選張數計算，並向上取整為整數點數。

接入文件模型頁面

基礎點數

per_image · TURBO=12 · BALANCED=18 · QUALITY=24 · ⌈total⌉

支援模式

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
num_images	select	否	1	-	1, 2, 3, 4
seed	number	否	-	-	-
negative_prompt	text	否	-	-	-

Seedream 5.0 Pro

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

圖片 · Seedream 5.0 Pro 是 Rivya 的多參考圖圖片模型，適合製作行銷活動主畫面、編輯企劃場景與商品構圖。它支援文字轉圖片、圖片轉圖片、1K 或 2K 輸出，以及最多 10 張參考圖片。

接入文件模型頁面

基礎點數

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

支援模式

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-5-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false"
  }
}

參考素材規則

參考圖片: 最多上傳 10 張 JPEG、PNG 或 WebP 圖片，每張不超過 10 MB。

結果讀取

建立回應會回傳公開 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, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
quality	select	否	basic	-	basic, high
output_format	select	否	png	-	png, jpeg
nsfw_checker	select	否	false	-	false, true

Seedream 5.0 Pro Layer Decomposition

seedream-5-pro-layer-decompositionAPI 可呼叫需要 Files API

圖片 · Seedream 5.0 Pro 圖層拆解可將一張來源圖片分離為底圖與可重複使用的 PNG 圖層，並支援選用提示詞或邊界框引導，以及自動、1K、1.5K 或 2K 尺寸。

接入文件模型頁面

基礎點數

per_image · 1K=7 · 1.5K=7 · 2K=14 · auto_reserve=14 · ⌈total⌉

支援模式

image-to-layers

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源圖片: 請上傳恰好一張 PNG、JPEG、WebP、BMP、TIFF 或 GIF，大小不超過 30 MB；系統不支援 HEIC 與 HEIF。

結果讀取

建立回應會回傳公開 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	類型	必填	預設值	範圍	選項
size	select	否	auto	-	auto, 1K, 1.5K, 2K
output_format	select	否	jpeg	-	jpeg, png

Nano Banana 2 Lite

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

圖片 · Nano Banana 2 Lite 是 Rivya 點數較低的 Nano Banana 選項，適合快速製作商品概念、社群圖片變體與參考圖引導的草稿。每次生成固定為 3 點數，並提供 15 種長寬比。

接入文件模型頁面

基礎點數

per_image · default=3 · ⌈total⌉

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image · 10 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "nano-banana-2-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "auto"
  }
}

參考素材規則

參考圖片: 最多上傳 10 張 JPEG、PNG 或 WebP 圖片，每張不超過 30 MB。

結果讀取

建立回應會回傳公開 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, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9

Qwen Image 3.0

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

圖片 · Qwen Image 3.0 是 Rivya 可靈活設定的 Qwen 圖片模型，適合中文或英文提示詞、參考圖引導的版面，以及可重現的視覺測試。它提供 1K 或 2K 輸出、提示詞擴寫、負面提示詞與隨機種子控制。

接入文件模型頁面

基礎點數

per_output_plus_input_image · output=4.8 · input_image=0.5 · ⌈total⌉

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

800 字元

參考素材

image · 3 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "qwen-image-3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "選填：要避免的元素或失敗情況，最多 5,000 個字元。",
    "seed": 1
  }
}

參考素材規則

參考圖片: 最多上傳三張 JPEG、PNG、WebP、BMP、GIF 或 TIFF 圖片，每張不超過 10 MB。

結果讀取

建立回應會回傳公開 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	是	1K	-	1K, 2K
image_size	select	否	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_format	select	否	png	-	png, jpeg
prompt_extend	select	否	true	-	true, false
nsfw_checker	select	否	false	-	false, true
negative_prompt	text	否	-	-	-
seed	number	否	1	min 0 / max 2147483647 / step 1	-

Qwen Image 3.0 Pro

qwen-image-3-proAPI 可呼叫部分可用：需要 Files API

圖片 · Qwen Image 3.0 Pro 是 Rivya 獨立的 Pro 級 Qwen 圖片模型，適合精緻的行銷活動主視覺、商品場景與海報概念。它支援中文或英文提示詞、最多三張參考圖，以及分開計價的 1K 與 2K 點數級別。

接入文件模型頁面

基礎點數

per_output_plus_input_image · 1K=6.4 · 2K=12 · input_image=0.5 · ⌈total⌉

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

800 字元

參考素材

image · 3 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "qwen-image-3-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "1K",
    "image_size": "16:9",
    "output_format": "png",
    "prompt_extend": "true",
    "nsfw_checker": "false",
    "negative_prompt": "選填：要避免的元素或失敗情況，最多 5,000 個字元。",
    "seed": 1
  }
}

參考素材規則

參考圖片: 最多上傳三張 JPEG、PNG、WebP、BMP、GIF 或 TIFF 圖片，每張不超過 10 MB。

結果讀取

建立回應會回傳公開 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	是	1K	-	1K, 2K
image_size	select	否	16:9	-	1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
output_format	select	否	png	-	png, jpeg
prompt_extend	select	否	true	-	true, false
nsfw_checker	select	否	false	-	false, true
negative_prompt	text	否	-	-	-
seed	number	否	1	min 0 / max 2147483647 / step 1	-

Grok Imagine Image 2.0

grok-imagine-image-2-0API 可呼叫部分可用：需要 Files API

圖片 · Grok Imagine Image 2.0 支援從文字生成單張圖片，以及使用一至五張具簽章的參考圖片進行標準圖片編輯。編輯請求可選用五種固定長寬比或自動長寬比。

接入文件模型頁面

基礎點數

per_image · text_to_image=4 · image_edit=4 · ⌈total⌉

支援模式

text-to-image, image-to-image

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image · 5 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 上傳一至五張 JPEG、PNG 或 WebP 圖片，每張不得超過 10 MB。每張參考圖片都必須附有具簽章的上傳中繼資料。

結果讀取

建立回應會回傳公開 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, auto

Seedance 2.0

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

影片 · 字節跳動完整的 Seedance 2.0 影片模型，支援純文字生成、畫面引導動畫和多模態參考生成。Rivya 清楚區分各種輸入方式，讓首幀與尾幀和多模態參考素材各自發揮明確作用。

接入文件模型頁面

基礎點數

per_input_and_output_second · 720p_without_video=41 · 1080p_with_video=62 · 1080p_without_video=102 · 4K_with_video=128 · 4K_without_video=208 · ⌈total⌉

支援模式

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

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

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	-	720p, 1080p, 4K
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 可呼叫部分可用：需要 Files API

影片 · 字節跳動更快的 Seedance 2.0 影片模型，可從純文字、首幀與尾幀，或多模態參考素材開始生成。Rivya 清楚區分各種輸入規則，避免首幀與尾幀和參考圖片、影片或音訊的用途混淆。

接入文件模型頁面

基礎點數

per_input_and_output_second · 480p_with_video=6.8 · 480p_without_video=11.7 · 720p_with_video=15 · 720p_without_video=24.8 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image, video, audio · 15 個文件

請求

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

參考素材規則

多模態參考: Frames: 1–2 signed images. Reference: up to 9 JPEG/PNG/WebP/BMP/TIFF/GIF images under 30 MB each, 3 MP4/MOV videos of 2–15 seconds under 50 MB each, and 3 MP3/WAV audio clips of 2–15 seconds under 15 MB each. Video and audio each have a separate 15-second total limit.

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

參數

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

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

接入文件模型頁面

基礎點數

per_output_second · 480p_without_audio=1.75 · 480p_with_audio=3.5 · 720p_without_audio=3.5 · 720p_with_audio=7 · 1080p_without_audio=7.5 · 1080p_with_audio=15 · ⌈total⌉

支援模式

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",
    "nsfw_checker": "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	number	否	8	min 4 / max 12 / step 1	-
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
nsfw_checker	select	否	false	-	false, true

Seedance 1.0 Pro

seedance-1-0-pro此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Seedance 1.0 Pro 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Seedance 1.0 Pro Fast

seedance-1-0-pro-fast此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Seedance 1.0 Pro Fast 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Seedance 1.0 Lite

seedance-1-0-lite此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Seedance 1.0 Lite 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

HappyHorse 1.0

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

影片 · HappyHorse 1.0 在 Rivya 的同一模型頁中支援文字生成影片、單圖生成影片與多圖參考影片。

接入文件模型頁面

基礎點數

per_output_second · 720p=28 · 1080p=48 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 9 個文件

請求

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,
    "seed": 0
  }
}

參考素材規則

參考媒體: 圖片生成影片必須使用 1 張圖片，參考影片可使用 2 到 9 張圖片。圖片須為 JPEG、PNG 或 WebP，且不超過 10 MB；單圖模式要求寬與高均不低於 300 像素，參考模式要求短邊不低於 400 像素。

結果讀取

建立回應會回傳公開 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	-
seed	number	否	0	min 0 / max 2147483647	-

Wan 2.7 Video

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

影片 · Wan 2.7 Video: 720p = 16 credits/s; 1080p = 24 credits/s; text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s; nsfw_checker=true.

接入文件模型頁面

基礎點數

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

支援模式

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": "negative_prompt ≤ 500",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

參考素材規則

參考媒體: 參考媒體: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

結果讀取

建立回應會回傳公開 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	number	否	5	min 0 / max 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

影片 · Wan 2.6 支援不附媒體的文字生成影片、恰好 1 張圖片的圖片生成影片，以及使用 1–3 個影片的影片編輯；圖片與影片不可混用。文字與圖片輸入支援 5、10 或 15 秒；影片輸入只支援 5 或 10 秒。

接入文件模型頁面

基礎點數

per_video · 720p_5=70 · 720p_10=140 · 720p_15=210 · 1080p_5=104.5 · 1080p_10=209.5 · 1080p_15=315 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image, video · 3 個文件

請求

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": "1080p",
    "duration": "5",
    "multi_shots": "false",
    "nsfw_checker": "true"
  }
}

參考素材規則

參考媒體: 請使用恰好 1 張 JPG/PNG/WebP 圖片（至少 256×256、最大 10 MB）或 1–3 個 MP4/MOV 影片（每個最大 10 MB）。

結果讀取

建立回應會回傳公開 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
duration	select	否	5	-	5, 10, 15
multi_shots	select	否	false	-	false, true
nsfw_checker	select	否	true	-	false, true

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` 點數。

接入文件模型頁面

基礎點數

per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

800 字元

參考素材

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

參考素材規則

參考圖片: 上傳最多 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	否	-	-	-

Wan 2.2 A14B Turbo

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

影片 · Wan 2.2 A14B Turbo 支援文字轉影片、圖片轉影片和圖片+音訊驅動影片。文字/圖片生成固定為 5 秒，價格為 `480p = 40`、`580p = 60`、`720p = 80`；圖片+音訊按輸出秒計費，價格為 `480p = 12`、`580p = 18`、`720p = 24`。

接入文件模型頁面

基礎點數

per_output_second · 480p_standard_5s=40 · 580p_standard_5s=60 · 720p_standard_5s=80 · 480p_speech=12 · 580p_speech=18 · 720p_speech=24 · ⌈total⌉

支援模式

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 4	-
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 可呼叫需要 Files API

影片 · 當來源片段已經有正確動作和構圖，只需要更換可見主體時，請選 Wan Animate Replace。當整個鏡頭需要重新想像時，回到提示詞驅動生成；如果要做的不只主體替換，則使用更廣泛的編輯專案。

接入文件模型頁面

基礎點數

per_output_second · 480p=6 · 580p=9.5 · 720p=12.5 · ⌈total⌉

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

video, image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

video: video, image

結果讀取

建立回應會回傳公開 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, 580p, 720p

Hailuo 2.3

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

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

接入文件模型頁面

基礎點數

per_video · standard_768P_6=25 · standard_768P_10=40 · standard_1080P_6=40 · pro_768P_6=40 · pro_768P_10=80 · pro_1080P_6=70 · ⌈total⌉

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 為圖片專案上傳最多 1 個圖片檔案。 JPG / PNG / WebP · ≤ 10 MB · 1 image.

結果讀取

建立回應會回傳公開 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
nsfw_checker	select	否	true	-	false, true

Hailuo Pro

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

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

接入文件模型頁面

基礎點數

per_video · 1080P_6=57 · ⌈total⌉

支援模式

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": "true",
    "nsfw_checker": "true"
  }
}

參考素材規則

參考圖片: 圖片模式接受最多 2 張圖片，第二張圖片會成為尾幀。 · JPG / PNG / WebP · ≤ 10 MB

結果讀取

建立回應會回傳公開 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	否	true	-	false, true
nsfw_checker	select	否	true	-	false, true

Hailuo Standard

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

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

接入文件模型頁面

基礎點數

per_video · text_6=30 · text_10=50 · image_512P_6=12 · image_512P_10=20 · image_768P_10=50 · ⌈total⌉

支援模式

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": "768P",
    "prompt_optimizer": "true"
  }
}

參考素材規則

參考圖片: 圖片模式接受最多 2 張圖片，第二張圖片會成為尾幀。 JPG / PNG / WebP · ≤ 10 MB.

結果讀取

建立回應會回傳公開 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	否	768P	-	512P, 768P
prompt_optimizer	select	否	true	-	false, true

Kling 3.0

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

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

接入文件模型頁面

基礎點數

per_output_second · 720p_without_audio=14 · 720p_with_audio=20 · 1080p_without_audio=18 · 1080p_with_audio=27 · 4K=67 · ⌈total⌉

支援模式

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-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, 4k
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

影片 · 明確的 1 張圖片 + 1 段動作影片專案，讓身份和動作角色保持清楚 Standard (720P) 20 × 經驗證動作影片秒數；Pro (1080P) 27 × 秒數

接入文件模型頁面

基礎點數

per_output_second · 720p=20 · 1080p=27 · ⌈total⌉

支援模式

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 段動作影片專案，讓身份和動作角色保持清楚 Standard (720P) 20 × 經驗證動作影片秒數；Pro (1080P) 27 × 秒數

結果讀取

建立回應會回傳公開 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 2.6

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

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

接入文件模型頁面

基礎點數

per_video · 5s_without_audio=55 · 5s_with_audio=110 · 10s_without_audio=110 · 10s_with_audio=220 · ⌈total⌉

支援模式

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 個圖片檔案。 JPEG/PNG ≤ 10 MB.

結果讀取

建立回應會回傳公開 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 額外的場景控制時，適合使用它。

接入文件模型頁面

基礎點數

per_output_second · 720p=11 · 1080p=18 · ⌈total⌉

支援模式

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 點數。

接入文件模型頁面

基礎點數

per_video · 5s=42 · 10s=84 · ⌈total⌉

支援模式

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 張圖片以切換到圖片轉影片模式；第二張圖片會映射到尾幀。 JPEG/PNG ≤ 10 MB.

結果讀取

建立回應會回傳公開 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 / step 0.1	-

Kling V2.1 Master

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

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

接入文件模型頁面

基礎點數

per_video · 5s=160 · 10s=320 · ⌈total⌉

支援模式

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

參考素材規則

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

結果讀取

建立回應會回傳公開 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 / step 0.1	-

Kling V2.1 Pro

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

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

接入文件模型頁面

基礎點數

per_video · 5s=50 · 10s=100 · ⌈total⌉

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片模式最多接受 2 個圖片檔案，第二張圖片會映射到尾幀。 JPEG/PNG ≤ 10 MB.

結果讀取

建立回應會回傳公開 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 / step 0.1	-

Kling V2.1 Standard

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

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

接入文件模型頁面

基礎點數

per_video · 5s=25 · 10s=50 · ⌈total⌉

支援模式

image-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

5000 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

參考圖片: 圖片模式最多接受 1 個圖片檔案作為第一幀。 JPEG/PNG ≤ 10 MB.

結果讀取

建立回應會回傳公開 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 / step 0.1	-

Kling AI Avatar Pro

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

影片 · 快手的 Kling AI Avatar Pro 高品質說話頭像模型，使用一張人物肖像加一段音訊生成口型同步的頭像影片。Rivya 依已驗證音訊時長以每秒 16 點數計價，最長 300 秒，總點數向上取整。

接入文件模型頁面

基礎點數

per_input_second · default=16 · ⌈total⌉

支援模式

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 點數計價，最長 300 秒，總點數向上取整。

接入文件模型頁面

基礎點數

per_input_second · default=8 · ⌈total⌉

支援模式

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 點數。

接入文件模型頁面

基礎點數

per_input_second · 480p=3 · 720p=12 · ⌈total⌉

支援模式

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

接入文件模型頁面

基礎點數

per_video · 720p_5s=12 · 720p_10s=30 · 1080p_5s=30 · ⌈total⌉

支援模式

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。

接入文件模型頁面

基礎點數

per_video · default=90 · ⌈total⌉

支援模式

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	否	-	-	-

Luma Modify Video

luma-modify-video此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Luma Modify Video 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

video · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

video: video

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Grok Imagine Video 1.5 Preview

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

影片 · Grok Imagine Video 1.5 Preview 支援 1～15 秒、480p 或 720p、最多 7 張參考圖片，以及最長 4096 字元的提示詞。

接入文件模型頁面

基礎點數

per_output_second · 480p=2.4 · 720p=4.5 · ⌈total⌉

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

4096 字元

參考素材

image · 7 個文件

請求

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": {
    "duration": 8,
    "resolution": "480p",
    "aspect_ratio": "auto",
    "nsfw_checker": "true"
  }
}

參考素材規則

參考圖片: 最多 7 張 JPEG、PNG 或 WebP 圖片，每張不超過 20MB。

結果讀取

建立回應會回傳公開 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	number	否	8	min 1 / max 15 / step 1	-
resolution	select	否	480p	-	480p, 720p
aspect_ratio	select	否	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3
nsfw_checker	select	否	true	-	true, false

Sora 2 Pro

sora-2-pro此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Sora 2 Pro 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Sora 2

sora-2此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Sora 2 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

image: image

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Sora Watermark Remover

sora-watermark-remover此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Sora Watermark Remover 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Topaz Video Upscaler

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

影片 · 僅接收 1 個已上傳影片，不使用提示詞；放大倍率為 1x、2x 或 4x，預設 2x。

接入文件模型頁面

基礎點數

per_input_second · 1x_or_2x=8 · 4x=14 · ⌈total⌉

支援模式

video-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

video · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源影片: Rivya 接受 1 個不超過 10MB 的 MP4、MOV 或 MKV 檔案；上游介面允許 50MB，因此站內採用更嚴格的限制。

結果讀取

建立回應會回傳公開 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

影片 · 720p 扣 225 點數，1080p 扣 233 點數（232.5 無條件進位），4K 扣 285；Extend 扣 225，符合條件的 1080p／4K 結果操作扣 8／60。音訊能力仍屬實驗性且不保證可用；交付前必須逐項人工檢查。升解析度操作只接受本人成功的 720p 基礎任務或 Extend 結果；直接生成的 1080p／4K 結果不能再次處理。

接入文件模型頁面

基礎點數

per_video · generate_720p=225 · generate_1080p=232.5 · generate_4K=285 · extend_quality=225 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支援模式

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": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "可選水印文字",
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 使用 1 張圖片作為起始畫面，或使用 2 張圖片作為開始與結束畫面。 JPEG / PNG · 1–2 · 10 MB.

結果讀取

建立回應會回傳公開 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
aspectRatio	select	否	16:9	-	16:9, 9:16, Auto
resolution	select	否	720p	-	720p, 1080p, 4k
duration	select	否	8	-	4, 6, 8
watermark	text	否	-	-	-
enableTranslation	select	否	true	-	true, false

Veo3.1 Fast

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

影片 · 支援純文字、首尾影格與 1～3 張參考圖片生成，可直接選擇 720p／1080p／4K 和 4／6／8 秒。音訊能力仍屬實驗性且不保證可用；交付前必須逐項人工檢查。

接入文件模型頁面

基礎點數

per_video · generate_720p=30 · generate_1080p=37.5 · generate_4K=90 · extend_fast=30 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支援模式

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": "TEXT_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "可選水印文字",
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 參考圖片模式接受 1～3 張已驗證的 JPEG 或 PNG，每張不超過 10 MB，只支援 16:9／9:16，且時長必須為 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	類型	必填	預設值	範圍	選項
generationType	select	否	TEXT_2_VIDEO	-	TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO
aspectRatio	select	否	16:9	-	16:9, 9:16, Auto
resolution	select	否	720p	-	720p, 1080p, 4k
duration	select	否	8	-	4, 6, 8
watermark	text	否	-	-	-
enableTranslation	select	否	true	-	true, false

Veo3.1 Lite

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

接入文件模型頁面

基礎點數

per_video · generate_720p=15 · generate_1080p=22.5 · generate_4K=75 · extend_lite=15 · get_1080p=7.5 · get_4K=60 · ⌈total⌉

支援模式

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-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "generationType": "FIRST_AND_LAST_FRAMES_2_VIDEO",
    "aspectRatio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "watermark": "可選水印文字",
    "enableTranslation": "true"
  }
}

參考素材規則

參考圖片: 參考圖片模式接受 1～3 張已驗證的 JPEG 或 PNG，每張不超過 10 MB，只支援 16:9／9:16，且時長必須為 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	類型	必填	預設值	範圍	選項
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
resolution	select	否	720p	-	720p, 1080p, 4k
duration	select	否	8	-	4, 6, 8
watermark	text	否	-	-	-
enableTranslation	select	否	true	-	true, false

Wan 3.0 Video

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

影片 · Wan 3.0 Video 將標準版與 Prime 層級、文字生成影片、首尾幀引導及已簽署的多模態參考整合於同一模型。它支援 480P、720P 或 1080P 輸出，可選明確的 2–30 秒片長或智慧片長，並可接收由圖片、影片和音訊組成的參考素材組合。

接入文件模型頁面

基礎點數

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image, video, audio · 20 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "wan-3-0-video",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

參考素材規則

引導畫面或已簽署的多模態參考: 畫面場景接收一張必要的首幀圖片及一張可選尾幀圖片。參考場景最多接收 10 張 JPEG、無透明度 PNG、WebP 或 BMP 圖片，每張 20 MB；5 段 MP4/MOV 影片，每段 95 MB、1–15 秒；以及 5 個 MP3/WAV 音訊片段，每個 15 MB、1–15 秒；影片及音訊各自合計最多 15 秒。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

參數

key	類型	必填	預設值	範圍	選項
seedance_scene	select	否	text	-	text, frames, reference
variant	select	否	standard	-	standard, prime
resolution	select	否	1080P	-	480P, 720P, 1080P
aspect_ratio	select	否	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16
duration	number	否	5	min -1 / max 30 / step 1	-
audio	select	否	true	-	true, false
seed	number	否	-	min 0 / max 2147483647 / step 1	-

Flux 3

flux-3這個模型已規劃支援 Public API，但目前還不能呼叫。這個模型已規劃支援 Public API，但目前還不能呼叫。

影片 · Flux 3 出現在即將推出的影片目錄中，標籤為文字轉影片與圖片轉影片。Rivya 將本頁作為狀態參考，不承諾未發布的控制項或運作行為。

模型頁面

基礎點數

這個模型已規劃支援 Public API，但目前還不能呼叫。

支援模式

API 輸入狀態

這個模型已規劃支援 Public API，但目前還不能呼叫。

輸入類型

Prompt 上限

參考素材

請求

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

這個模型已規劃支援 Public API，但目前還不能呼叫。

參數

不需要額外模型參數。

Kling 3.0 Turbo

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

影片 · Kling 3.0 Turbo 是 Rivya 專注於 Kling 影片生成的模型，可依文字提示直接生成，或從一張靜態圖片製作動畫。兩種路徑都支援 720p 與 1080p 輸出，以及 3 至 15 秒的整數片長；畫面比例控制則僅供文字生成影片使用。

接入文件模型頁面

基礎點數

per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

2500 字元

參考素材

image · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "kling-3-turbo",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

參考素材規則

可選的起始圖片: 圖片生成影片必須上傳恰好一張不超過 10 MB 的 JPEG 或 PNG 圖片。文字生成影片不使用上傳媒體。

結果讀取

建立回應會回傳公開 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	number	否	5	min 3 / max 15 / step 1	-
aspect_ratio	select	否	16:9	-	1:1, 9:16, 16:9

Seedance 2.0 Mini

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

影片 · Seedance 2.0 Mini 是 Rivya 費率較低的多模態 Seedance 工作流程，支援純提示影片、首幀或首尾幀動畫，以及混合圖片、影片或音訊參考。480p 與 720p 層級涵蓋 4 至 15 秒輸出，同時讓三種輸入場景保持互斥。

接入文件模型頁面

基礎點數

per_input_and_output_second · 480p_with_video=2.4 · 480p_without_video=3.8 · 720p_with_video=5 · 720p_without_video=8.2 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

20000 字元

參考素材

image, video, audio · 15 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "seedance-2-mini",
  "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",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

參考素材規則

引導畫面或多模態參考: 畫面場景接受 1 或 2 張 JPEG/PNG/WebP/GIF 圖片，每張不超過 30 MB。參考場景最多接受 9 張此類圖片、3 段不超過 50 MB 且長 2-15 秒的 MP4/MOV/MKV 影片，以及 3 個不超過 15 MB 且長 2-15 秒的 MP3/WAV 音訊檔；影片與音訊總片長各自不得超過 15 秒。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

參數

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 / step 1	-
generate_audio	select	否	true	-	true, false
web_search	select	否	false	-	false, true
nsfw_checker	select	否	true	-	false, true

Seedance 2.5

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

影片 · Seedance 2.5 是 Rivya 規模較大的 Seedance 工作流程，支援純提示影片、首尾幀引導、多模態參考及影片引導轉換。相較 Mini，它新增 1080p 層級、最長 30 秒輸出、自動片長、MP4 或 MOV 輸出，以及大幅提高的圖片、影片和音訊參考容量。

接入文件模型頁面

基礎點數

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

30000 字元

參考素材

image, video, audio · 50 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

引導畫面或高容量參考素材: 畫面場景接受 1 或 2 張 JPEG、PNG、WebP、BMP、GIF 或 TIFF 圖片，每張不超過 30 MB。參考場景最多接受 30 張圖片、10 段不超過 95 MB 且長 2-30 秒的 MP4/MOV 影片，以及 10 個不超過 15 MB 且長 2-30 秒的 MP3/WAV 音訊檔；影片與音訊總片長各自不得超過 30 秒，所有媒體合計不得超過 50 個檔案。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

參數

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

MiniMax H3

minimax-h3API 可呼叫部分可用：需要 Files API

影片 · MiniMax H3 是 Rivya 的 768P 或 2K 影片模型，支援純提示生成、首尾幀動畫及多模態參考。參考路徑可混合圖片、MP4 或 MOV 短片，以及 MP3 或 WAV 音訊；積分公式則分別計入經驗證的輸入影片時間及超過前 5 張的圖片。

接入文件模型頁面

基礎點數

per_input_and_output_second · 768P=16 · 2K=26 · additional_image_after_five=8 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

7000 字元

參考素材

image, video, audio · 15 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "minimax-h3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

參考素材規則

引導畫面或多模態參考: 畫面場景接受 1 或 2 張 JPEG、PNG 或 WebP 圖片，每張不超過 30 MB。參考場景最多接受 9 張此類圖片、3 段不超過 50 MB 且長 2-15 秒的 MP4/MOV 影片，以及 3 個不超過 15 MB 且長 2-15 秒的 MP3/WAV 音訊檔；影片與音訊總片長各自不得超過 15 秒，所有媒體合計不得超過 15 個檔案，且音訊不能單獨使用。

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

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

參數

key	類型	必填	預設值	範圍	選項
seedance_scene	select	否	text	-	text, frames, reference
resolution	select	否	2K	-	768P, 2K
aspect_ratio	select	否	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
minimax_single_frame_role	select	否	first	-	first, last
duration	number	否	6	min 4 / max 15 / step 1	-

HappyHorse 1.1

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

影片 · HappyHorse 1.1 是彈性的 AI 影片模型，支援 720p 或 1080p 純提示短片、單張圖片動畫及多圖片參考影片，輸出片長為 3 至 15 秒。

接入文件模型頁面

基礎點數

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

支援模式

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

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

5000 字元

參考素材

image · 9 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

首幀或參考圖片: 上傳一張 JPEG、PNG 或 WebP 圖片製作首幀動畫，或上傳 2 至 9 張圖片生成參考引導影片。每個檔案最多 20 MB。

結果讀取

建立回應會回傳公開 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, 4:5, 5:4, 9:21, 21:9
duration	number	否	5	min 3 / max 15 / step 1	-

Gemini Omni Video

gemini-omni-video此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · 官方合約仍有公開文件，但目前產品頁無法使用，登入後的價格目錄也沒有此模型的價格。因此，生成會在預留點數前關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

OmniHuman 1.5

omnihuman-1-5API 可呼叫需要 Files API

影片 · OmniHuman 1.5 會將恰好一張肖像圖片與一段音訊轉為 720p 或 1080p 的音訊驅動角色影片，積分依經驗證的音訊片長計算。

接入文件模型頁面

基礎點數

per_input_second · default=27 · ⌈total⌉

支援模式

image-audio-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

300 字元

參考素材

image, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

肖像圖片與音訊: 上傳恰好一張不超過 10 MB 的 JPEG、PNG 或 WebP 肖像，以及一個不超過 10 MB、短於 60 秒的 MP3、M4A、WAV、AAC 或 OGG 音訊檔。

結果讀取

建立回應會回傳公開 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	類型	必填	預設值	範圍	選項
output_resolution	select	否	1080	-	720, 1080
pe_fast_mode	select	否	false	-	false, true
seed	number	否	-1	-	-

Volcengine Video Lip Sync

volcengine-video-lip-syncAPI 可呼叫需要 Files API

影片 · Volcengine Video Lip Sync 會使用一條目標人聲軌，替換一段現有影片中的說話演出，並提供 Lite 或 Basic 處理模式，積分依片長計算。輸出為 25 FPS 的 MP4，片長跟隨目標音訊。

接入文件模型頁面

基礎點數

per_input_second · default=8 · ⌈total⌉

支援模式

video-audio-to-video

API 輸入狀態

需要 Files API

輸入類型

file

Prompt 上限

參考素材

video, audio · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

來源影片與目標音訊: 上傳恰好一段不超過 95 MB 的 MP4 或 MOV 影片，以及一條不超過 10 MB 的 MP3、M4A、WAV、AAC 或 OGG 人聲軌。

結果讀取

建立回應會回傳公開 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	是	lite	-	lite, basic
separate_vocal	select	否	false	-	false, true
open_scenedet	select	否	false	-	false, true
align_audio	select	否	true	-	true, false
align_audio_reverse	select	否	false	-	false, true
templ_start_seconds	number	否	0	min 0	-

Kling O3

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

影片 · 目前開放可完整驗證的單鏡頭文字生成，以及單張首幀或首尾幀兩圖生成。

接入文件模型頁面

基礎點數

per_output_second · 720p_without_audio=14 · 720p_with_audio=18 · 1080p_without_audio=18 · 1080p_with_audio=23 · 4k_without_audio=67 · 4k_with_audio=67 · ⌈total⌉

支援模式

text-to-video, image-to-video

API 輸入狀態

部分可用：需要 Files API

輸入類型

text, file

Prompt 上限

3072 字元

參考素材

image · 2 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "kling-o3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "audio": "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	類型	必填	預設值	範圍	選項
resolution	select	否	720p	-	720p, 1080p, 4k
duration	select	否	5	-	3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
audio	select	否	false	-	false, true
aspect_ratio	select	否	16:9	-	16:9, 9:16, 1:1

Wan Animate 2

wan-animate-2這個模型已規劃支援 Public API，但目前還不能呼叫。這個模型已規劃支援 Public API，但目前還不能呼叫。

影片 · Wan Animate 2 是 Coming Soon 的影片轉影片條目。公開角色動畫定位不構成 Rivya 可呼叫合同或定價。

模型頁面

基礎點數

這個模型已規劃支援 Public API，但目前還不能呼叫。

支援模式

API 輸入狀態

這個模型已規劃支援 Public API，但目前還不能呼叫。

輸入類型

Prompt 上限

參考素材

請求

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

這個模型已規劃支援 Public API，但目前還不能呼叫。

參數

不需要額外模型參數。

PixVerse V6

pixverse-v6此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · PixVerse V6 — 暫時無法使用. 這是暫時的定價與整合安全暫停，不是 Coming Soon。頁面保持可索引，但在完整價格合約穩定前，生成入口與可呼叫報價都保持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Wan 2.6 Flash

wan-2-6-flash此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

影片 · Wan 2.6 Flash / 暫時無法使用 — 這是暫時的定價與整合安全暫停，不是 Coming Soon。頁面保持可索引，但在完整價格合約穩定前，生成入口與可呼叫報價都保持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Suno Music

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

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

接入文件模型頁面

基礎點數

per_request · default=12 · ⌈total⌉

支援模式

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 的輕量文字轉聲音模型，適合環境聲循環、背景音和短聲音草稿。它保留已記錄的固定價格：每次生成 `2.5` 點數，並允許成功結果繼續進入 `Vocal Separation`。

接入文件模型頁面

基礎點數

per_request · generate_sounds=2.5 · separate_vocal=10 · ⌈total⌉

支援模式

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` 點數。

接入文件模型頁面

基礎點數

per_request · generate_lyrics=0.4 · ⌈total⌉

支援模式

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、訪談和角色場景的對白節奏。

接入文件模型頁面

基礎點數

per_1000_characters · dialogue_text=14 · ⌈total⌉

支援模式

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 專案。

接入文件模型頁面

基礎點數

per_1000_characters · text=6 · ⌈total⌉

支援模式

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。

接入文件模型頁面

基礎點數

per_1000_characters · text=12 · ⌈total⌉

支援模式

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	否	-	-	-

ElevenLabs Sound Effect V2

elevenlabs-sound-effect-v2此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

音訊 · ElevenLabs Sound Effect V2 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供音效生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

ElevenLabs Audio Isolation

elevenlabs-audio-isolation此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

音訊 · ElevenLabs Audio Isolation 目前無法在 Rivya 使用。此頁僅保留歷史能力參考，不提供生成、不建立任務，也不扣除點數。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

audio · 1 個文件

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

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

參考素材規則

audio: audio

結果讀取

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

常見錯誤

validation_failed, insufficient_credits, idempotency_conflict, not_found

這個模型只用於規劃和比較。狀態變為 API 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3.1 Flash TTS

gemini-3-1-flash-tts此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

音訊 · Gemini 3.1 Flash TTS 已列出文字轉語音與對話轉語音能力，但 Rivya 目前暫時無法提供生成，因為在任務開始前，仍無法安全界定單次執行的最高音訊 token 成本。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 2.5 Pro TTS

gemini-2-5-pro-tts此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

音訊 · Gemini 2.5 Pro TTS 已有文字轉語音與對話轉語音的公開資料，但 Rivya 會維持生成暫時停用，直到每種允許的腳本都能由安全的最高點數預留完整涵蓋。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.5

gpt-5-5-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.5 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.4

gpt-5-4-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.4 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.4 Codex

gpt-5.4-codex-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.4 Codex 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.3 Codex

gpt-5-3-codex-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.3 Codex 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.2

gpt-5-2-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.2 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.2 Codex

gpt-5-2-codex-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.2 Codex 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.1 Codex

gpt-5-1-codex-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.1 Codex 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5 Codex

gpt-5-codex-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5 Codex 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3.1 Pro

gemini-3-1-pro-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3.1 Pro 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3 Pro

gemini-3-pro-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3 Pro 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3 Flash

gemini-3-flash-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3 Flash 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 2.5 Pro

gemini-2-5-pro-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 2.5 Pro 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 2.5 Flash

gemini-2-5-flash-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 2.5 Flash 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Claude Opus 4.7

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

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

接入文件模型頁面

基礎點數

per_million_tokens · input=285 · output=1430 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

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-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Claude Opus 4.6 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Claude Sonnet 4.6

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

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

接入文件模型頁面

基礎點數

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

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-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Claude Opus 4.5 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Claude Sonnet 4.5

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

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

接入文件模型頁面

基礎點數

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

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 語氣但不想使用高階方案成本的高頻專案。

接入文件模型頁面

基礎點數

per_million_tokens · input=55 · output=285 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

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 模型不支援圖片附件。

參數

不需要額外模型參數。

Claude Opus 4.8

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

對話 · Rivya 上以文字為主的 Claude 對話模型，適合審閱高密度資料包並形成審慎、結構化的決策結論。

接入文件模型頁面

基礎點數

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

claude-messages

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "claude-opus-4-8-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 Fable 5

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

對話 · Rivya 上以文字為主的 Claude 對話模型，適合敘事重構、面向特定讀者的草稿和結構化編輯工作。

接入文件模型頁面

基礎點數

per_million_tokens · input=800 · output=4000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

claude-messages

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "claude-fable-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 5

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

對話 · Rivya 上以文字為主的 Claude 對話模型，適合實作簡報、需求審閱和精煉的技術規劃。

接入文件模型頁面

基礎點數

per_million_tokens · input=170 · output=855 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

claude-messages

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "claude-sonnet-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 Opus 5

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

對話 · Rivya 上以文字為主的 Claude 對話模型，適合董事會層級的風險梳理、情境比較和決策記錄。

接入文件模型頁面

基礎點數

per_million_tokens · input=400 · output=2000 · cache_read_multiplier=0.1 · cache_write_5m_multiplier=1.25 · cache_write_1h_multiplier=2 · ⌈total⌉

支援模式

claude-messages

API 輸入狀態

文字輸入可用

輸入類型

text

Prompt 上限

20000 字元

參考素材

請求

POST /api/v1/generations

鑑權

Bearer API Key

Idempotency-Key

建議使用

請求體

{
  "model": "claude-opus-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 模型不支援圖片附件。

參數

不需要額外模型參數。

GPT-5.6 Luna

gpt-5-6-luna-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.6 Luna 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.6 Terra

gpt-5-6-terra-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.6 Terra 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

GPT-5.6 Sol

gpt-5-6-sol-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · GPT-5.6 Sol 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3.5 Flash

gemini-3-5-flash-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3.5 Flash 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3.6 Flash

gemini-3-6-flash-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3.6 Flash 已收錄在 Rivya，但目前處於接入安全暫停狀態；可索引的狀態頁會繼續保留，對話呼叫仍維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Gemini 3.7 Flash

gemini-3-7-flash-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Gemini 3.7 Flash 已收錄在 Rivya，但目前處於整合安全暫停狀態；可索引的狀態頁會追蹤已確認的對話規格，執行功能則維持關閉。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Grok 4.3

grok-4-3-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Grok 4.3 — 暫時無法使用. Grok 4.3 仍在整合安全暫停時，先使用可呼叫的替代模型繼續工作。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Grok 4.5

grok-4-5-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Grok 4.5 — 暫時無法使用. Grok 4.5 仍在整合安全暫停時，先使用可呼叫的替代模型繼續工作。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Grok 4.6

grok-4-6-chat此請求暫時無法使用，請稍後重試。此請求暫時無法使用，請稍後重試。

對話 · Grok 4.6 — 暫時無法使用. Grok 4.6 仍在整合安全暫停時，先使用可呼叫的替代模型繼續工作。

模型頁面

基礎點數

此請求暫時無法使用，請稍後重試。

支援模式

API 輸入狀態

此請求暫時無法使用，請稍後重試。

輸入類型

Prompt 上限

參考素材

請求

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 可呼叫前，不要透過 Public API v1 呼叫它。

參數

不需要額外模型參數。

Kimi K3

kimi-k3-chat這個模型已規劃支援 Public API，但目前還不能呼叫。這個模型已規劃支援 Public API，但目前還不能呼叫。

對話 · Kimi K3 是即將推出的 Chat 模型。本頁追蹤可用狀態並提供現有對話模型，不聲稱未發布的上下文、工具或回應行為。

模型頁面

基礎點數

這個模型已規劃支援 Public API，但目前還不能呼叫。

支援模式

API 輸入狀態

這個模型已規劃支援 Public API，但目前還不能呼叫。

輸入類型

Prompt 上限

參考素材

請求

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

這個模型已規劃支援 Public API，但目前還不能呼叫。

參數

不需要額外模型參數。

模型 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

請求體

參數