为老照片添加动画效果

通过 Animate Old Photos API 将老照片转换为 AI 生成的视频。该智能体将上传一张照片，提交动画任务，轮询任务完成状态，并下载生成的 MP4 视频。

前提条件

本服务为付费服务。 您需要有效的 API 密钥及可用积分。

• 官方网站：Animate Old Photos
• 获取您的 API 密钥：Profile > API Key
• 购买积分：Buy Credits

每次动画生成消耗 3 积分。查看定价方案

系统要求：curl 和 jq 必须在当前 shell 环境中可用。

工作流

开始前准备

1. 若环境变量 AOP_API_KEY 未设置，则向用户询问其 API 密钥。
2. 向用户询问 图像路径。验证该文件存在、格式为 JPEG 或 PNG，且大小不超过 10 MB。
3. 可选地向用户询问一个 提示词（prompt），用于描述期望的动态效果（例如：“祖母微笑并挥手”）。如不提供，AI 将自动为其生成动作。
4. 向用户确认：“本次操作将消耗 3 积分。是否继续？”

步骤 1 — 身份认证

使用 API 密钥换取短期有效的访问令牌，并检查当前积分余额。

API_KEY="${AOP_API_KEY}"
AUTH=$(curl -s -X POST https://animateoldphotos.org/api/extension/auth 
  -H "Content-Type: application/json" 
  -d '{"licenseKey":"'"${API_KEY}"'"}')
TOKEN=$(echo "$AUTH" | jq -r '.accessToken')
CREDITS=$(echo "$AUTH" | jq -r '.creditBalance')
echo "已认证。当前可用积分为：$CREDITS"

若响应中缺失 accessToken，或 error_code 为 4010/4011，请告知用户其 API 密钥无效，并引导其前往 https://animateoldphotos.org/profile/interface-key 获取新密钥。

若当前积分少于 3，请提示用户前往 https://animateoldphotos.org/pricing 购买更多积分，并终止流程。

步骤 2 — 上传图像

获取预签名上传 URL，随后将图像二进制数据 PUT 至云存储。

IMAGE_PATH="photo.jpg"
FILE_SIZE=$(stat -f%z "$IMAGE_PATH" 2>/dev/null || stat -c%s "$IMAGE_PATH" 2>/dev/null)
CONTENT_TYPE="image/jpeg"  # 若为 .png 文件，请使用 image/png

UPLOAD=$(curl -s -X POST https://animateoldphotos.org/api/extension/upload-token 
  -H "Authorization: Bearer $TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"fileName":"'"$(basename "$IMAGE_PATH")"'","contentType":"'"${CONTENT_TYPE}"'","fileSize":'"${FILE_SIZE}"'}')
UPLOAD_URL=$(echo "$UPLOAD" | jq -r '.uploadUrl')
KEY=$(echo "$UPLOAD" | jq -r '.key')
PUBLIC_URL=$(echo "$UPLOAD" | jq -r '.publicUrl')

curl -s -X PUT "$UPLOAD_URL" 
  -H "Content-Type: ${CONTENT_TYPE}" 
  --data-binary "@${IMAGE_PATH}"
echo "图像已上传。"

步骤 3 — 完成上传

确认上传已完成，并接收后续任务提交所需的加密载荷（payload）。

FINALIZE=$(curl -s -X POST https://animateoldphotos.org/api/extension/upload-finalize 
  -H "Authorization: Bearer $TOKEN" 
  -F "key=${KEY}" 
  -F "publicUrl=${PUBLIC_URL}")
IMAGE_URL=$(echo "$FINALIZE" | jq -r '.url')
SS_MESSAGE=$(echo "$FINALIZE" | jq -r '.message')
DNT=$(echo "$FINALIZE" | jq -r '.dnt')
echo "上传已完成。"

步骤 4 — 提交动画任务

提交动画生成任务。Ss 请求头 必须 包含步骤 3 中返回的 message 值。

PROMPT=""  # 可选的用户提示词
TASK=$(curl -s -X POST https://animateoldphotos.org/api/extension/animate 
  -H "Authorization: Bearer $TOKEN" 
  -H "Ss: ${SS_MESSAGE}" 
  -F "prompt=${PROMPT}" 
  -F "input_image_url=${IMAGE_URL}" 
  -F "dnt=${DNT}" 
  -F "type=m2v_img2video" 
  -F "duration=5" 
  -F "public=false")
TASK_ID=$(echo "$TASK" | jq -r '.taskId')
TASK_DNT=$(echo "$TASK" | jq -r '.dnt')
TASK_DID=$(echo "$TASK" | jq -r '.did')
echo "任务已提交（ID：$TASK_ID）。正在轮询结果……"

若响应中包含 error_code 999990 或 10009，说明用户积分不足，请引导其前往 https://animateoldphotos.org/pricing 购买积分。

步骤 5 — 轮询直至完成

每 30 秒轮询一次。典型处理耗时为 2–5 分钟。

OUTPUT="output.mp4"
while true; do
  sleep 30
  STATUS=$(curl -s -G "https://animateoldphotos.org/api/extension/animate" 
    --data-urlencode "taskId=${TASK_ID}" 
    --data-urlencode "dnt=${TASK_DNT}" 
    --data-urlencode "did=${TASK_DID}" 
    --data-urlencode "type=m2v_img2video" 
    -H "Authorization: Bearer $TOKEN")

  ERR_MSG=$(echo "$STATUS" | jq -r '.message // empty')
  if [ -n "$ERR_MSG" ]; then
    echo "任务失败：$ERR_MSG"
    break
  fi

  S=$(echo "$STATUS" | jq -r '.status')
  RESOURCE=$(echo "$STATUS" | jq -r '.resource // empty')
  if [ "$S" -ge 99 ] 2>/dev/null && [ -n "$RESOURCE" ]; then
    curl -s -o "$OUTPUT" "$RESOURCE"
    echo "视频已保存至 $OUTPUT"
    break
  fi
  echo "仍在处理中（状态：$S）……"
done

任务完成后，向用户报告生成视频的保存路径。

一键式替代方案

您也可以直接运行封装好的脚本执行完整流程：

bash scripts/animate.sh   [PROMPT] [OUTPUT_PATH]

详情请参阅 scripts/animate.sh。

错误处理

对于网络错误，请最多重试 3 次，采用指数退避策略（延迟时间依次为 2s、4s、8s）。

交互流程

1. 触发条件：用户输入类似“为这张照片添加动画”、“将老照片转为视频”、“让这张照片动起来”等指令。
2. 收集输入：若 AOP_API_KEY 未设置，则索取 API 密钥；再索取图像路径；最后可选地索取提示词（prompt）。
3. 执行确认：“本次操作将消耗 3 积分。您当前剩余 {N} 积分。是否继续？”
4. 执行流程：依次运行步骤 1 至步骤 5，并在每个阶段向用户反馈进度。
5. 完成反馈：“您的动画视频已保存至 {output_path}。”
6. 出错处理：
   • 积分不足 → “您需要更多积分。请前往：https://animateoldphotos.org/stripe”
   • API 密钥无效 → “您的 API 密钥无效或已过期。请前往：https://animateoldphotos.org/profile/interface-key 获取新密钥”
   • 任务失败 → 显示具体错误信息，并建议用户重试或调整提示词（prompt）。

约束条件

• 支持的图像格式：仅 JPEG、PNG
• 最大文件大小：10 MB
• 最小图像尺寸：300 × 300 像素
• 单次动画成本：3 积分
• 输出视频时长：5 秒
• 典型处理耗时：2–5 分钟

完整 API 接口参考请参阅 animate-old-photos-api.md。