Batch Queue

The Batch Queue provides mass content production at economy-tier cost. It queues hundreds of generation tasks, manages priorities, and routes outputs to the right destination automatically.

How It Works

The Batch Queue routes high-volume tasks to the Economy tier (DeepSeek V4) for cost-efficient processing:

1. Submit batch items via the dashboard or API with type, prompt, and count
2. Items enter a priority queue managed by the Batch Runner agent
3. The runner processes items sequentially, respecting rate limits
4. Completed outputs are saved to the vault and reported via WebSocket
5. Failed items are automatically retried up to 3 times

Supported Batch Types

Type	Description	Typical Count
blog	Blog posts on specified topics	10-50
social	Social media posts with platform variants	20-100
product	Product descriptions and listings	10-200
email	Email sequences and templates	5-30
seo	SEO-optimized page content	10-100

API Usage

{
  "type": "blog",
  "prompt": "Write about sustainable tech trends",
  "count": 10,
  "priority": "normal"
}

Priority Levels

The Batch Queue offers three priority levels:

• high — Processed immediately, jumps to front of queue
• normal — Standard FIFO processing (default)
• low — Processed only when no higher-priority items remain

Rate Limiting

Batch operations are subject to rate limiting to manage API costs:

• Maximum 10 batch submissions per minute (heavy rate limiter)
• Maximum 100 items per single batch submission
• Economy-tier processing has provider-specific throughput limits
• Failed items use exponential backoff before retry

Dashboard View

The Batch view provides real-time monitoring:

• Queue depth and estimated completion time
• Per-item status tracking (queued, processing, complete, failed)
• Output preview with download options
• Cost estimation and actual spend tracking
• Bulk actions (pause, resume, cancel, re-queue failed)

Frequently Asked Questions

What is the Batch Queue?

Mass content production at economy-tier cost. It routes high-volume tasks to the Economy tier (DeepSeek V4), queues hundreds of generation tasks, manages priorities, and routes outputs to the right destination automatically.

What content types can I submit to the Batch Queue?

blog, social, product, email, and seo — each with a typical count ranging from 5-30 items (email) up to 10-200 items (product).

What happens if a batch item fails?

Failed items are automatically retried up to 3 times, using exponential backoff before each retry.

How do I submit a batch job through the API?

POST to /api/batch with a type, a prompt, a count, and an optional priority field. The endpoint is heavy rate limited.

What priority levels are available?

high jumps to the front of the queue and is processed immediately, normal is the default standard FIFO processing, and low is processed only when no higher-priority items remain.

How many items can I submit in one batch?

A maximum of 100 items per single batch submission, with a maximum of 10 batch submissions per minute under the heavy rate limiter.