POST
/
integration
/
upload
/
direct
curl -X POST "https://api-integration.ollang.com/integration/upload/direct" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/document.pdf" \
  -F "name=contract_document" \
  -F "sourceLanguage=en"
{
  "projectId": "60b8d6f1e1b9b1d8c6c0d8e1"
}
Upload files directly to the platform by calling this endpoint to process your content for translation and transcription services. This endpoint accepts a wide variety of file formats including:
  • Video files: MP4, AVI, MOV, WMV
  • Audio files: MP3, WAV, AAC, M4A
  • Document files: DOCX, PDF, TXT, RTF
  • Presentation files: PPTX, PPT
  • Spreadsheet files: XLSX, XLS
  • And many more formats
All uploaded files can be processed for translation into your target language.
curl -X POST "https://api-integration.ollang.com/integration/upload/direct" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/document.pdf" \
  -F "name=contract_document" \
  -F "sourceLanguage=en"

Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here
You can obtain your API key from your Ollang dashboard.

Body Parameters

file
file
required
The file to upload for translation. Supports a wide range of file formats including: Video formats: MP4, AVI, MOV, WMV, FLV, MKV Audio formats: MP3, WAV, AAC, M4A, FLAC, OGG Document formats: DOCX, DOC, PDF, TXT, RTF, ODT Presentation formats: PPTX, PPT, ODP Spreadsheet formats: XLSX, XLS, ODS, CSV Other formats: HTML, XML, JSON, SRT, VTT Maximum file size: 30GB for video files, 100MB for document files.
name
string
required
Name of the file being uploaded. This will be used as the identifier for your uploaded content. Should be descriptive and unique for easy identification.
sourceLanguage
string
required
The source language of the file content. Use standard language codes such as:
  • ‘en’ for English - ‘es’ for Spanish - ‘fr’ for French - ‘de’ for German - ‘zh’ for Chinese - ‘ja’ for Japanese - ‘tr’ for Turkish - And many more supported languages
notes
array
Array of order notes for additional instructions or information about the upload. Each note should be an object with:
  • details (string): Note content (e.g., “Preserve formatting”, “Technical document”, “Marketing content”)
  • timeStamp (string): Timestamp for the note
Example: [{"details": "Please maintain original formatting for this legal document", "timeStamp": "2024-01-15T10:30:00Z"}]

Response

projectId
string
Unique identifier for the project associated with the uploaded file. Use this ID to create, track, and manage your uploaded content throughout the translation process.
{
  "projectId": "60b8d6f1e1b9b1d8c6c0d8e1"
}