Upload Batch Manifest File | SoferAi

from soferai import SoferAI
from soferai.transcribe import BatchManifestAudioSource, BatchFileMetadata
client = SoferAI(
    api_key="YOUR_TOKEN_HERE",
)
client.batch_transcribe.upload_batch_file(
    content_type="json",
    json_items=[
        BatchManifestAudioSource(
            audio_url="https://example.com/shiur1.mp3",
            title="Parshas Bereishis - Rabbi Cohen",
            client_item_id="bereishis",
        ),
        BatchManifestAudioSource(
            audio_url="https://example.com/shiur2.mp3",
            title="Parshas Noach - Rabbi Cohen",
            client_item_id="noach",
        ),
        BatchManifestAudioSource(
            audio_url="https://example.com/shiur3.mp3",
            title="Parshas Lech Lecha - Rabbi Cohen",
            client_item_id="lech_lecha",
        )
    ],
    metadata=BatchFileMetadata(
        title="Rabbi Cohen Weekly Parsha Series",
        description="Shiurim from Fall 2024",
    ),
)

Upload a batch manifest containing audio URLs for standard mode batch processing.

Workflow:

Upload your manifest here to get a batch_file_id
Use that ID in Create Batch Transcription with processing_mode: "standard"

The manifest is a list of audio sources (max 500), each with a URL and optional title or client_item_id. If you provide client_item_id, it must be unique within the manifest. You can provide it as a JSON array or JSONL format. If you need higher limits, contact support@sofer.ai.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

content_typeenumRequired

Format of your manifest data

Allowed values:

json_itemslist of objectsOptional

For JSON format. Array of audio sources to transcribe (max 500). If you need higher limits, contact support@sofer.ai.

jsonlstringOptional

For JSONL format. One audio source per line as JSON, separated by newlines (max 500 lines). If you need higher limits, contact support@sofer.ai.

Example: {"audio_url": "https://..."}\n{"audio_url": "https://..."}

metadataobjectOptional

Optional title and description for this manifest

Response

This endpoint returns an object.

batch_file_idUUID

Use this ID when calling Create Batch Transcription with standard mode

item_countinteger

Number of audio sources in the manifest

size_bytesinteger

Size of the manifest in bytes

created_atdatetime

Upload timestamp

statusenum

Validation status. Wait for VALID before starting a batch.

Allowed values:

checksumstringOptional

SHA256 checksum of the manifest

validation_errorslist of stringsOptional

If status is INVALID, lists what’s wrong with the manifest

Errors

401

Authentication Error

429

Rate Limit Error