Python

Installation

pip install orshot

Initialise

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

Render from template

response = os.render_from_template({
  'template_id': 'open-graph-image-1',
  'modifications': {'title': 'From python sdk new'},
  'response_type': 'base64',
  'response_format': 'png'
})

Generate Signed URL

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

{
  "data": {
    "url": "https://api.orshot.com/v1/generate/images?expiresAt=1744276943&id=28&templateId=open-graph-image-1&title=From%20python%20sdk%20new&signature=fa4ea0aa4cf05bd9b836be031dccfc26abf41dcc623561ac262c75b658f725f1"
  }
}

Examples

`base64` response format

import orshot
os = orshot.Orshot('<ORSHOT_API_KEY>')
modifications = {
  'title': 'From Orshot Python SDK',
  'description': 'Create Visuals and Automate Image Generation'
}
response = os.render_from_template({
  'template_id': 'open-graph-image-1',
  'modifications': modifications,
  'response_type': 'base64',
  'response_format': 'png'
})

{
  'data': {
    'content': 'data:image/png;base64,iVBORw0KGgoAAA',
    'format': 'png',
    'type': 'base64',
    'responseTime': 3208.03
  }
}

`binary` response format

from io import BytesIO

import orshot
from PIL import Image

os = orshot.Orshot('<ORSHOT_API_KEY>')
modifications = {
'title': 'From Orshot Python SDK',
'description': 'Create Visuals and Automate Image Generation'
}
response = os.render_from_template({
'template_id': 'open-graph-image-1',
'modifications': modifications,
'response_type': 'binary',
'response_format': 'png'
})

with Image.open(BytesIO(response.content)) as im:
im.save('og.png')

This example writes the binary image to the file og.png

`url` response format

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

{
  'data': {
    'content': 'https://storage.orshot.com/00632982-fd46-44ff-9a61-f52cdf1b8e62/images/AuBgAsKzLJl.png',
    'type': 'url',
    'format': 'png',
    'responseTime': 3387.08
  }
}

render_from_template

Use this function to generate an image.

argument	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 `base64`).
`response_format`	No	`png`, `webp`, `pdf`, `jpg`, `jpeg` (Defaults to `png`)

For available templates and their modifications refer Orshot Templates Page

generate_signed_url

Use this function to get a signed URL.

argument	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 time in UNIX timestamp (Integer)
`render_type`	No	`images`, `pdfs` (Defaults to `images`).
`response_format`	No	`png`, `webp`, `pdf`, `jpg`, `jpeg` (Defaults to `png`)

On this page