5 分钟快速开始

本页演示视频任务的通用流程。模型专属的参数和当前价格由模型广场维护。

1. 保存 API Key

在 RouterBee 控制台创建 API Key，然后在 macOS 或 Linux 终端运行：

read -s ROUTERBEE_API_KEY
export ROUTERBEE_API_KEY

粘贴密钥后按 Enter。输入不会显示在屏幕上。不要把真实密钥写进仓库或发送给他人。

2. 选择并确认模型

在模型广场打开视频模型的详情页，确认它支持 /v1/videos，并查看该模型所需的参数及价格。记下完整模型 ID：

read -r MODEL_ID
export MODEL_ID

查询当前密钥实际可用的模型：

curl --silent --show-error --fail-with-body \
  'https://routerbee.com/v1/models' \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY"

确认响应的 data[].id 中包含你选的 MODEL_ID。模型广场的公开展示不等于当前密钥一定有调用权限。

3. 创建视频任务

以下示例需要 jq，只发送通用字段。如果模型详情页要求时长、尺寸或其他必填参数，请按详情页补充请求体：

REQUEST_BODY=$(jq -n --arg model "$MODEL_ID" \
  --arg prompt 'A bee flying over a city at sunset' \
  '{model: $model, prompt: $prompt}')

CREATE_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST 'https://routerbee.com/v1/videos' \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$CREATE_RESPONSE" | jq -r '.task_id // .id // empty')
test -n "$TASK_ID" || { echo '响应中没有任务 ID'; exit 1; }
echo "任务 ID：$TASK_ID"

不要重复创建

视频生成是异步任务。等待期间使用任务 ID 查询状态，不要重新发送创建请求。当前入口不承诺 Idempotency-Key 能在所有链路中去重。

4. 查询状态

curl --silent --show-error --fail-with-body \
  "https://routerbee.com/v1/videos/$TASK_ID" \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY"

状态为 queued 或 in_progress 时，间隔数秒再次查询；failed 时查看 error。状态为 completed 后进入下一步。

5. 下载视频

curl --fail --show-error --location \
  "https://routerbee.com/v1/videos/$TASK_ID/content" \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY" \
  --output routerbee-video.mp4

下载接口返回视频二进制内容。完整字段、响应和错误处理见视频 API 参考与故障排查。