> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# ファイルの取得

> 単一のアップロード済みファイルのメタデータを取得します。

## 概要

このエンドポイントは主に、TokenLab の OpenAI 互換 Batch API ファイルオブジェクトを対象としています。

リクエストが Anthropic Files 互換モードを選ぶ場合、同じルートはバインドされたワークスペース向けの Anthropic スタイルのファイルメタデータも返せます。

Anthropic ヘッダーがない場合、このルートはバッチファイルオブジェクトまたは TokenLab の画像/参照ファイルオブジェクトを返します。

## 注意事項

* バッチ入力ファイルは`purpose=batch`を使用する必要があります。
* 生成された出力ファイルに絞り込むには `purpose=batch_output` を使用してください。
* `completion_window`は現在`24h`です。
* 出力の順序は保証されていません。常に`custom_id`で一致させてください。
* バッチアイテム内でのストリーミングはサポートされていません。

## 例

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

## リクエスト / レスポンス

正確なスキーマについては、上記のインタラクティブなOpenAPIパネルを使用してください。

## 操作のヒント

* 冪等性のある下流の調整には`custom_id`を使用してください。
* ワーカーがバッチを最終化した後にのみ`output_file_id`と`error_file_id`を期待してください。
* バッチの価格は、`isBatchRequest=true`の割引ルールが適用されるため、同期価格とは異なる場合があります。

## レスポンス例

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "file_abc123",
    "object": "file",
    "bytes": 32768,
    "created_at": 1706000000,
    "filename": "batch-input.jsonl",
    "purpose": "batch"
  }
  ```
</ResponseExample>

## 重要フィールド

<ResponseField name="id" type="string">関連 API で使う file identifier です。</ResponseField>
<ResponseField name="filename" type="string">元のファイル名または生成されたファイル名です。</ResponseField>
<ResponseField name="purpose" type="string">所有するワークフローで使われるファイル purpose です。例: `batch`、`batch_output`、`user_data`、`vision`。</ResponseField>