媒體 API — 圖片、影片、音樂

使用與文字模型相同的 sk-nr-… 金鑰與餘額，生成圖片、影片和音樂。統一帳戶、按實際用量計費，無需訂閱或購買套裝方案。

基底 URL： https://nordrouter.com（海外網路可使用 https://global-api.nordrouter.com）。
驗證： 使用 Authorization: Bearer sk-nr-… 標頭（或 X-API-Key: sk-nr-…）。
格式： JSON，生成採非同步方式（建立任務 → 輪詢 → 取得檔案）。

端點

方法	用途
`POST /media/generate`	建立生成任務
`GET /media/job/:id`	取得任務狀態與結果
`POST /media/estimate`	預先查詢設定的費用
`GET /media/models`	取得機器可讀的模型與參數清單
`POST /media/upload`	上傳來源媒體檔案
`GET /media/file/:id`	取得生成的檔案（`result_url` 中的連結）

請求生命週期

1. 建立任務

bash

curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-2.6-i2v",
        "input": { "prompt": "鏡頭平順推近", "image": "https://…/photo.png", "duration": "5", "audio": true } }'

json

{ "id": "b1f2…", "model": "video/kling-2.6-i2v", "status": "processing", "poll": "https://nordrouter.com/media/job/b1f2…" }

2. 輪詢狀態（每 3–5 秒一次）

bash

curl https://nordrouter.com/media/job/b1f2…

json

{ "id": "b1f2…", "status": "done", "result_url": "https://nordrouter.com/media/file/b1f2…", "cost_usd": 0.55, "error": null }

3. 取得檔案 — 透過 result_url。連結位於 nordrouter.com（您的品牌）；檔案保留 14 天後刪除，請提前下載或轉存至自己的儲存空間。

上傳來源媒體檔案

image、image2、audio_url 和 video_url 欄位接受可公開存取的直接連結。具有 attachments 欄位的模型接受由 POST /media/upload 回傳的物件所組成的陣列：傳送 { "data": "data:audio/mpeg;base64,…", "name": "track.mp3" }，再將上傳介面的完整回應傳入 input.attachments。Suno 也可改為在 input.source_url 中傳入公開 URL；mashup 則可在 input.source_urls 中傳入兩個 URL。

計費

費用從您的美元餘額（與文字模型共用）扣除，依實際完成的生成計費，金額與下方表格完全一致。

預留 → 結算。 建立任務時會預留預估費用；完成後依實際結果重新計算，多餘金額退回餘額。
影片按秒計費。 費用隨長度與解析度增加；啟用聲音的費用較高。表格列出預設設定的起價，/秒 表示每秒費率。
失敗不計費。 若任務以 failed 狀態結束，預留金額將全額退回，僅成功生成才需付費。
預先取得確切費用 — 使用相同的 model + input 呼叫 POST /media/estimate，即可在啟動前取得 { "usd": … }。
儲值以盧布支付（約 $1 = 89–96 ₽）；後續皆以 USD 計算。

模型目錄

價格：影片按每秒費率計費（/秒），總價 = 費率 × 時長（解析度／音訊也可能影響費率）；其餘則為預設設定下每次生成的價格。POST /media/estimate 會傳回任何設定的確切費用。

input 可包含更多欄位 — GET /media/models 一律會傳回機器可讀的清單（型別、選項、預設值、秒數範圍）。必填欄位以 * 標示。模型的任何額外欄位（negative_prompt、seed、cfg_scale…）都可直接放入 input 傳送。

舊版參數名稱

2026 年 10 月 19 日起，參數採用統一的名稱與值：名稱使用 snake_case，值使用小寫（例如， version: "v6-wild"、resolution: "720p"、audio: true）。舊版文件中的名稱與值仍可使用 — 先前編寫的整合無須修改：任務、結果與價格皆相同。 GET /media/models、MCP 與本文件僅使用新版名稱與值。如果請求同時包含同一參數的舊名稱與新名稱，則以新名稱為準。

🖼 圖片

`model`	模式	`input` 參數	檔案	價格
`image/nano-banana`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3\|3:2\|2:3\|21:9\|auto, `safety_filter`=bool	PNG	$0.025
`image/nano-banana-2`	文字→圖片	`prompt` *, `aspect_ratio`=auto\|1:1\|16:9\|9:16\|3:4\|4:3\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.050
`image/nano-banana-2-lite`	文字→圖片	`prompt` *, `aspect_ratio`=auto\|1:1\|16:9\|9:16\|3:4\|4:3, `image`=url, `safety_filter`=bool	PNG	$0.025
`image/nano-banana-pro`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3\|21:9\|auto, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.11
`image/imagen4-fast`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.025
`image/imagen4`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.050
`image/imagen4-ultra`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.075
`image/gpt-image-1.5`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-1.5-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=3:2\|1:1\|2:3, `quality`=medium\|high, `safety_filter`=bool	PNG	$0.025
`image/gpt-image-2`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|3:2\|2:3\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.006
`image/gpt-image-2-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=auto\|1:1\|3:2\|2:3\|16:9\|9:16, `resolution`=1k\|2k\|4k, `safety_filter`=bool	PNG	$0.037
`image/flux2-pro`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.031
`image/flux2-pro-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3\|auto, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.031
`image/flux2-flex`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.087
`image/flux2-flex-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|3:2\|2:3\|auto, `resolution`=1k\|2k, `safety_filter`=bool	PNG	$0.087
`image/seedream-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `resolution`=1k\|2k\|4k, `safety_filter`=bool	PNG	$0.037
`image/seedream-4.5-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.044
`image/seedream-5-lite-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.037
`image/seedream-5.0-pro-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1\|4:3\|3:4\|16:9\|9:16\|2:3\|3:2\|21:9, `quality`=basic\|high, `safety_filter`=bool	PNG	$0.044
`image/ideogram-v3`	文字→圖片	`prompt` *, `render_mode`=fast\|balanced\|quality, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `style`=auto\|general\|realistic\|design, `safety_filter`=bool	PNG	$0.044
`image/ideogram-edit`	圖片編輯	`prompt` , `image`=url , `render_mode`=fast\|balanced\|quality, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.044
`image/ideogram-character`	圖片編輯	`prompt` , `image`=url , `render_mode`=fast\|balanced\|quality, `style`=auto\|realistic\|fiction, `safety_filter`=bool	PNG	$0.11
`image/qwen`	文字→圖片	`prompt` *, `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.031
`image/qwen-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=1:1-hd\|1:1\|3:4\|9:16\|4:3\|16:9, `safety_filter`=bool	PNG	$0.037
`image/qwen-i2i`	圖片編輯	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.031
`image/qwen2-edit`	圖片編輯	`prompt` , `image`=url , `aspect_ratio`=16:9\|1:1\|3:4\|4:3\|9:16\|3:2\|2:3, `safety_filter`=bool	PNG	$0.037
`image/grok`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|2:3\|3:2\|16:9\|9:16, `pro`=bool, `safety_filter`=bool	PNG	$0.025
`image/grok-edit`	圖片編輯	`prompt` , `image`=url , `safety_filter`=bool	PNG	$0.025
`image/z-image`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|3:4\|4:3, `safety_filter`=bool	PNG	$0.006
`image/wan-2.7`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.031
`image/wan-2.7-pro`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4\|21:9, `resolution`=1k\|2k\|4k, `image`=url, `safety_filter`=bool	PNG	$0.075
`image/seedream-5.0-pro`	文字→圖片	`prompt` *	JPG	$0.013
`image/gemini-3.1-flash`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.013
`image/gemini-3-pro`	文字→圖片	`prompt` *, `aspect_ratio`=1:1\|16:9\|9:16\|4:3\|3:4, `resolution`=1k\|2k\|4k	PNG	$0.031

🎬 影片

`model`	模式	`input` 參數	檔案	價格
`video/veo-3.1-fast`	文字→影片	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.38
`video/veo-3.1-quality`	文字→影片	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$1.56
`video/veo-3.1-lite`	文字→影片	`prompt` *, `aspect_ratio`=16:9\|9:16, `image`=url	MP4	$0.19
`video/gemini-omni`	文字→影片	`prompt` , `duration`=4\|6\|8\|10 , `aspect_ratio`=16:9\|9:16, `resolution`=720p\|1080p\|4k, `image`=url, `safety_filter`=bool	MP4	$0.66
`video/gemini-omni-flash`	文字→影片	`prompt` *, `attachments`=upload[]	MP4	$0.13
`video/kling-3.0`	文字→影片	`prompt` *, `duration`=3–15秒, `aspect_ratio`=16:9\|9:16\|1:1, `mode`=standard\|pro\|4k, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.11/秒
`video/kling-t2v`	文字→影片	`prompt` *, `duration`=3–15秒, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/秒
`video/kling-turbo-i2v`	照片→影片	`prompt` , `image`=url , `duration`=3–15秒, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.11/秒
`video/kling-2.6-t2v`	文字→影片	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `audio`=bool, `safety_filter`=bool	MP4	$0.34
`video/kling-2.6-i2v`	照片→影片	`prompt` , `image`=url , `duration`=5\|10, `audio`=bool, `safety_filter`=bool	MP4	$0.34
`video/kling-2.5-t2v`	文字→影片	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$0.26
`video/kling-2.5-i2v`	照片→影片	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.26
`video/kling-i2v`	照片→影片	`prompt` , `image`=url , `image2`=url, `duration`=5\|10, `safety_filter`=bool	MP4	$0.31
`video/kling-2.1-standard`	照片→影片	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$0.16
`video/kling-2.1-master-t2v`	文字→影片	`prompt` *, `duration`=5\|10, `aspect_ratio`=16:9\|9:16\|1:1, `safety_filter`=bool	MP4	$1.00
`video/kling-2.1-master-i2v`	照片→影片	`prompt` , `image`=url , `duration`=5\|10, `safety_filter`=bool	MP4	$1.00
`video/kling-motion`	影片→影片	`image`=url , `video_url` , `prompt`, `mode`=standard\|pro	MP4	$1.25
`video/kling-avatar`	虛擬人像（照片+音訊）	`image`=url , `audio_url` , `prompt` *	MP4	$0.75
`video/kling-avatar-pro`	虛擬人像（照片+音訊）	`image`=url , `audio_url` , `prompt` *	MP4	$1.50
`video/wan-2.7-t2v`	文字→影片	`prompt` *, `duration`=2–15秒, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/秒
`video/wan-2.7-i2v`	照片→影片	`prompt` , `image`=url , `image2`=url, `duration`=2–15秒, `resolution`=720p\|1080p, `audio_url`, `safety_filter`=bool	MP4	$0.15/秒
`video/wan-2.7-r2v`	照片→影片	`prompt` , `image`=url , `duration`=2–10秒, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.15/秒
`video/wan-2.7-edit`	影片→影片	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/wan-t2v`	文字→影片	`prompt` *, `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-i2v`	照片→影片	`prompt` , `image`=url , `duration`=5\|10\|15, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.44
`video/wan-v2v`	影片→影片	`prompt` , `video_url` , `duration`=5\|10, `resolution`=720p\|1080p	MP4	$0.44
`video/wan-2.5-t2v`	文字→影片	`prompt` , `duration`=5\|10 , `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.38
`video/wan-2.5-i2v`	照片→影片	`prompt` , `image`=url , `duration`=5\|10 *, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.38
`video/wan-2.2-t2v`	文字→影片	`prompt` *, `aspect_ratio`=16:9\|9:16, `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-2.2-i2v`	照片→影片	`prompt` , `image`=url , `resolution`=480p\|720p, `safety_filter`=bool	MP4	$0.50
`video/wan-s2v`	虛擬人像（照片+音訊）	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-move`	影片→影片	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/wan-animate-replace`	影片→影片	`image`=url , `video_url` , `resolution`=480p\|580p\|720p	MP4	$0.38
`video/seedance-2`	文字→影片	`prompt` *, `duration`=4–15秒, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|21:9, `resolution`=480p\|720p\|1080p\|4k, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.26/秒
`video/seedance-2-fast`	文字→影片	`prompt` *, `duration`=4–15秒, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.21/秒
`video/seedance-2-mini`	文字→影片	`prompt` *, `duration`=4–15秒, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=480p\|720p, `audio`=bool, `image`=url, `image2`=url, `safety_filter`=bool	MP4	$0.13/秒
`video/seedance-1.5-pro`	文字→影片	`prompt` *, `duration`=4–12秒, `aspect_ratio`=16:9\|9:16\|1:1\|4:3, `resolution`=480p\|720p\|1080p, `audio`=bool, `image`=url, `safety_filter`=bool	MP4	$0.025/秒
`video/hailuo-02-t2v`	文字→影片	`prompt` *, `duration`=6\|10, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-t2v-pro`	文字→影片	`prompt` *, `safety_filter`=bool	MP4	$0.36
`video/hailuo-02-i2v`	照片→影片	`prompt` , `image`=url , `image2`=url, `duration`=6\|10, `resolution`=768p\|512p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-02-i2v-pro`	照片→影片	`prompt` , `image`=url , `image2`=url, `safety_filter`=bool	MP4	$0.36
`video/hailuo-2.3-i2v`	照片→影片	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.19
`video/hailuo-2.3-i2v-pro`	照片→影片	`prompt` , `image`=url , `duration`=6\|10, `resolution`=768p\|1080p, `safety_filter`=bool	MP4	$0.28
`video/happyhorse-1.1-t2v`	文字→影片	`prompt` *, `duration`=3–15秒, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/秒
`video/happyhorse-1.1-i2v`	照片→影片	`prompt`, `image`=url *, `duration`=3–15秒, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/秒
`video/happyhorse-1.1-r2v`	照片→影片	`prompt` , `image`=url , `duration`=3–15秒, `aspect_ratio`=16:9\|9:16\|1:1, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.18/秒
`video/happyhorse-t2v`	文字→影片	`prompt` *, `duration`=3–15秒, `aspect_ratio`=16:9\|9:16\|1:1\|4:3\|3:4, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/秒
`video/happyhorse-i2v`	照片→影片	`prompt`, `image`=url *, `duration`=3–15秒, `resolution`=720p\|1080p, `safety_filter`=bool	MP4	$0.30/秒
`video/happyhorse-edit`	影片→影片	`prompt` , `video_url` , `resolution`=720p\|1080p, `audio_source`=auto\|original	MP4	$1.50
`video/grok-t2v`	文字→影片	`prompt` *, `duration`=6–30秒, `aspect_ratio`=16:9\|9:16\|1:1\|3:2\|2:3, `resolution`=480p\|720p, `mode`=normal\|fun\|spicy, `safety_filter`=bool	MP4	$0.019/秒
`video/grok-i2v`	照片→影片	`prompt` , `image`=url , `duration`=6–30秒, `resolution`=480p\|720p, `mode`=normal\|fun\|spicy, `safety_filter`=bool	MP4	$0.019/秒
`video/grok-1.5`	文字→影片	`prompt` *, `duration`=1–15秒, `aspect_ratio`=auto\|16:9\|9:16\|1:1, `resolution`=480p\|720p, `image`=url, `safety_filter`=bool	MP4	$0.019/秒
`video/omnihuman`	虛擬人像（照片+音訊）	`image`=url , `audio_url` , `prompt`, `resolution`=720p\|1080p	MP4	$1.69
`video/infinitalk`	虛擬人像（照片+音訊）	`prompt` , `image`=url , `audio_url` *, `resolution`=480p\|720p	MP4	$0.19
`video/lipsync`	影片→影片	`video_url` , `audio_url` , `mode`=lite\|basic	MP4	$0.50
`video/topaz-upscale`	解析度提升	`video_url` *, `scale`=2\|4	MP4	$0.50

🎵 音樂

`model`	模式	`input` 參數	檔案	價格
`music/suno-v5`	音樂	`title` , `style` , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `prompt`	MP3	$0.075
`music/suno-cover`	音樂	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360秒	MP3	$0.075
`music/suno-extend-upload`	音樂	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `continue_from`=1–120, `instrumental`=bool	MP3	$0.075
`music/suno-add-vocals`	音樂	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `style`, `title`, `exclude_styles`, `vocal`=female\|male	MP3	$0.075
`music/suno-add-instrumental`	音樂	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `title`, `exclude_styles`	MP3	$0.075
`music/suno-mashup`	音樂	`prompt` , `attachments`=upload[] , `version`=v6\|v6-wild\|v6-mini, `instrumental`=bool, `advanced`=bool, `title`, `style`, `duration`=10–360秒	MP3	$0.075
`music/suno-sounds`	音樂	`prompt` *, `version`=v6\|v6-wild\|v6-mini, `loop`=bool, `bpm`=auto\|60\|80\|100\|120\|140\|160, `tonality`=auto\|C\|Dm\|Em\|F\|G\|Am\|D#m	MP3	$0.016

🎙 音訊

`model`	模式	`input` 參數	檔案	價格
`audio/gemini-3.1-flash-tts`	語音合成	`text` *, `voice`=Achernar\|Achird\|Algenib\|Algieba\|Alnilam\|Aoede\|Autonoe\|Callirrhoe\|Charon\|Despina\|Enceladus\|Erinome\|Fenrir\|Gacrux\|Iapetus\|Kore\|Laomedeia\|Leda\|Orus\|Puck\|Pulcherrima\|Rasalgethi\|Sadachbia\|Sadaltager\|Schedar\|Sulafat\|Umbriel\|Vindemiatrix\|Zephyr\|Zubenelgenubi, `style`=vocal-smile\|newscaster\|whisper\|empathetic\|promo-hype\|deadpan, `pace`=natural\|fast\|slow\|staccato, `accent`=neutral\|american\|american-valley\|american-south\|british\|british-brixton\|transatlantic\|australian, `voice_description`, `scene`, `temperature`=0–2	WAV	$0.006
`audio/gemini-2.5-pro-tts`	語音合成	`text` *, `voice`=Achernar\|Achird\|Algenib\|Algieba\|Alnilam\|Aoede\|Autonoe\|Callirrhoe\|Charon\|Despina\|Enceladus\|Erinome\|Fenrir\|Gacrux\|Iapetus\|Kore\|Laomedeia\|Leda\|Orus\|Puck\|Pulcherrima\|Rasalgethi\|Sadachbia\|Sadaltager\|Schedar\|Sulafat\|Umbriel\|Vindemiatrix\|Zephyr\|Zubenelgenubi, `style`=vocal-smile\|newscaster\|whisper\|empathetic\|promo-hype\|deadpan, `pace`=natural\|fast\|slow\|staccato, `accent`=neutral\|american\|american-valley\|american-south\|british\|british-brixton\|transatlantic\|australian, `voice_description`, `scene`, `temperature`=0–2	WAV	$0.006
`audio/elevenlabs-tts`	語音合成	`text` *, `voice`=james\|addison\|adeline\|allison\|ana-rita\|anika\|arabella\|aria\|bella\|benjamin\|bradford\|brian\|britney\|brittney\|brock\|burt\|callum\|cassidy\|ed\|edward\|emma\|eve\|felix\|finn\|hank\|hope-poetic\|hope-bubbly\|horatius\|jamahal\|jean\|jeff\|jessica-eloquent\|jessica-chatty\|john-doe\|john-morgan\|johnny-dynamite\|johnny-kid\|kuon\|laura\|leon\|liam\|lucy\|lutz\|mark-casual\|mark-natural\|marshal\|monika\|nathan\|nathaniel\|phil\|rachel\|rex-thunder\|sam\|spuds\|sven\|taksh\|theodore\|tiffany\|tom\|viking-bjorn\|viraj-smooth\|viraj-rich\|wyatt\|xavier, `voice_id`, `speed`=0.8\|1.0\|1.2	MP3	$0.037
`audio/elevenlabs-multilingual`	語音合成	`text` *, `voice`=james\|addison\|adeline\|allison\|ana-rita\|anika\|arabella\|aria\|bella\|benjamin\|bradford\|brian\|britney\|brittney\|brock\|burt\|callum\|cassidy\|ed\|edward\|emma\|eve\|felix\|finn\|hank\|hope-poetic\|hope-bubbly\|horatius\|jamahal\|jean\|jeff\|jessica-eloquent\|jessica-chatty\|john-doe\|john-morgan\|johnny-dynamite\|johnny-kid\|kuon\|laura\|leon\|liam\|lucy\|lutz\|mark-casual\|mark-natural\|marshal\|monika\|nathan\|nathaniel\|phil\|rachel\|rex-thunder\|sam\|spuds\|sven\|taksh\|theodore\|tiffany\|tom\|viking-bjorn\|viraj-smooth\|viraj-rich\|wyatt\|xavier, `voice_id`, `speed`=0.8\|1.0\|1.2	MP3	$0.075

🧊 3D 模型

輸出為 GLB（部分模型可選 OBJ、FBX、STL、USDZ、USD、3MF）以及預覽圖片：任務會傳回多個檔案，每個檔案都有各自的副檔名。檔案清單位於 results 欄位，每個檔案都有 ext。

生成後才能確定價格

3D 按實際使用的資源計費。我們會先預扣表格中的費用上限，待實際費用確定後扣款，並 退還差額。最終費用一律記錄在 cost_usd。

`model`	模式	`input` 參數	檔案	價格
`3d/tripo-text`	文字→3D	`prompt` *, `negative_prompt`, `texture_detail`=standard\|high, `geometry_detail`=standard\|high, `pbr`=bool, `quad_mesh`=bool	GLB/FBX	$0.31–0.79
`3d/tripo-image`	照片→3D	`image`=url *, `texture_detail`=standard\|high, `geometry_detail`=standard\|high, `pbr`=bool, `quad_mesh`=bool	GLB/FBX	$0.31–0.79
`3d/hunyuan-rapid-text`	文字→3D	`prompt` *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB 等	$0.43–0.71
`3d/hunyuan-rapid-image`	照片→3D	`image`=url *, `file_format`=glb\|obj\|fbx\|stl\|usdz, `pbr`=bool, `extra_mesh`=bool	GLB 等	$0.43–0.71
`3d/hunyuan-pro-text`	文字→3D	`prompt` *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/hunyuan-pro-image`	照片→3D	`image`=url *, `output`=textured\|mesh, `polygons`=auto\|40000\|100000\|300000\|800000\|1500000, `pbr`=bool	GLB	$0.71–1.00
`3d/seed3d-image`	照片→3D	`image`=url *, `mesh_detail`=low\|medium\|high, `file_format`=glb\|obj\|usd\|usdz	GLB/OBJ/USD	$0.50
`3d/meshy-text`	文字→3D	`prompt` *, `texture_size`=2k\|4k\|8k, `pose`=none\|a-pose\|t-pose, `ultra`=bool, `pbr`=bool, `texture_text`, `texture_photo`=url	GLB	$0.94–1.26
`3d/meshy-image`	照片→3D	`image`=url *, `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`, `texture_photo`=url	GLB	$0.94–1.26
`3d/meshy-multi-image`	多角度圖片→3D	`images`=[url] * (1–4), `texture_size`=2k\|4k\|8k, `ultra`=bool, `texture`=bool, `pbr`=bool, `texture_text`	GLB	$0.94–1.26

以照片作為材質貼圖。 3d/meshy-* 的材質貼圖與幾何形狀分別設定：可在 texture_photo 中提供圖片，或在 texture_text 中以文字描述。

耗時較長。 3D 運算需要半分鐘到數分鐘，比圖片和短片更久。無須保持連線：狀態會保留，並支援 Webhook。

🛠 工具

`model`	模式	`input` 參數	檔案	價格
`image/topaz-upscale`	解析度提升	`image`=url *, `scale`=2\|4\|8	PNG	$0.063
`image/recraft-remove-bg`	編輯	`image`=url *	PNG	$0.006
`image/recraft-upscale`	解析度提升	`image`=url *	PNG	$0.006

各模式範例

文字生成圖片

json

{ "model": "image/flux2-pro", "input": { "prompt": "neon fox in snow", "aspect_ratio": "16:9", "resolution": "2k" } }

圖片編輯

json

{ "model": "image/seedream-edit", "input": { "prompt": "移除背景，加入霓虹效果", "image": "https://…/photo.png" } }

照片→影片（首幀／尾幀、時長、音效）

json

{ "model": "video/wan-2.7-i2v", "input": {
    "prompt": "鏡頭平順推近", "image": "https://…/first.png",
    "image2": "https://…/last.png", "duration": 8, "resolution": "1080p" } }

音樂

json

{ "model": "music/suno-v5", "input": { "title": "Northern Lights", "style": "epic orchestral", "instrumental": true, "version": "v6" } }

語音合成

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "text": "你好，世界", "voice": "Zephyr", "style": "empathetic",
    "pace": "natural", "accent": "neutral" } }

雙聲音對話 — 以 dialogue 中的台詞取代 text 欄位，聲音設定放在 voices 中（聲音 1 為清單中的第一個）：

json

{ "model": "audio/gemini-3.1-flash-tts", "input": {
    "voices": [ { "voice": "Kore", "style": "newscaster" }, { "voice": "Puck", "pace": "fast" } ],
    "dialogue": [ { "speaker": 1, "text": "晚安！" }, { "speaker": 2, "text": "很高興聽到你的聲音。" } ] } }

虛擬人像（由照片 + 音訊生成說話影片）

json

{ "model": "video/omnihuman", "input": { "image": "https://…/face.png", "audio_url": "https://…/voice.mp3" } }

狀態與錯誤

GET /media/job/:id → status 欄位：

狀態	意義
`processing`	處理中 — 請繼續輪詢
`done`	已完成 — 檔案位於 `result_url`，扣款金額位於 `cost_usd`
`failed`	發生錯誤 — 原因位於 `error`，款項已退還

POST /media/generate 的回應碼：400 — 未知模型或缺少必要欄位；401 — 未提供金鑰或金鑰無效；402 — 餘額不足；403 — 此帳號無法使用該模型。

錯誤回應本文一律採用相同格式 — { "error": "текст для человека", "code": "машинный код" }。錯誤碼：unknown_model、 missing_param（另含 param 欄位）、invalid_input、invalid_attachment、prompt_too_long、input_too_long、 no_auth、no_key、insufficient_balance、unpaid_shortfall、rate_limited、generation_failed、unavailable。

預先估算費用

bash

curl https://nordrouter.com/media/estimate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" -H "Content-Type: application/json" \
  -d '{ "model": "video/kling-3.0", "input": { "duration": 10, "mode": "pro", "audio": true } }'

json

{ "model": "video/kling-3.0", "usd": 1.6875 }

表格中的參數已於 2026 年 10 月 19 日與服務目錄核對；完整且最新的模型、參數與價格清單請見 GET /media/models。

媒體 API — 圖片、影片、音樂 ​

端點 ​

請求生命週期 ​

計費 ​

模型目錄 ​

舊版參數名稱 ​

🖼 圖片 ​

🎬 影片 ​

🎵 音樂 ​

🎙 音訊 ​

🧊 3D 模型 ​

🛠 工具 ​

各模式範例 ​

狀態與錯誤 ​

預先估算費用 ​

媒體 API — 圖片、影片、音樂

端點

請求生命週期

計費

模型目錄

舊版參數名稱

🖼 圖片

🎬 影片

🎵 音樂

🎙 音訊

🧊 3D 模型

🛠 工具

各模式範例

狀態與錯誤

預先估算費用