LogoNanoPhoto.AI文档
LogoNanoPhoto.AI文档
网站首页文档首页

入门指南

入门指南

用户指南

用户指南

API

API 概览Sora 水印去除 API视频反推提示词 APISora 2 提示词生成器 APISora 2 视频生成 APISora 2 TVC 广告 APINano Banana Pro 图片生成 APINano Banana 2 图片生成 API

场景

Sora 2 TVC 广告制作

常见问题

常见问题
X (Twitter)

Sora 2 提示词生成器 API

根据主题生成专业 Sora 2 视频提示词的 API,支持多种视频手法和多语言输出。

在线体验:https://nanophoto.ai/zh/sora-2-prompt-generator

接口

POST /api/sora-2/generate-prompt

认证

Authorization: Bearer YOUR_API_KEY

积分

每次生成消耗 2 积分。

积分在请求开始时预扣,生成失败时自动退还。

请求

请求头

请求头值
Content-Typeapplication/json
AuthorizationBearer YOUR_API_KEY

请求体参数

参数类型必填描述
topicstring是视频主题或场景描述(最大 500 字符)
modestring否textToVideo 或 imageToVideo(默认:textToVideo)
techniquestring否视频手法(见下表)。默认:montage
durationnumber否视频时长,单位秒(默认:10)
modelstring否AI 模型(默认:google/gemini-3-flash-preview)
localestring否输出语言(默认:en)。支持:en、zh、zh-TW、ja、ko、es、fr、de、pt、ru、ar
imageUrlsstring[]否imageToVideo 模式的公开图片 URL(最多 3 张)

支持的视频手法

值描述
montage蒙太奇 - 快速切换镜头组合
long-take长镜头 - 一镜到底
time-lapse延时摄影
slow-motion慢动作
tracking-shot跟踪镜头
aerial-view航拍视角
pov第一人称视角
split-screen分屏效果
match-cut匹配剪辑
fade-transition淡入淡出
  • imageUrls 仅接受公开可访问的 URL。不支持通过 API 上传 Base64 图片。
  • topic 最大 500 字符。

示例

文生视频提示词

curl -X POST "https://nanophoto.ai/api/sora-2/generate-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-raw '{
    "topic": "宁静的日式庭院,樱花花瓣飘落到锦鲤池塘",
    "technique": "slow-motion",
    "duration": 15,
    "locale": "zh"
  }'

图生视频提示词

curl -X POST "https://nanophoto.ai/api/sora-2/generate-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-raw '{
    "topic": "为这个风景画添加微风和飘浮的云朵动画效果",
    "mode": "imageToVideo",
    "technique": "long-take",
    "duration": 10,
    "locale": "zh",
    "imageUrls": ["https://example.com/landscape.jpg"]
  }'

响应

成功 - 流式输出

API 返回流式文本响应(Content-Type: text/plain; charset=utf-8)。生成的 Sora 2 提示词会实时流式输出。

输出内容包含:

  • 带时间标记的结构化视频提示词
  • 逐镜头分解
  • 镜头角度、运动和光影细节
  • 氛围和情绪描述

错误

{
  "success": false,
  "error": "Insufficient credits. Required: 2 credits for prompt generation.",
  "errorCode": "INSUFFICIENT_CREDITS",
  "requiredCredits": 2
}

完整 TypeScript 示例

generate-prompt.ts
async function generatePrompt(apiKey: string) {
  const response = await fetch("https://nanophoto.ai/api/sora-2/generate-prompt", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${apiKey}`,
    },
    body: JSON.stringify({
      topic: "未来感城市日落景观,飞行器穿梭与霓虹灯光",
      technique: "aerial-view",
      duration: 15,
      locale: "zh",
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`生成失败: ${error.error}`);
  }

  // 读取流式响应
  const reader = response.body!.getReader();
  const decoder = new TextDecoder();
  let prompt = "";

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    const chunk = decoder.decode(value);
    prompt += chunk;
    process.stdout.write(chunk);
  }

  console.log("\n\n完整提示词:", prompt);
  return prompt;
}

错误码

errorCodeHTTP 状态码描述
LOGIN_REQUIRED401需要认证
API_KEY_RATE_LIMIT_EXCEEDED429超出速率限制
INSUFFICIENT_CREDITS402积分不足
INVALID_INPUT400主题为空或超过长度限制

视频反推提示词 API

分析视频提取详细镜头分解和提示词的 API。

Sora 2 视频生成 API

使用 OpenAI Sora 2 模型生成视频的 API,支持文生视频和图生视频模式。

目录

接口
认证
积分
请求
请求头
请求体参数
支持的视频手法
示例
文生视频提示词
图生视频提示词
响应
成功 - 流式输出
错误
完整 TypeScript 示例
错误码