> ## 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 POST "https://api.tokenlab.sh/v1/batches/batch_abc123/cancel" \
    -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": "cancelling",
    "input_file_id": "file_abc123"
  }
  ```
</ResponseExample>

## 重要フィールド

<ResponseField name="id" type="string">後続呼び出しとサポート調査に使う識別子です。</ResponseField>
<ResponseField name="status" type="string">このリソースの現在のライフサイクル状態です。</ResponseField>