> ## 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互換バッチAPIの一部です。バッチジョブはアップロードされたJSONLファイルを使用し、非同期で実行され、後で出力/エラーファイルを返すことができます。

## 注意事項

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

## 例

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/batches/batch_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": "batch_abc123",
    "object": "batch",
    "status": "completed",
    "input_file_id": "file_abc123",
    "output_file_id": "file_out123",
    "error_file_id": null,
    "request_counts": { "total": 100, "completed": 98, "failed": 2 }
  }
  ```
</ResponseExample>

## 重要フィールド

<ResponseField name="request_counts" type="object">このレスポンスで返されるリストまたは payload です。</ResponseField>
<ResponseField name="output_file_id" type="string|null">関連 API で使う file identifier です。</ResponseField>
<ResponseField name="error_file_id" type="string|null">関連 API で使う file identifier です。</ResponseField>