OATDA Video Status

通过 OATDA 视频状态接口按任务 ID 查询异步视频生成任务进度，返回 pending、processing、completed、failed 状态以及视频地址、费用信息，并给出 401、404、429 等错误处理提示；需要 OATDA API Key，可从环境变量或本地凭据文件读取。

devcsde

热度 39.74

最近更新 2026-05-11 17:39:51

分类：自动化依赖：第三方 API / 代码执行 / 读写文件应用场景：API 集成 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add oatda-video-status

Metadata

name: oatda-video-status
description: Check the status of an asynchronous video generation task from OATDA. Triggers when the user wants to check if a video is done generating, retrieve the video URL after completion, or poll the status of a video task by its task ID. Use after oatda-generate-video to get results.
homepage: https://oatda.com
metadata: {"openclaw":{"emoji":"📹","requires":{"bins":["curl","jq"],"env":["OATDA_API_KEY"],"config":["~/.oatda/credentials.json"]},"primaryEnv":"OATDA_API_KEY"}}

OATDA Video Status

Check the status of asynchronous video generation tasks. Companion to oatda-generate-video.

API Key Resolution

All commands need the OATDA API key. Resolve it inline for each exec call:

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

If the key is empty or null, tell the user to get one at https://oatda.com and configure it.

Security: Never print the full API key. Only verify existence or show first 8 chars.

Prerequisites

The user must provide a task ID from a previous oatda-generate-video call. If they don't have one, tell them to generate a video first.

API Call

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/video-status/<TASK_ID>" \
  -H "Authorization: Bearer $OATDA_API_KEY"

Replace <TASK_ID> with the actual task ID. URL-encode if it contains special characters.

Response Format

{
  "taskId": "minimax-T2V01-abc123def456",
  "status": "completed",
  "videoUrl": "https://cdn.example.com/video.mp4",
  "directVideoUrl": "https://cdn.example.com/video-direct.mp4",
  "provider": "minimax",
  "model": "T2V-01",
  "createdAt": "2026-01-15T10:30:00Z",
  "completedAt": "2026-01-15T10:32:15Z",
  "costs": {
    "totalCost": 0.05,
    "currency": "USD"
  }
}

Status Handling

Status	What to tell the user
`pending`	"Your video is queued and hasn't started yet. Check again in a minute."
`processing`	"Your video is being generated. Check again in a minute."
`completed`	"Your video is ready!" — show `videoUrl` (or `directVideoUrl`). Mention cost if available.
`failed`	"Video generation failed." — show `errorMessage` if present. Suggest retrying with different prompt.

Error Handling

HTTP Status	Meaning	Action
401	Invalid API key	Tell user to check their key
404	Task not found	Verify task ID is correct. Tasks may expire.
429	Rate limited	Wait and retry

Example

User: "Check status of video task minimax-T2V01-abc123"

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/video-status/minimax-T2V01-abc123" \
  -H "Authorization: Bearer $OATDA_API_KEY"

If completed: "Your video is ready! Download: <videoUrl> — Cost: $0.05" If processing: "Still generating. Try again in about a minute."

Notes

This is a GET request — no request body needed
Video generation typically takes 30 seconds to 5 minutes
Video URLs may be temporary — recommend downloading promptly
If processing, suggest waiting 30-60 seconds before rechecking
Use oatda-generate-video to start a new video generation