SYNTHETIQ VISION API ユーザガイド

SYNTHETIQ VISION APIは入力したメディアファイル（顔動画、顔画像、一般画像、発話音声）が、AI等により生成されたものであるかどうかを検出するディープフェイク検出プログラムです。顔動画・顔画像の場合は顔領域ごとの真贋判定を、一般画像の場合は画像全体の真贋判定を、発話音声の場合は一定時間の区間ごとの真贋判定を行います。この資料ではSYNTHETIQ VISION APIの利用方法を説明します。

processed movie

はじめに

SYNTHETIQ VISION APIを利用するためには、SYNTHETIQ VISION APIサーバのURL、認証用APIトークンが必要になります。こちら2点の詳細および真贋検出の対象であるメディアファイルの条件は、以下の通りです。

SYNTHETIQ VISION APIサーバのURL
- SYNTHETIQ VISION APIのリクエスト先になります。
  - e.g. https://...
- こちらはSYNTHETIQ VISION APIサーバの管理者に問い合わせください。
- 本ページ中では<api-url>と表現します。
APIトークン
- SYNTHETIQ VISION APIの使用時において、リクエストヘッダーに必要なトークンです。こちらAPIの認証に使用されます。
  - e.g. xxxx.xxxx.xxxx
- こちらも同様にSYNTHETIQ VISION APIサーバの管理者に問い合わせ、トークンを入手してください。
- 本ページ中では<your-api-token>と表現します。

真贋検出を行うメディアファイルの条件
- 映像ファイル（顔動画）
  - 人の顔がはっきり大きく写っていること
    - もし顔が小さい／鮮明でない場合、検出されない可能性があります。
  - 注意：本システムは、各制約を個別に検証しておりますが、すべての制約を組み合わせて評価していません。組み合わせによっては、動画を処理できない可能性があります。
  - デフォルトの設定で利用可能なファイルの条件は以下の通りです。
    
    Attribute Limit
    
    File size ~100 MB
    
    Duration ~3600 sec
    
    Width 360~4096 px
    
    Height 270~2160 px
    
    FPS 14~60 fps
  - サポートされている映像のフォーマットおよびコーデックは以下の通りです。
    
    Format Codec
    
    mp4 h264
    
    mp4 hevc
    
    webm vp9
    
    avi h264
    
    avi mpeg4
- 静止画ファイル（顔画像）
  - 人の顔がはっきり大きく写っていること
    - もし顔が小さい／鮮明でない場合、検出されない可能性があります。
  - デフォルトの設定で利用可能な静止画ファイルの条件は以下の通りです。
    
    Attribute Limit
    
    File size ~50 MB
    
    Width 360~4096 px
    
    Height 270~2160 px
  - サポートされている静止画のフォーマットは以下の通りです。
    
    Format
    
    JPEG (.jpg, .jpeg)
    
    PNG (.png)
- 静止画ファイル（一般画像）
  - 画像全体の真贋判定を行います（顔検出は行いません）
  - デフォルトの設定で利用可能な一般画像ファイルの条件は以下の通りです。
    
    Attribute Limit
    
    File size ~50 MB
    
    Width 360~4096 px
    
    Height 270~2160 px
  - サポートされている一般画像のフォーマットは以下の通りです。
    
    Format
    
    JPEG (.jpg, .jpeg)
    
    PNG (.png)
- 音声ファイル（発話音声）
  - 人の発話（話し声）を対象とします。音楽や環境音のみの音声は対象外です。
  - 音声を一定時間の区間（デフォルトは8秒）に分割し、区間ごとに真贋判定を行います。発話が十分に含まれない区間（無音・雑音のみ、発話が短い等）は判定対象外となり、結果には含まれません。このため、短い音声では真贋検出値が得られない場合があります。区間の長さや判定対象となる条件の詳細は、APIの詳細を参照してください。
  - デフォルトの設定で利用可能な音声ファイルの条件は以下の通りです。
    
    Attribute Limit
    
    File size ~50 MB
    
    Duration 2~600 sec
    
    Sample rate 16 kHz~
    
    Channels 制限なし（先頭の1チャンネルのみを解析）
  - サポートされている音声のフォーマットは以下の通りです。
    
    Format Encoding
    
    WAV (.wav) PCM
    
    WAV (.wav) IEEE float
  - 推奨は16 kHz・モノラルのWAVです。これより高いサンプリングレートを用いても精度は向上しません。
  - 上記の条件は投稿を受理する条件です。真贋検出値を得るには、加えて区間に十分な発話が含まれている必要があります（前述）。
  - 動画ファイルや他の形式の音声ファイルは、事前にWAVへ変換してから投稿してください。以下はffmpegによる変換例です（音声トラックを取り出し、16 kHz・モノラル・16 bit PCMのWAVにします）。
    ffmpeg -i <input-file> -vn -ac 1 -ar 16000 -c:a pcm_s16le <output.wav>
    - 注意: 動画配信サービスやSNSで配信された音声は、すでに非可逆圧縮されています。WAVへ変換しても元の音質には戻らず、圧縮による影響は真贋判定の結果にも残ります。

Attribute	Limit
File size	~100 MB
Duration	~3600 sec
Width	360~4096 px
Height	270~2160 px
FPS	14~60 fps

Format	Codec
mp4	h264
mp4	hevc
webm	vp9
avi	h264
avi	mpeg4

Attribute	Limit
File size	~50 MB
Width	360~4096 px
Height	270~2160 px

Format
JPEG (.jpg, .jpeg)
PNG (.png)

Attribute	Limit
File size	~50 MB
Width	360~4096 px
Height	270~2160 px

Format
JPEG (.jpg, .jpeg)
PNG (.png)

Attribute	Limit
File size	~50 MB
Duration	2~600 sec
Sample rate	16 kHz~
Channels	制限なし（先頭の1チャンネルのみを解析）

Format	Encoding
WAV (.wav)	PCM
WAV (.wav)	IEEE float

用語

真贋検出値
- 投稿したメディアファイルを真贋検出した結果として得られる値
- 顔領域、リアル/フェイク等の情報を含む。動画の場合、フレーム番号などの時系列情報を含む。
- 発話音声の場合、区間の開始・終了時刻（ミリ秒）ごとのリアル/フェイク判定とスコアを含む（顔領域の情報は含まない）。
真贋動画
- 投稿した動画に対して、真贋検出の結果をオーバーレイした動画。
  - 緑色のバウンディングボックス: リアルと検出された顔画像
  - 赤色のバウンディングボックス: フェイクと検出された顔画像
- 真贋動画には音声トラックは含まれません。
- フォーマットおよびコーデックは、以下のいずれかになります。
  
  Format Codec
  
  webm vp9
  
  mp4 h264
  - 動画再生時には、お使いの再生プレーヤーにデコーダー・コーデックをインストールください。
- 真贋検出結果の例
真贋検出結果トークン
- 投稿したメディアファイルについて、その処理進捗の取得や、その真贋検出値および真贋動画を取得する際に使用します。

Format	Codec
webm	vp9
mp4	h264

基本の流れ

顔動画の場合

動画の投稿
処理進捗の取得
真贋検出値の取得
真贋動画の取得

顔画像の場合

画像の投稿
処理進捗の取得
真贋検出値の取得

一般画像の場合

一般画像の投稿
処理進捗の取得
真贋検出値の取得

発話音声の場合

発話音声の投稿
処理進捗の取得
真贋検出値の取得

顔動画の場合

sequenceDiagram
  actor U as User
  participant API as SYNTHETIQ VISION API

  Note left of U: APIの利用には、常にAPIトークンが必要です。

  U->>+API: 動画の投稿 + 真贋動画要求=True/False
  API-->>-U: 真贋検出結果トークン

  Note left of U: 投稿した動画に関する以降のリクエストに、<br>ここで得た真贋検出結果トークンを使用します。

  U->>+API: 処理進捗の取得
  API-->>-U: 処理進捗の状態

  Note left of U: 以降のリクエストは、<br>ここで処理進捗の状態=完了である事が必要です。

  U->>+API: 真贋検出値の取得
  API-->>-U: 真贋検出値

  U->>+API: 真贋動画の取得
  alt 真贋動画要求=True
    API-->>U: 真贋動画
  else 真贋動画要求=False
    API-->>-U: 失敗
  end

顔画像の場合

sequenceDiagram
  actor U as User
  participant API as SYNTHETIQ VISION API

  Note left of U: APIの利用には、常にAPIトークンが必要です。

  U->>+API: 顔画像の投稿
  API-->>-U: 真贋検出結果トークン

  Note left of U: 投稿した画像に関する以降のリクエストに、<br>ここで得た真贋検出結果トークンを使用します。

  U->>+API: 処理進捗の取得
  API-->>-U: 処理進捗の状態

  Note left of U: 以降のリクエストは、<br>ここで処理進捗の状態=完了である事が必要です。

  U->>+API: 真贋検出値の取得（顔領域ごと）
  API-->>-U: 真贋検出値

一般画像の場合

sequenceDiagram
  actor U as User
  participant API as SYNTHETIQ VISION API

  Note left of U: APIの利用には、常にAPIトークンが必要です。

  U->>+API: 一般画像の投稿
  API-->>-U: 真贋検出結果トークン

  Note left of U: 投稿した画像に関する以降のリクエストに、<br>ここで得た真贋検出結果トークンを使用します。

  U->>+API: 処理進捗の取得
  API-->>-U: 処理進捗の状態

  Note left of U: 以降のリクエストは、<br>ここで処理進捗の状態=完了である事が必要です。

  U->>+API: 真贋検出値の取得（画像全体）
  API-->>-U: 真贋検出値

発話音声の場合

sequenceDiagram
  actor U as User
  participant API as SYNTHETIQ VISION API

  Note left of U: APIの利用には、常にAPIトークンが必要です。

  U->>+API: 発話音声の投稿
  API-->>-U: 真贋検出結果トークン

  Note left of U: 投稿した音声に関する以降のリクエストに、<br>ここで得た真贋検出結果トークンを使用します。

  U->>+API: 処理進捗の取得
  API-->>-U: 処理進捗の状態

  Note left of U: 以降のリクエストは、<br>ここで処理進捗の状態=完了である事が必要です。

  U->>+API: 真贋検出値の取得（区間ごと）
  API-->>-U: 真贋検出値

以降で、各リクエストの実行方法を説明します。

基本の利用方法

curlコマンドによる実行

注意点

もし以下のWarningが発生した場合は、curlコマンドを実行する際に--insecureオプションを追加すると実行可能になります。

  # Warning
  curl: (60) SSL certificate problem: self signed certificate More details here: https://curl.haxx.se/docs/sslcerts.html

  curl --insecure ...

使用方法

curlコマンドによる基本の流れの各ステップの実行方法は以下の通りです。

動画の投稿
1. 以下のコマンドでリクエストを送信することで、動画を投稿できます。
```
 curl -X 'POST' \
   '<api-url>/api/v1/movies?is_processed_movie_file_requested=<true-or-false>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>' \
   -H 'Content-Type: multipart/form-data' \
   -F 'movie_file=@<movie-file-path>;type=video/<type>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <true-or-false>: 真贋動画要求
      - true: 真贋動画の取得が可能になります
      - false: 真贋動画の作成を要求しません。
    - <your-api-token>: APIトークン
    - <movie-file-path>: 投稿する動画ファイルのパス
    - <type>: 投稿する動画ファイルのタイプ
      - 動画の形式に合わせて、設定してください。
      - typeの種類：iana / Media Types / video
      - e.g. mp4の場合、type=video/mp4
2. 正常に投稿が完了した場合、以下の真贋検出結果トークン（json）をレスポンスとして取得します。この情報は以降のリクエストで使用します。
```
 {
   "hash_": <hash-of-the-movie>,
   "pub_fake_detection_process_event_id": <pub-fake-detection-process-event-id-of-the-movie>
 }
```
  - <hash-of-the-movie>: 真贋検出結果トークンのハッシュ値
  - <pub-fake-detection-process-event-id-of-the-movie>: 公開真贋処理イベントID
処理進捗の取得
1. 以下のコマンドでリクエストを送信することで、投稿した動画の処理進捗の状態をレスポンスとして確認できます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/movies/progress?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-movie>&hash_=<hash-of-the-movie>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-movie>: 公開真贋処理イベントID
    - <hash-of-the-movie>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
2. レスポンスが以下のようにfinishedとなっていれば、真贋検出処理が完了しており、以降のコマンドで検出結果を取得できます。
```
 {
   "progress": "finished"
 }
```
真贋検出値の取得
1. 以下のコマンドで真贋検出値の取得をリクエストできます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/movies/values?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-movie>&hash_=<hash-of-the-movie>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-movie>: 公開真贋処理イベントID
    - <hash-of-the-movie>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
真贋動画の取得
1. 以下のコマンドで真贋動画の取得をリクエストできます。
```
 # この場合、真贋動画ファイルはカレントディレクトリに保存されます。
 curl -OJ -X 'GET' \
   '<api-url>/api/v1/movies?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-movie>&hash_=<hash-of-the-movie>' \
   -H 'accept: video/mp4' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-movie>: 公開真贋処理イベントID
    - <hash-of-the-movie>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン

顔画像の場合

顔画像の投稿
1. 以下のコマンドでリクエストを送信することで、画像を投稿できます。
```
 curl -X 'POST' \
   '<api-url>/api/v1/images' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>' \
   -H 'Content-Type: multipart/form-data' \
   -F 'image_file=@<image-file-path>;type=image/<type>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <your-api-token>: APIトークン
    - <image-file-path>: 投稿する画像ファイルのパス
    - <type>: 投稿する画像ファイルのタイプ
      - 画像の形式に合わせて、設定してください。
      - e.g. jpegの場合、type=image/jpeg、pngの場合、type=image/png
2. 正常に投稿が完了した場合、以下の真贋検出結果トークン（json）をレスポンスとして取得します。この情報は以降のリクエストで使用します。
```
 {
   "hash_": <hash-of-the-image>,
   "pub_fake_detection_process_event_id": <pub-fake-detection-process-event-id-of-the-image>
 }
```
  - <hash-of-the-image>: 真贋検出結果トークンのハッシュ値
  - <pub-fake-detection-process-event-id-of-the-image>: 公開真贋処理イベントID
処理進捗の取得
1. 以下のコマンドでリクエストを送信することで、投稿した画像の処理進捗の状態をレスポンスとして確認できます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/images/progress?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-image>&hash_=<hash-of-the-image>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-image>: 公開真贋処理イベントID
    - <hash-of-the-image>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
2. レスポンスが以下のようにfinishedとなっていれば、真贋検出処理が完了しており、以降のコマンドで検出結果を取得できます。
```
 {
   "progress": "finished"
 }
```
真贋検出値の取得
1. 以下のコマンドで真贋検出値の取得をリクエストできます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/images/values?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-image>&hash_=<hash-of-the-image>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-image>: 公開真贋処理イベントID
    - <hash-of-the-image>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
  - 注意: 顔画像の場合、処理済み画像をダウンロードするエンドポイントは提供されていません。真贋検出値のみ取得可能です。

一般画像の場合

一般画像の投稿
1. 以下のコマンドでリクエストを送信することで、一般画像を投稿できます。
```
 curl -X 'POST' \
   '<api-url>/api/v1/images/general' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>' \
   -H 'Content-Type: multipart/form-data' \
   -F 'image_file=@<image-file-path>;type=image/<type>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <your-api-token>: APIトークン
    - <image-file-path>: 投稿する一般画像ファイルのパス
    - <type>: 投稿する画像ファイルのタイプ
      - 画像の形式に合わせて、設定してください。
      - e.g. jpegの場合、type=image/jpeg、pngの場合、type=image/png
2. 正常に投稿が完了した場合、以下の真贋検出結果トークン（json）をレスポンスとして取得します。この情報は以降のリクエストで使用します。
```
 {
   "hash_": <hash-of-the-general-image>,
   "pub_fake_detection_process_event_id": <pub-fake-detection-process-event-id-of-the-general-image>
 }
```
  - <hash-of-the-general-image>: 真贋検出結果トークンのハッシュ値
  - <pub-fake-detection-process-event-id-of-the-general-image>: 公開真贋処理イベントID
処理進捗の取得
1. 以下のコマンドでリクエストを送信することで、投稿した一般画像の処理進捗の状態をレスポンスとして確認できます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/images/general/progress?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-general-image>&hash_=<hash-of-the-general-image>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-general-image>: 公開真贋処理イベントID
    - <hash-of-the-general-image>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
2. レスポンスが以下のようにfinishedとなっていれば、真贋検出処理が完了しており、以降のコマンドで検出結果を取得できます。
```
 {
   "progress": "finished"
 }
```
真贋検出値の取得
1. 以下のコマンドで真贋検出値の取得をリクエストできます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/images/general/values?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-general-image>&hash_=<hash-of-the-general-image>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-general-image>: 公開真贋処理イベントID
    - <hash-of-the-general-image>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
  - 注意: 一般画像の場合、顔検出は行わず画像全体の真贋判定結果のみが返されます。真贋検出値には顔領域の座標情報（x_px, y_px, w_px, h_px）は含まれません。

発話音声の場合

発話音声の投稿

以下のコマンドでリクエストを送信することで、発話音声を投稿できます。
```
 curl -X 'POST' \
   '<api-url>/api/v1/speech' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>' \
   -H 'Content-Type: multipart/form-data' \
   -F 'speech_file=@<speech-file-path>;type=audio/wav'
```
- プレースホルダー
  - <api-url>: SYNTHETIQ VISION APIサーバのURL
  - <your-api-token>: APIトークン
  - <speech-file-path>: 投稿する音声ファイル（WAV）のパス
正常に投稿が完了した場合、以下の真贋検出結果トークン（json）をレスポンスとして取得します。この情報は以降のリクエストで使用します。
```
 {
   "hash_": <hash-of-the-speech>,
   "pub_fake_detection_process_event_id": <pub-fake-detection-process-event-id-of-the-speech>
 }
```
- <hash-of-the-speech>: 真贋検出結果トークンのハッシュ値
- <pub-fake-detection-process-event-id-of-the-speech>: 公開真贋処理イベントID

投稿した音声ファイルが条件（フォーマット・ファイルサイズ・長さ・サンプリングレート）を満たさない場合、投稿はHTTPステータス415（Unsupported Media Type）で拒否されます。レスポンスのdetailに理由が示されます。

`detail`	理由
`Too Large File Size`	ファイルサイズが上限を超えている
`Sample Rate Too Low`	サンプリングレートが下限未満
`No Valid Speech File`	WAV以外のフォーマット、読み取れないファイル、または長さが範囲外

処理進捗の取得
1. 以下のコマンドでリクエストを送信することで、投稿した音声の処理進捗の状態をレスポンスとして確認できます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/speech/progress?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-speech>&hash_=<hash-of-the-speech>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-speech>: 公開真贋処理イベントID
    - <hash-of-the-speech>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
2. レスポンスが以下のようにfinishedとなっていれば、真贋検出処理が完了しており、以降のコマンドで検出結果を取得できます。
```
 {
   "progress": "finished"
 }
```
真贋検出値の取得
1. 以下のコマンドで真贋検出値の取得をリクエストできます。
```
 curl -X 'GET' \
   '<api-url>/api/v1/speech/values?pub_fake_detection_process_event_id=<pub-fake-detection-process-event-id-of-the-speech>&hash_=<hash-of-the-speech>' \
   -H 'accept: application/json' \
   -H 'Api-Token: <your-api-token>'
```
  - プレースホルダー
    - <api-url>: SYNTHETIQ VISION APIサーバのURL
    - <pub-fake-detection-process-event-id-of-the-speech>: 公開真贋処理イベントID
    - <hash-of-the-speech>: 真贋検出結果トークンのハッシュ値
    - <your-api-token>: APIトークン
2. レスポンスの例は以下の通りです。
```
 {
   "fake_thresh": 0.5,
   "values": [
     {
       "segment_idx": 0,
       "start_ms": 0,
       "end_ms": 8000,
       "is_fake": true,
       "fake_score": 0.9994
     }
   ]
 }
```
  - fake_thresh: 真贋判定の閾値。fake_scoreがこの値以上の区間がフェイクと判定されます。
  - values: 判定した区間ごとの真贋検出値（start_msの昇順）
    - segment_idx: 区間の番号（0始まり）
    - start_ms, end_ms: 区間の開始・終了時刻（投稿した音声の先頭からのミリ秒）。区間はstart_ms以上end_ms未満の半開区間です。デフォルトの設定（区間長8秒・区間の重なりなし）では、segment_idxが連続する2つの区間で前の区間のend_msと次の区間のstart_msは同じ値になります。
    - is_fake: フェイク判定（true: フェイク、false: リアル）
    - fake_score: フェイクらしさのスコア（0~1。大きいほどフェイクの可能性が高い）
  - 注意
    - 発話が十分に含まれない区間（無音・雑音のみ等）など、判定対象外となった区間はvaluesに含まれません。そのためsegment_idxは連続しないことがあり、判定可能な区間が1つもない場合はvaluesが空（[]）になります。判定対象となる条件の詳細は、APIの詳細を参照してください。
    - valuesが空（[]）であることは「リアルと判定された」という意味ではなく、「判定できる区間がなかった」という意味です。
    - 音声ファイル全体の真贋を判断する方法は利用者の目的により異なります。例えば「いずれかの区間でis_fakeがtrue（fake_scoreの最大値がfake_thresh以上）であればフェイクの疑いあり」とする判断が考えられます。
    - 発話音声の場合、処理済みファイル（真贋動画に相当するもの）をダウンロードするエンドポイントは提供されていません。真贋検出値のみ取得可能です。

APIの詳細

ブラウザにより、以下のURLで確認できます。
```
<api-url>/docs
<api-url>/redoc
```
- /docs, /redoc
  - Interactive API documentation and exploration web user interfaces.
  - /docs: Swagger UI
  - /redoc: Redoc
  - これらのページは、画面の表示に必要なファイルをインターネット上のCDNから読み込みます。インターネットに接続できない環境では表示されない場合があります。その場合は、以下のURLでAPI仕様（OpenAPI形式のJSON）を直接取得できます。
```
<api-url>/api/v1/openapi.json
```

FAQ

Q: APIが使用できません。

A: 以下の情報を、管理者に送付し相談を受けてください。

curlによるAPIの実行コマンド
エラーメッセージ
投稿したメディアファイル（動画・画像・音声）
APIトークン
真贋検出結果トークン

Q: 処理進捗がfinishedになりません。

A: 処理には時間がかかる場合があります。しばらく待ってもwaitingまたはprocessingのまま変わらない場合は、上記の情報を管理者に送付し相談を受けてください。

SYNTHETIQ VISION API ユーザガイド

目次

はじめに

用語

基本の流れ

顔動画の場合

顔画像の場合

一般画像の場合

発話音声の場合

顔動画の場合

顔画像の場合

一般画像の場合

発話音声の場合

基本の利用方法

curlコマンドによる実行

注意点

使用方法

顔画像の場合

一般画像の場合

発話音声の場合

APIの詳細

FAQ