Python SDK

Install with pip install orshot, then call render_from_template() with a template ID and modifications.

Updated Jul 9, 2026

Installation#

pip

pip install orshot

Import and Initialise#

Python

import orshot

os = orshot.Orshot('<ORSHOT_API_KEY>')

render_from_studio_template#

Render from a custom Studio template. Supports image, PDF, video generation and publishing to social accounts.

Generate Image#

Python

response = os.render_from_studio_template({
  'template_id': 1234,
  'modifications': {
    'title': 'Orshot Studio',
    'description': 'Generate images from custom templates',
  },
  'response': { 'type': 'url', 'format': 'png', 'scale': 2 },
})

JavaScript

{
  "data": {
    "content": "https://storage.orshot.com/.../image.png",
    "format": "png",
    "type": "url",
    "responseTime": 3550.43
  }
}

Generate PDF#

Python

response = os.render_from_studio_template({
  'template_id': 1234,
  'modifications': { 'title': 'Invoice #1234' },
  'response': { 'type': 'url', 'format': 'pdf' },
  'pdf_options': {
    'margin': '20px',
    'range_from': 1,
    'range_to': 2,
    'color_mode': 'rgb',
    'dpi': 300,
  },
})

Generate Video#

Python

response = os.render_from_studio_template({
  'template_id': 1234,
  'modifications': {
    'videoElement': 'https://example.com/custom-video.mp4',
    'videoElement.trimStart': 0,
    'videoElement.trimEnd': 10,
  },
  'response': { 'type': 'url', 'format': 'mp4' },
  'video_options': {
    'trim_start': 0,
    'trim_end': 20,
    'muted': False,
    'loop': True,
  },
})

Python

response = os.render_from_studio_template({
  'template_id': 1234,
  'modifications': { 'title': 'Check out our latest update!' },
  'response': { 'type': 'url', 'format': 'png' },
  'publish': {
    'accounts': [1, 2],
    'content': 'Check out our latest design!',
  },
})
# response['publish'] => [{ 'platform': 'twitter', 'username': 'acmehq', 'status': 'published' }, ...]

Schedule a Post#

Python

response = os.render_from_studio_template({
  'template_id': 1234,
  'modifications': { 'title': 'Scheduled post' },
  'response': { 'type': 'url', 'format': 'png' },
  'publish': {
    'accounts': [1],
    'content': 'This will be posted later!',
    'schedule': { 'scheduled_for': '2026-04-01T10:00:00Z' },
    'timezone': 'America/New_York',
  },
})

Parameters#

key	required	description
`template_id`	Yes	ID of the Studio template.
`modifications`	No	Dict of dynamic modifications for the template.
`response.type`	No	`base64`, `binary`, `url` (Defaults to `url`).
`response.format`	No	`png`, `webp`, `jpg`, `jpeg`, `avif`, `pdf`, `mp4`, `webm`, `mov`, `mkv`, `gif` (Defaults to `png`).
`response.scale`	No	Scale of the output (`1` = original, `2` = double). Defaults to `1`.
`response.include_pages`	No	Page numbers to render for multi-page templates (e.g. `[1, 3]`).
`response.file_name`	No	Custom file name (without extension). Works with `url` and `binary` types.
`pdf_options.margin`	No	CSS margin value (e.g. `"20px"`).
`pdf_options.range_from`	No	Start page number for PDF output.
`pdf_options.range_to`	No	End page number for PDF output.
`pdf_options.color_mode`	No	`rgb` or `cmyk`.
`pdf_options.dpi`	No	DPI for print quality (e.g. `300`).
`video_options.trim_start`	No	Trim start time in seconds.
`video_options.trim_end`	No	Trim end time in seconds.
`video_options.muted`	No	Mute audio track.
`video_options.loop`	No	Loop the video.
`publish.accounts`	No	Array of social account IDs from your workspace.
`publish.content`	No	Caption/text for the social post.
`publish.is_draft`	No	`True` to save as draft instead of publishing.
`publish.schedule.scheduled_for`	No	ISO date string to schedule the post.
`publish.timezone`	No	Timezone string (e.g. `"America/New_York"`).
`publish.platform_options`	No	Per-account options keyed by account ID.
`publish.tiktok_settings`	No	Root-level TikTok options. Use `{ "auto_add_music": True }` to request recommended music for TikTok photo carousels.

render_from_template#

Render from a pre-built Orshot template.

Python

response = os.render_from_template({
  'template_id': 'open-graph-image-1',
  'modifications': {
    'title': 'Orshot',
    'description': 'Create Visuals and Automate Image Generation',
  },
  'response_type': 'url',
  'response_format': 'png',
})

JavaScript

{
  "data": {
    "content": "https://storage.orshot.com/.../image.png",
    "format": "png",
    "type": "url",
    "responseTime": 3550.43
  }
}

key	required	description
`template_id`	Yes	ID of the template (`open-graph-image-1`, `tweet-image-1`, `beautify-screenshot-1`, ...)
`modifications`	Yes	Modifications for the selected template.
`response_type`	No	`base64`, `binary`, `url` (Defaults to `url`).
`response_format`	No	`png`, `webp`, `pdf`, `jpg`, `jpeg`, `avif` (Defaults to `png`).

For available templates and their modifications refer Orshot Templates Page

generate_signed_url#

Generate a signed URL for a template.

Python

response = os.generate_signed_url({
  'template_id': 'open-graph-image-1',
  'modifications': { 'title': 'Hello World' },
  'expires_at': 1744276943,
  'render_type': 'images',
  'response_format': 'png',
})

JavaScript

{
  "data": {
    "url": "https://api.orshot.com/v1/generate/images?templateId=open-graph-image-1&expiresAt=1744276943&..."
  }
}

key	required	description
`template_id`	Yes	ID of the template (`open-graph-image-1`, `tweet-image-1`, `beautify-screenshot-1`, ...)
`modifications`	Yes	Modifications for the selected template.
`expires_at`	Yes	Expires at in unix timestamp (Integer).
`render_type`	No	`images`, `pdfs` (Defaults to `images`).
`response_format`	No	`png`, `webp`, `pdf`, `jpg`, `jpeg`, `avif` (Defaults to `png`).