> ## 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.

# バッチの一覧

> 現在のAPIキー組織のバッチジョブを一覧表示します。

## 概要

このエンドポイントは、TokenLabのOpenAI互換バッチAPIの一部です。バッチジョブはアップロードされたJSONLファイルを使用し、非同期で実行され、後で出力/エラーファイルを返すことができます。

## 注意事項

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

## 例

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/batches?limit=20" \
    -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}
  {
    "object": "list",
    "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }]
  }
  ```
</ResponseExample>

## 重要フィールド

<ResponseField name="object" type="string">レスポンスの object type です。</ResponseField>
<ResponseField name="data" type="array">このレスポンスで返されるリストまたは payload です。</ResponseField>
<ResponseField name="status" type="string">このリソースの現在のライフサイクル状態です。</ResponseField>