POST
/
integration
/
orders
/
create
curl -X POST "https://api-integration.ollang.com/integration/order/create" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "cc",
    "level": 1,
    "projectId": "60b8d6f1e1b9b1d8c6c0d8e1",
    "targetLanguageConfigs": [
      {
        "language": "fr",
        "isRush": false
      },
      {
        "language": "es",
        "isRush": true
      }
    ]
  }'
[
  {
    "orderId": "507f1f77bcf86cd799439015"
  },
  {
    "orderId": "507f1f77bcf86cd799439016"
  }
]

Create a new translation order for your uploaded video projects. This endpoint allows you to request specific translation services such as closed captions, subtitles, dubbing, and more.

curl -X POST "https://api-integration.ollang.com/integration/order/create" \
  -H "X-Api-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "cc",
    "level": 1,
    "projectId": "60b8d6f1e1b9b1d8c6c0d8e1",
    "targetLanguageConfigs": [
      {
        "language": "fr",
        "isRush": false
      },
      {
        "language": "es",
        "isRush": true
      }
    ]
  }'

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

orderType
string
required

Type of the order. Available options: - cc - Closed captions - subtitle - Subtitles - aiDubbing - AI Dubbing - studioDubbing - Studio-produced dubbing - document - Document translation

level
number
required

Service level for the order. Level 0 means full AI generated and Level 1 is Human Review added version.

projectId
string
required

Unique identifier of the project this order belongs to. This should be a project ID from a previous video upload.

targetLanguageConfigs
array
required

Array of target language configurations. Each configuration includes: - language (string): ISO 639-1 language code (e.g., ‘fr’, ‘es’, ‘de’) - isRush (boolean): Whether this language requires rush delivery At least one target language configuration is required.

orderSubType
string

Subtype of the order, specific to closed captions or transcription types. Must be one of: closedCaption or timecodedTranscription.

dubbingStyle
string

Style of dubbing for audio orders. Must be one of: overdub, lipsync, or audioDescription.

Response

orderId
string

Array of created order IDs. Each target language configuration creates a separate order, so you’ll receive multiple order IDs if you specified multiple target languages.

[
  {
    "orderId": "507f1f77bcf86cd799439015"
  },
  {
    "orderId": "507f1f77bcf86cd799439016"
  }
]