# Create Express Request
This section allows you to create an express request
## Create Express Video Request
> Simplified interface for creating new video enhancement requests.\
> \
> This endpoint skips the need to gather video information and uses a single-URL upload rather than multi-part upload. Calling the accept and complete-upload endpoints are also no longer necessary.\
> \
> This endpoint does not return the cost estimates. Once the system receives and analyzes the source video file, cost estimates will appear in the response of the status endpoint. The lower bound value will be billed.\
> \
> The endpoint returns a direct upload URL to our cloud storage for you to HTTP PUT the video file to.\
> \
> \## Response body\
> \
> \| \*\*Property\*\* | \*\*Type\*\* | \*\*Description\*\* |\
> \|----------------|----------|----------------------------|\
> \| \*\*requestId\*\* | UUID | Unique request identifier |\
> \| \*\*uploadId\*\* | String | Upload identifier |\
> \| \*\*uploadUrls\*\* | Array | URL(s) for uploading video |
```json
{"openapi":"3.0.3","info":{"title":"Video API","version":"1.0.0"},"tags":[{"name":"Create Express Request","description":"This section allows you to create an express request\n"}],"servers":[{"url":"https://api.topazlabs.com","description":"Production API base URL"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}},"requestBodies":{"CreateExpressRequest":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["source","filters","output"],"properties":{"source":{"type":"object","description":"Source details for the video","required":["container"],"properties":{"container":{"type":"string","enum":["mp4","mov","mkv"],"description":"The container format of the video file"},"md5Hash":{"type":"string","description":"MD5 hash of the source video file in hex"},"external":{"$ref":"#/components/schemas/ExternalStorage"}}},"filters":{"$ref":"#/components/schemas/InputFilters"},"output":{"$ref":"#/components/schemas/OutputInformationVideo"},"destination":{"type":"object","properties":{"external":{"$ref":"#/components/schemas/ExternalStorage"}}},"notifications":{"type":"object","properties":{"webhookUrl":{"type":"string","description":"Your URL for Topaz Labs to POST webhook notifications to. Webhooks are sent on successful completions and processing failures."}}}}}}}}},"schemas":{"ExternalStorage":{"type":"object","required":["provider","credentials","bucketName","key"],"properties":{"provider":{"type":"string","enum":["s3"]},"presignedUrl":{"type":"string","description":"Presigned URL to download the source video from or upload the output video to"},"awsCredentials":{"$ref":"#/components/schemas/CredentialsS3"},"bucketName":{"type":"string"},"key":{"type":"string","description":"The example includes the standard specifier for image sequence requests, with optional directory path. It must begin with \"%\" and end with the integer specifier \"d\". The \"0\" in the example indicates left-padding with zeroes, and \"6\" indicates the number of digits in the file name.\nKeys for video requests must be valid characters supported by S3.\n"}}},"CredentialsS3":{"type":"object","required":["roleArn","externalId"],"properties":{"roleArn":{"type":"string","description":"AWS ARN of the role to assume"},"externalId":{"type":"string","description":"Kind of like a secret string for extra layer of security"}}},"InputFilters":{"type":"array","description":"Array of UpscaleFilter or FrameInterpolationFilter objects","items":{"anyOf":[{"$ref":"#/components/schemas/UpscaleFilter"},{"$ref":"#/components/schemas/FrameInterpolationFilter"}]}},"UpscaleFilter":{"title":"Upscale Filter","type":"object","required":["model"],"properties":{"model":{"type":"string","description":"Short code name for the AI model\n","enum":["aaa-9","ahq-12","alq-13","alqs-2","amq-13","amqs-2","color-1","ddv-3","dtd-4","dtds-2","dtv-4","dtvs-2","gcg-5","ghq-5","iris-2","iris-3","nxf-1","nxl-1","nxhf-1","nyx-3","prob-4","rhea-1","thd-3","thf-4","thm-2"]},"videoType":{"type":"string","enum":["Progressive","Interlaced","ProgressiveInterlaced"],"description":"Frame/field type of the video"},"auto":{"type":"string","enum":["Auto","Manual","Relative"],"description":"Parameter mode of the selected model\n- Auto - parameter estimation is used with no customization\n- Relative - uses auto parameters with optional weights added\n- Manual - all parameters are manually set\n"},"fieldOrder":{"type":"string","enum":["TopFirst","BottomFirst","Auto"],"description":"Optional specification of field order for interlaced input videos"},"focusFixLevel":{"type":"string","enum":["None","Normal","Strong"],"description":"Downscales video input for stronger correction of blurred subjects"},"compression":{"type":"number","minimum":-1,"maximum":1,"description":"Adjust strength of compression recovery"},"details":{"type":"number","minimum":-1,"maximum":1,"description":"Amount of detail reconstruction"},"prenoise":{"type":"number","minimum":0,"maximum":0.1,"description":"Adds noise to input to reduce over-smoothing"},"noise":{"type":"number","minimum":-1,"maximum":1,"description":"Amount of noise reduction"},"halo":{"type":"number","minimum":-1,"maximum":1,"description":"Amount of halo reduction"},"preblur":{"type":"number","minimum":-1,"maximum":1,"description":"Adjust anti-aliasing and deblurring strength"},"blur":{"type":"number","minimum":-1,"maximum":1,"description":"Amount of sharpness applied"},"grain":{"type":"number","minimum":0,"maximum":0.1,"description":"Adds grain after AI model processing"},"grainSize":{"type":"number","minimum":0,"maximum":5,"description":"Size of generated grain"},"recoverOriginalDetailValue":{"type":"number","minimum":0,"maximum":1,"description":"Reintroduce source details into the output video"}}},"FrameInterpolationFilter":{"title":"Frame Interpolation Filter","type":"object","required":["model"],"properties":{"model":{"type":"string","description":"Short code name for the AI model\n","enum":["apf-2","apo-8","chf-3","chr-2"]},"slowmo":{"type":"number","minimum":1,"maximum":16,"description":"Slow motion factor applied to input video. For example, a value of 2 makes the output twice as slow and doubles the duration."},"fps":{"type":"number","minimum":15,"maximum":240,"description":"Output frame rate, does not increase duration"},"duplicate":{"type":"boolean","description":"Analyze input for duplicate frames and remove them"},"duplicateThreshold":{"type":"number","minimum":0.001,"maximum":0.1,"description":"Sensitivity of detection for duplicate frames"}}},"OutputInformationVideo":{"type":"object","required":["resolution","frameRate","audioCodec","audioTransfer"],"properties":{"resolution":{"type":"object","description":"Desired output resolution","required":["width","height"],"properties":{"width":{"type":"integer","description":"Width in pixels. The maximum size depends on the encoder and can be referenced using the table below
H264
H265
ProRes
AV1
VP9
4096
8192
16386
16384
8192
"},"height":{"type":"integer","description":"Height in pixels. The maximum size depends on the encoder and can be referenced using the table below
H264
H265
ProRes
AV1
VP9
4096
8192
16386
8704
8192
"}}},"frameRate":{"type":"number","description":"Frame rate"},"audioBitrate":{"type":"string","description":"Audio bitrate, if audioTransfer is Copy or Convert. Default values for the codec are used if not provided."},"audioCodec":{"type":"string","enum":["AAC","AC3","PCM"],"description":"__Required if audioTransfer is Copy or Convert.__"},"audioTransfer":{"type":"string","enum":["Copy","Convert","None"]},"codecId":{"type":"string","description":"Video codec ID, if known. Defaults to videoEncoder."},"videoEncoder":{"type":"string","enum":["AV1","H264","H265","VP9"]},"videoBitrate":{"type":"string","description":"__Required if dynamicCompressionLevel is not provided.__ Constant bitrate, suffixed with \"k\" for kilobits or \"m\" for megabits per second."},"dynamicCompressionLevel":{"type":"string","enum":["Low","Mid","High"],"description":"__Required if videoBitrate is not provided.__ Automatic CQP selection."},"videoProfile":{"type":"string","description":"Codec profile specific to videoEncoder. The following are some combinations of available profiles based on the 'videoEncoder' selection
H264
H265
ProRes
AV1
VP9
High
Main, Main10
422 Proxy, 422 LT, 422 Std, 422 HQ
8-bit, 10-bit
Good, Best
"},"cropToFit":{"type":"boolean","description":"Center cropping to fit the output dimensions"},"container":{"type":"string","enum":["mp4","mov","mkv"],"description":"Desired output container"}}},"CreateExpressResponse":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"uploadId":{"type":"string","description":"Upload ID for completing multi-part upload"},"uploadUrls":{"type":"array","description":"URL to PUT the parts to","items":{"type":"string"}}}}},"responses":{"BadRequest":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"ServiceUnavailable":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}},"paths":{"/video/express":{"post":{"tags":["Create Express Request"],"summary":"Create Express Video Request","operationId":"CreateExpressVideoRequest","description":"Simplified interface for creating new video enhancement requests.\n\nThis endpoint skips the need to gather video information and uses a single-URL upload rather than multi-part upload. Calling the accept and complete-upload endpoints are also no longer necessary.\n\nThis endpoint does not return the cost estimates. Once the system receives and analyzes the source video file, cost estimates will appear in the response of the status endpoint. The lower bound value will be billed.\n\nThe endpoint returns a direct upload URL to our cloud storage for you to HTTP PUT the video file to.\n\n## Response body\n\n| **Property** | **Type** | **Description** |\n|----------------|----------|----------------------------|\n| **requestId** | UUID | Unique request identifier |\n| **uploadId** | String | Upload identifier |\n| **uploadUrls** | Array | URL(s) for uploading video |\n","requestBody":{"$ref":"#/components/requestBodies/CreateExpressRequest"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateExpressResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```