Skip to content

媒體生成:影片、圖片與音樂

NordRouter 將不同媒體供應商整合為一致的非同步工作流程。提交 model、mode 和 inputs,取得工作 ID,最後讀取結果 URL。

  • 請使用模型目錄中的公開 ID,不要猜測內部供應商名稱。
  • 不同模型對寬高比、時長、解析度、音訊與參考圖片有不同限制。
  • 價格與保留期以目前目錄和 estimate 回應為準。

完整範例

原始指南中的可執行範例完整保留如下。請只執行適用於您所用工具和作業系統的區塊。

bash
curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image/nano-banana-2",
    "input": { "prompt": "a cozy cabin in a winter forest, watercolor", "resolution": "2K" }
  }'
json
{ "id": "beefb531-…", "model": "image/nano-banana-2", "status": "processing",
  "poll": "https://nordrouter.com/media/job/beefb531-…" }
bash
curl https://nordrouter.com/media/job/beefb531-…
json
{ "id": "beefb531-…", "status": "done",
  "result_url": "https://nordrouter.com/media/file/beefb531-…",
  "cost_usd": 0.052, "error": null }
bash
curl https://nordrouter.com/media/generate \
  -H "Authorization: Bearer sk-nr-YOUR-KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "image/nano-banana-2",
    "input": { "prompt": "…" },
    "callback_url": "https://your-server.com/webhooks/nordrouter",
    "callback_secret": "your-secret"
  }'
json
{ "event": "media.completed", "id": "beefb531-…", "status": "done",
  "result_url": "https://nordrouter.com/media/file/beefb531-…", "cost_usd": 0.052, "error": null }
python
import hmac, hashlib
expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
assert hmac.compare_digest(expected, request.headers["X-NR-Signature"])
json
{ "models": [
    { "id": "image/nano-banana-2", "type": "image",
      "fields": [ {"name":"prompt","type":"textarea"}, {"name":"resolution","type":"select","options":["1K","2K","4K"]} ],
      "est_usd": 0.052 }
  ], "retention_days": 14 }

官方資料與相關連結

TypeFamilyModes≈ price
🖼 ImagesNano Banana / 2 / Pro (image/nano-banana*)text→image, edit, up to 4Kfrom $0.025
🖼Imagen 4 Fast / Ultra (image/imagen4*)text→imagefrom $0.025
🖼GPT Image 1.5 / 2 (image/gpt-image-*)text→image, edit, up to 4Kfrom $0.025
🖼Flux 2 Pro / Flex (image/flux2-*)text→image, editfrom $0.03
🖼Seedream v4 / 4.5 / 5 Lite (image/seedream-*)text→image, editfrom $0.04
🖼Ideogram v3 / Character (image/ideogram-*)text, remix, characterfrom $0.02
🖼Qwen / Wan Image / Grok / Z-Imagetext→image, editfrom $0.01
🛠 UtilsTopaz / Recraft (image/*upscale*, image/recraft-remove-bg)upscale up to 8K, background removalfrom $0.01
🎬 VideoVeo 3.1 Lite / Fast / Quality (video/veo-3.1-*)text/image→videofrom $0.19
🎬Kling 2.1 → 3.0 (video/kling-*)text/image→video, motion, avatars, up to 4K & 15sfrom $0.16
🎬Wan 2.2 → 2.7 (video/wan-*)text/image/video→video, speech-to-videofrom $0.25
🎬Seedance 1.5 / 2 / Fast / Mini (video/seedance-*)text/image→video, up to 4K, audiofrom $0.06
🎬Hailuo 02 / 2.3 (video/hailuo-*)text/image→videofrom $0.08
🎬HappyHorse 1.0 / 1.1 (video/happyhorse-*)text/image/reference→video, video editfrom $0.70
🎬Grok Video / 1.5 (video/grok-*)text/image→video, up to 30sfrom $0.06
🎬Gemini Omni (video/gemini-omni)video with audio, up to 4Kfrom $0.39
🗣 AvatarsKling Avatar, OmniHuman, InfiniteTalk, Lip Syncphoto+audio→talking videofrom $0.19
🎵 MusicSuno V4–V5.5 (music/suno-v5)text/style→2 tracks~$0.08
🎙 SpeechElevenLabs Turbo / Multilingual (audio/elevenlabs-*)text→speech, vocal isolationfrom $0.04 / 1000 chars

相關指南

先以最小文字請求驗證連線,再加入串流、工具呼叫、圖片或其他進階功能。請勿把 API 金鑰寫入公開程式碼或瀏覽器前端。

疑難排解