LogoNanoPhoto.AI文檔
LogoNanoPhoto.AI文檔
首頁文件

入門指南

入門指南

使用者指南

使用者指南

API

API 參考Sora 浮水印去除 API影片反推提示詞 API

場景

Sora 2 TVC 廣告製作

常見問題

常見問題
X (Twitter)

影片反推提示詞 API

分析影片擷取詳細鏡頭分解和提示詞的 API。

線上體驗:https://nanophoto.ai/zh-TW/video-reverse-prompt

端點

POST /api/sora-2/reverse-prompt

認證

Authorization: Bearer YOUR_API_KEY

積分

每次分析消耗 1 積分(僅 API 呼叫;網頁端免費)。

請求

請求標頭

請求標頭值
Content-Typeapplication/json
AuthorizationBearer YOUR_API_KEY

請求主體參數

參數類型必填描述
videoSourcestring是影片來源類型:youtube、url 或 file
localestring否輸出語言(預設:en)。支援:en、zh、zh-TW、ja、ko、es、fr、de、pt、ru、ar
videoUrlstring條件必填影片連結。YouTube 連結(當 videoSource 為 youtube 時)或直接 .mp4 連結(當 videoSource 為 url 時)
videoFilestring條件必填Base64 編碼的影片檔案(當 videoSource 為 file 時必填)
videoFileNamestring否上傳影片的原始檔名

範例

YouTube 影片

curl -X POST "https://nanophoto.ai/api/sora-2/reverse-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-raw '{
    "videoSource": "youtube",
    "locale": "zh-TW",
    "videoUrl": "https://www.youtube.com/watch?v=W-15-UmGP5s"
  }'

影片 URL

curl -X POST "https://nanophoto.ai/api/sora-2/reverse-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-raw '{
    "videoSource": "url",
    "locale": "zh-TW",
    "videoUrl": "https://static.nanophoto.ai/demo/sk2-ad.mp4"
  }'

檔案上傳(Base64)

讀取影片檔案並編碼為 Base64,然後透過 videoFile 欄位傳入。

app/api/example/route.ts
import { readFile } from "node:fs/promises";

const videoBuffer = await readFile("your-video.mp4");
const videoBase64 = videoBuffer.toString("base64");

const response = await fetch("https://nanophoto.ai/api/sora-2/reverse-prompt", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    videoSource: "file",
    locale: "zh-TW",
    videoFile: videoBase64,
    videoFileName: "your-video.mp4",
  }),
});

// 串流讀取回應
const reader = response.body!.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  process.stdout.write(decoder.decode(value));
}
  • 僅支援 .mp4 格式
  • 最大檔案大小:30 MB(Base64 編碼前)
  • videoFile 的值可以是純 Base64 字串,也可以是 Data URL(如 data:video/mp4;base64,...)

回應

成功 - 串流輸出

API 回傳串流文字回應(Content-Type: text/plain; charset=utf-8)。AI 分析在生成時即時串流輸出,包含 Markdown 表格格式的詳細鏡頭分解。

輸出內容包括:

  • 鏡號、景別/角度、攝影機運動
  • 詳細畫面描述
  • 音訊分析(BGM、音效、旁白)
  • 每個鏡頭的時長
  • 整體總結

錯誤

{
  "success": false,
  "error": "AI service temporarily unavailable. Please try again later.",
  "errorCode": "AI_SERVICE_ERROR"
}

錯誤碼

errorCodeHTTP 狀態碼描述
LOGIN_REQUIRED401需要認證
API_KEY_RATE_LIMIT_EXCEEDED429超出速率限制
INSUFFICIENT_CREDITS402積分不足
INVALID_INPUT400缺少必填參數
INVALID_YOUTUBE_URL400YouTube URL 無效
INVALID_VIDEO_URL400影片 URL 無效
INVALID_FORMAT400MP4 格式無效
FILE_TOO_LARGE400檔案超過 30MB
VIDEO_DOWNLOAD_FAILED400影片下載失敗
VIDEO_PROCESSING_FAILED422影片處理失敗
AI_SERVICE_ERROR503AI 服務不可用
SERVICE_UNAVAILABLE503服務配置問題
INTERNAL_ERROR500內部伺服器錯誤

Sora 浮水印去除 API

去除 Sora 2 生成影片浮水印的 API。

Sora 2 TVC 廣告製作

使用 AI 三步建立專業 TVC 風格影片廣告。從創意主題到成片,幾分鐘即可完成。

目錄

端點
認證
積分
請求
請求標頭
請求主體參數
範例
YouTube 影片
影片 URL
檔案上傳(Base64)
回應
成功 - 串流輸出
錯誤
錯誤碼