動画をダウンロード

公開タスク ID で完了済み動画をダウンロードします。プラットフォーム API Key が必要です。本文はバイナリであり、JSON として解析しません。

GET/v1/videos/{task_id}/content

認証

bearerAuth

認証Bearer <token>

プラットフォーム API Key を使用：Authorization: Bearer your-api-key。

指定位置: header

task_id*string

プラットフォームが返す公開タスク ID。文字列として保存し、照会とダウンロードに使用します。request_id や入れ子の上流タスク ID は使用しません。

長さ1 <= length

curl -X GET "https://api.agtcloud.cn/v1/videos/TASK_ID/content" \
  -H "Authorization: Bearer your-api-key" \
  --output video.mp4

レスポンス例はありません

動画のバイナリ応答。実際の Content-Type に従って保存します。JSON の成功例はありません。

プラットフォーム照会の status: "completed"、またはネイティブ照会の output.task_status: "SUCCEEDED" を確認します。
作成時に返された公開タスク ID をパスに指定し、該当サイトの同じユーザーの API Key を使用します。
実際の Content-Type に従って保存します。cURL 例は --output video.mp4 でファイルへ書き込みます。

ダウンロードは新規タスクを作成しません。照会の metadata.url または output.video_url から直接保存することもできます。URL の失効前に保存してください。

未完了タスクは HTTP 400、不存在またはアクセス不可は HTTP 404 の場合があります。エラー本文は error を含む JSON の場合があります。HTTP 状態と内容タイプを確認し、エラーを動画として扱わないでください。