OATDA 视频生成

通过 OATDA，基于文本描述生成视频。视频生成是异步的——提交请求后获得任务 ID，再轮询查询完成状态。

API 密钥解析

所有命令均需提供 OATDA API 密钥。每次 exec 调用时需内联解析密钥：

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}"

若密钥为空或为 null，请提示用户前往 https://oatda.com 获取密钥并完成配置。

安全性说明：切勿打印完整 API 密钥。仅校验其是否存在，或仅显示前 8 位字符。

模型映射

默认值：若未指定模型，则使用 bytedance / seedance-1-5-pro-251215。

⚠️ 模型更新频繁。若某模型 ID 调用失败，请使用 oatda-list-models 命令配合参数 ?type=video 查询当前可用的最新视频模型列表。

获取模型专属参数

不同模型支持的参数各不相同。生成前请先查询：

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X GET "https://oatda.com/api/v1/llm/models?type=video" 
  -H "Authorization: Bearer $OATDA_API_KEY" | jq '.video_models[] | {id, supported_params}'

文件类参数（如 first_frame_image、last_frame_image）需传入公开可访问的 URL。

API 调用

关键要求：请求 URL 中必须包含 ?async=true 参数。

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X POST "https://oatda.com/api/v1/llm/generate-video?async=true" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OATDA_API_KEY" 
  -d '{
    "provider": "",
    "model": "",
    "prompt": ""
  }'

可选参数（添加至请求体中）

• duration：视频时长（单位：秒）
• resolution："720P" 或 "1080P"
• aspectRatio："16:9"、"9:16" 或 "1:1"
• quality：画质设置（依模型而定）
• style：风格设置（依模型而定）
• width / height：明确指定像素尺寸
• model_params：模型专属的键值对参数

model_params 示例

• Seedance：{"ratio": "16:9", "duration": "5", "generate_audio": true, "camera_fixed": false}
• Seedance 图生视频（I2V）：{"first_frame_image": "https://...", "last_frame_image": "https://..."}
• MiniMax：{"first_frame_image": "https://...", "resolution": "720P"}
• xAI：{"resolution": "720p"}

响应格式

{
  "taskId": "minimax-T2V01-abc123def456",
  "status": "pending",
  "provider": "minimax",
  "model": "T2V-01",
  "message": "Video generation task created",
  "pollUrl": "/api/v1/llm/video-status/minimax-T2V01-abc123def456"
}

注意返回的 taskId —— 后续查询任务状态时必需使用该值。

提交后提示

请向用户说明：

视频生成已启动！任务 ID： 视频生成通常耗时 30 秒至 5 分钟。 请使用 oatda-video-status 命令查询视频是否就绪。

错误处理

示例

Seedance（默认）

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X POST "https://oatda.com/api/v1/llm/generate-video?async=true" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OATDA_API_KEY" 
  -d '{
    "provider": "bytedance",
    "model": "seedance-1-5-pro-251215",
    "prompt": "Ocean waves crashing on a beach at sunset, golden hour lighting, cinematic",
    "model_params": {"ratio": "16:9", "duration": "5", "generate_audio": true, "camera_fixed": false}
  }'

Seedance 图生视频（Image-to-Video）

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X POST "https://oatda.com/api/v1/llm/generate-video?async=true" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OATDA_API_KEY" 
  -d '{
    "provider": "bytedance",
    "model": "seedance-1-5-pro-251215",
    "prompt": "Smooth transition from day to night",
    "model_params": {
      "ratio": "16:9",
      "first_frame_image": "https://example.com/daytime.jpg",
      "last_frame_image": "https://example.com/nighttime.jpg"
    }
  }'

MiniMax（带参考图像）

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X POST "https://oatda.com/api/v1/llm/generate-video?async=true" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OATDA_API_KEY" 
  -d '{
    "provider": "minimax",
    "model": "T2V-01",
    "prompt": "The character starts walking forward slowly",
    "model_params": {"first_frame_image": "https://example.com/character.png", "resolution": "720P"}
  }'

Google Veo

export OATDA_API_KEY="${OATDA_API_KEY:-$(cat ~/.oatda/credentials.json 2>/dev/null | jq -r '.profiles[.defaultProfile].apiKey' 2>/dev/null)}" && 
curl -s -X POST "https://oatda.com/api/v1/llm/generate-video?async=true" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OATDA_API_KEY" 
  -d '{
    "provider": "google",
    "model": "veo-3.0-generate-preview",
    "prompt": "A drone shot flying over a misty mountain range at sunrise",
    "duration": 5,
    "aspectRatio": "16:9"
  }'

注意事项

• URL 中必须始终包含 ?async=true
• 生成耗时因模型而异，通常为 30 秒至 5 分钟以上
• 务必向用户提供任务 ID，并推荐其使用 oatda-video-status 查询进度
• 图生视频场景下：需提供 first_frame_image（必填），以及可选的 last_frame_image，二者均为公开可访问的 URL
• 提示词最大长度：4000 字符
• 使用 oatda-video-status 查询任务完成状态
• 使用 oatda-list-models 查询当前支持的视频模型列表