AI動画検出API
TruthScanのAI動画検出APIをアプリケーションに統合するための完全なドキュメントです。
コードを書かずに試すには、以下のFastAPIエンドポイントをご利用ください： https://detect-video.truthscan.com/docs
認証
TruthScanではAPIキーで認証を行います。APIキーは 開発者ポータル上部.
すべてのAPIリクエストにAPIキーを含める必要があります：
{
"key": "YOUR API KEY GOES HERE"
}YOUR API KEY GOES HERE を実際のAPIキーに置き換えてください。
AI動画検出
検出（2ステップ）
AI動画検出は以下の手順で実行されます：
- 動画を送信
- 結果を取得
1. 動画を送信
動画ファイルをAPIへアップロードします。
対応形式
MP4, MOV, AVI, MKV, WEBM
サイズ制限
- 最小: 1KB
- 最大: 100MB
POST https://detect-video.truthscan.com/detect-fileリクエスト例
curl -X POST \
'https://detect-video.truthscan.com/detect-file' \
-H 'accept: application/json' \
-H 'key: YOUR-API-KEY-GOES-HERE' \
-F 'file=@/path/to/video.mp4;type=video/mp4'任意パラメータ
document_type: ドキュメント種別（デフォルト: Video）email: 通知用メールアドレス
レスポンス例
{
"id": "77565038-9e3d-4e6a-8c80-e20785be5ee9",
"status": "pending"
}レスポンスには動画IDが含まれます。
2. 結果を取得
/queryエンドポイントで結果を取得します。
POST https://detect-video.truthscan.com/queryリクエスト例
curl -X POST 'https://detect-video.truthscan.com/query' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"id":"JOB-ID-GOES-HERE"}'レスポンス例
{
"id": "bfd136fc-666b-42d0-89cf-0e9690c98f21",
"status": "done",
"result": 0.101969311406719,
"result_details": {
"final_stage": "watermark",
"metadata": {
"status": "ok",
"prediction": "no_detection",
"confidence": 0.0
},
"watermark": {
"prediction": "ai_generated (watermark)",
"confidence": 1.0
},
"ml": {
"aggregate": {
"prob_fake": 0.1019693114067195,
"label": "cancelled",
"n_frames": 256,
"latency_sec": 23.319
}
},
"latency_sec": 24.017
},
"preview_url": null
}結果詳細
status: "pending" / "analyzing" / "done" / "failed"result: 0.0〜1.0のスコアfinal_stage: 最終判定ステージmetadata: メタデータ分析watermark: 透かし分析ml: 機械学習分析latency_sec: 処理時間
statusは処理状態を示します。
クレジット確認
APIキーを使用して残りクレジットを確認します。
GET https://detect-video.truthscan.com/check-user-creditsリクエスト例
curl -X 'GET' \
'https://detect-video.truthscan.com/check-user-credits' \
-H 'apikey: YOUR API KEY GOES HERE' \
-H 'accept: application/json' \
-H 'Content-Type: application/json'レスポンス例
{
"baseCredits": 10000,
"boostCredits": 1000,
"credits": 11000
}ヘルスチェック
APIの状態を確認します。
GET https://detect-video.truthscan.com/healthリクエスト例
curl -X 'GET' \
'https://detect-video.truthscan.com/health' \
-H 'accept: application/json'レスポンス例
{
"status": "healthy"
}エラー
多くのエラーは不正なパラメータによるものです。
以下は主なエラーコードです：
| コード | 内容 |
|---|---|
| 400 | 不正なリクエスト |
| 403 | 認証エラーまたはクレジット不足 |
| 404 | リソースが存在しません |
| 429 | リクエスト過多 |
| 500 | サーバーエラー |
よくある問題と解決策
認証の問題
"User verification failed" (403)
原因: APIキーが無効または期限切れです
解決策:
- APIキーが正しいことを確認してください
- アカウントでAPIキーが有効か確認してください
- 必要に応じてAPIキーを再発行してください
"Not enough credits" (403)
原因: 動画処理のクレジットが不足しています
解決策:
- /check-user-credits で残りクレジットを確認してください
- 必要に応じてクレジットを追加購入してください
入力検証の問題
"Unsupported video type" (400)
原因: サポートされていないファイル形式です
解決策:
- MP4、MOV、AVI、MKV、WEBM などの対応形式に変換してください
- 拡張子とMIMEタイプが一致しているか確認してください
"File size exceeds limit" (400)
原因: 動画ファイルが大きすぎます
解決策:
- 圧縮・トリミング・再エンコードして100MB以下にしてください
- より効率的なコーデック／コンテナを使用してください
"File size is too small" (400)
原因: 動画ファイルが最小サイズ要件を下回っています
解決策:
- より大きな動画ファイルを使用してください（最小1KB）
- アップロード中にファイルが破損していないか確認してください
"Invalid file type" (400)
原因: ファイル形式の検証に失敗しました（MIMEタイプの不一致や破損など）
解決策:
- 有効な動画形式であることを確認してください
- MIMEタイプが拡張子と一致しているか確認してください
- 必要に応じて再エクスポートまたは再エンコードしてください
処理の問題
動画ステータス "failed"
原因: 処理に失敗しました（読み取り不能なコンテナ、デコードエラーなど）
解決策:
- 一般的にサポートされているコンテナ／コーデックを使用してください（MP4のH.264/AAC推奨）
- ffmpegなどで標準プリセットに再エンコードして再アップロードしてください
- サイズと形式の要件を満たしているか確認してください
動画ステータス "timeout" または処理が長い
原因: 動画処理に予想以上の時間がかかっているか、タイムアウトしました
解決策:
- しばらく待ってから /query でステータスを再確認してください
- 動画ファイルが形式・サイズの要件を満たしているか確認してください
- 解決しない場合はサポートにお問い合わせください
"User not found"
原因: ユーザーIDが無効です
解決策:
- APIキーが正しく有効なアカウントに紐づいているか確認してください
- 連携ユーザーが有効か確認してください
- 必要に応じて再認証してください
"File metadata could not be fetched" (500)
原因: アップロードされたファイルにアクセスまたは解析できません
解決策:
- アップロードが正常に完了したか確認してください
- ファイルが破損していないか確認してください
- ファイルを再アップロードしてください
よくある質問
AI動画検出APIに関するFAQ