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

# Create Batch

> Submit up to 50 videos for batch classification

Submit multiple videos for classification in a single request. Credits are pre-authorized upfront for all videos and refunded per-video on failure.

<ParamField body="videos" type="object[]" required>
  Array of videos to classify (max 50).

  <Expandable title="Video item fields">
    <ParamField body="video_url" type="string" required>
      Public HTTP/HTTPS URL of the video.
    </ParamField>

    <ParamField body="capabilities" type="string[]" default="[&#x22;classify&#x22;, &#x22;thumbnails&#x22;, &#x22;diagnostics&#x22;]">
      Capabilities to run on this video.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="processing_tier" type="string" default="basic">
  Processing tier applied to all videos: `basic`, `enhanced`, or `premium`.
</ParamField>

### Response (202 Accepted)

<ResponseField name="batch_id" type="string">
  Unique batch identifier for polling.
</ResponseField>

<ResponseField name="status" type="string">
  Always `"processing"` on submission.
</ResponseField>

<ResponseField name="total_videos" type="integer">
  Number of videos in the batch.
</ResponseField>

<ResponseField name="total_credits" type="integer">
  Total credits pre-authorized for all videos.
</ResponseField>

<ResponseField name="jobs" type="object[]">
  Per-video job summaries with `job_id`, `video_url`, `status`, and `credits_charged`.
</ResponseField>

<ResponseField name="poll_url" type="string">
  URL for polling batch status.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.fastdrop.io/api/v1/batch \
    -H "Content-Type: application/json" \
    -H "X-API-Key: fd_live_your_key_here" \
    -d '{
      "videos": [
        {"video_url": "https://example.com/video1.mp4"},
        {"video_url": "https://example.com/video2.mp4"},
        {"video_url": "https://example.com/video3.mp4"}
      ],
      "processing_tier": "basic"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 202 theme={null}
  {
    "batch_id": "batch_xyz789",
    "status": "processing",
    "total_videos": 3,
    "total_credits": 12,
    "jobs": [
      {
        "job_id": "a1b2c3d4-...",
        "video_url": "https://example.com/video1.mp4",
        "status": "queued",
        "credits_charged": 4
      },
      {
        "job_id": "e5f6g7h8-...",
        "video_url": "https://example.com/video2.mp4",
        "status": "queued",
        "credits_charged": 4
      },
      {
        "job_id": "i9j0k1l2-...",
        "video_url": "https://example.com/video3.mp4",
        "status": "queued",
        "credits_charged": 4
      }
    ],
    "poll_url": "/api/v1/batch/batch_xyz789",
    "created_at": "2026-03-05T12:00:00Z"
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "code": "batch_too_large",
      "message": "Batch exceeds maximum of 50 videos"
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.