Skip to main content
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" \
  -F "folderId=60b8d6f1e1b9b1d8c6c0d8e2"

{
  "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
  • Image to Image translation: JPEG, JPG, PNG (direct upload for image-based translation)
  • And many more formats
All uploaded files can be processed for translation into your target language. For Image to Image translation, use Direct Upload with a JPEG, JPG, or PNG file, then create a document order as usual. 
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" \
  -F "folderId=60b8d6f1e1b9b1d8c6c0d8e2"

​
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 Image formats (Image to Image translation): JPEG, JPG, PNG Other formats: HTML, XML, JSON, SRT, VTT Maximum file size: 30GB for video files, 100MB for document files. Note: For testing in the API playground, the upload limit is 5MB.
​
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 if the content is a video or audio file.
Example: [{"details": "Please ignore the subtitles for 30 seconds", "timeStamp": "02:15:30"}]
​
folderId
string
Optional folder ID to place the project in. The folder must belong to the same client account. If not provided, the project will be placed in the default “API Uploads” folder. You can retrieve available folder IDs using the Retrieve All Folders endpoint.

​
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"
}