# 新しいファイルを作成します。

新しいファイルをアップロードするには、まず File API を使用する必要があります。URL が発行されるので、その URL を使用してファイルをアップロードします。アップロードが完了したら、同じレスポンス内の file_id を使用して AI 機能を利用できます。

Endpoint: POST /s2s/v2.0/file/2d-vto/ring
Security: BearerAuthenticationV2

## Security:

  - `BearerAuthenticationV2` (unknown)
    http bearer

## Request fields (application/json):

  - `files` (array, required)

  - `files.content_type` (string, required)
    ファイルのコンテンツ MIME タイプを指定します。現在サポートされている値には、image/jpg や video/mp4 などの画像および動画形式が含まれます。
    Example: image/jpg

  - `files.file_name` (string, required)
    このファイルの名前
    Example: my-selfie.jpg

  - `files.file_size` (integer, required)
    バイト単位のファイルサイズ。サポートされている制限は、画像ファイルで 10 MB、動画ファイルで 100 MB です。
    Example: 50000

## Response 200:

  - `200` (unknown)
    ファイルアップロード情報の取得に成功しました

## Response 200 fields (application/json):

  - `files` (array)

  - `files.content_type` (string)
    このファイルのコンテンツ MIME タイプ。
    Example: image/jpg

  - `files.file_name` (string)
    このファイルの名前
    Example: my-selfie.jpg

  - `files.file_id` (string)
    このファイルの ID。他のタスク実行 API でこの `file_id` が必要になります。
    Example: U8aqJbsXGT537jtGnEDFHqxdDXqh8+oTF/cSkLimzuvVwMP+Jb1XbjPsf7ZgUgLY

  - `files.requests` (array)
    以下の `url`、`headers`、`method` を使用してファイルをアップロードします。完了後、`file_id` を使用してタスク実行 API の呼び出しを進めます。

  - `files.requests.headers` (object)
    ファイルのアップロード時に含めるヘッダー
    Example: {"Content-Type":"image/jpg","Content-Length":50000}

  - `files.requests.url` (string)
    このファイルをアップロードする URL
    Example: https://example.com/presigned-upload-url

  - `files.requests.method` (string)
    このファイルをアップロードするための HTTP メソッド
    Example: PUT

## Response 400:

  - `400` (unknown)
    無効なリクエストパラメータ

## Response 400 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 400

  - `error` (string)
    Example: Invalid parameter value

  - `error_code` (string)
    Example: InvalidParameters

## Response 401:

  - `401` (unknown)
    無効または欠落している API キー

## Response 401 fields (application/json):

  - `status` (integer)
    レスポンスステータス
    Example: 401

  - `error` (string)
    Example: Invalid API key