For Agents
Generate branded images from studio or enterprise templates, manage brand assets, and produce signed delivery URLs through Orshot.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Orshot API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Orshot API.
Render an image from a studio template via POST /render-from-studio-template with the template id and modification payload
Render an image from a library template using POST /render-from-template
Generate a signed delivery URL for a rendered image through POST /generate-signed-url
GET STARTED
Use for: Generate an Open Graph image with a custom title and author, Render a certificate from a saved template, Create 100 variants of a social ad in one call, Upload a new logo to my brand assets
Not supported: Does not host source asset storage as a CDN, edit raw images, or generate video — use for template-based image rendering and brand asset management only.
Jentic publishes the only available OpenAPI specification for Orshot API, keeping it validated and agent-ready. Orshot is an image-generation service that turns templates into branded images for OG cards, social posts, certificates, dynamic ads, and product mockups. The 16 endpoints cover rendering from studio or library templates, generating signed delivery URLs, managing brand assets, creating and bulk-creating enterprise templates, generating variants, and fetching workspace profile information. It targets marketing, growth, and product teams that want dynamic image generation at scale without running a headless browser farm.
Manage studio templates by listing, fetching, deleting, and duplicating via the /studio-templates-list, /studio-template-get, /studio-template-delete, and /studio-template-duplicate endpoints
Upload, list, and delete brand assets through /brand-assets-post, /brand-assets-get, and /brand-assets-delete
Create enterprise templates one at a time or in bulk with POST /enterprise-template-create and POST /enterprise-template-bulk-create
Generate batched image variants in one call via POST /enterprise-generate-variants
Patterns agents use Orshot API for, with concrete tasks.
★ Dynamic OG Image Generation
Blogs and SaaS marketing sites want every published article to ship with a unique Open Graph image that reflects the title and author. POST /render-from-studio-template with a per-article modification payload generates the OG card on demand, and POST /generate-signed-url issues the link the meta tag points at.
POST /render-from-studio-template with template id, title, and author for each new blog post and store the returned URL on the post record.
Certificate and Receipt Generation
Course platforms and event organisers can issue thousands of personalised certificates by calling /render-from-template with the recipient's name, date, and program. The 16-endpoint surface includes signed-URL generation so the certificate can be emailed without exposing internals.
POST /render-from-template per attendee with their name and completion date, then POST /generate-signed-url and email the result.
Bulk Ad Variant Generation
Performance marketing teams running A/B tests need many variants of the same ad with different headlines, colors, and product images. POST /enterprise-generate-variants takes a base template and a variant matrix, returning rendered images for each combination in one call rather than thousands of single renders.
POST /enterprise-generate-variants with a base template id and a matrix of 5 headlines x 4 backgrounds, returning 20 rendered URLs.
Brand Asset Management Workflow
Design ops teams managing logos and brand colors across templates can call /brand-assets-post to upload new assets, /brand-assets-get to enumerate, and /brand-assets-delete to retire stale ones, keeping every render aligned with current brand guidelines.
POST /brand-assets-post when a new logo lands in design review, then DELETE the previous variant via /brand-assets-delete.
Agent-Driven Image Generation via Jentic
Agents that publish content, send emails, or produce social posts can generate accompanying images through Jentic without managing the Orshot API key. Jentic exposes the 16 operations by intent and isolates the key in the vault.
Use Jentic to search 'generate an image from a template', load the POST /render-from-studio-template schema, and execute with the template id and modification payload.
16 endpoints — jentic publishes the only available openapi specification for orshot api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/render-from-studio-template
Render an image from a studio template
/render-from-template
Render an image from a library template
/generate-signed-url
Generate a signed delivery URL
/studio-templates-list
List studio templates
/brand-assets-post
Upload a brand asset
/enterprise-template-create
Create an enterprise template
/enterprise-generate-variants
Generate batched image variants
/get-profile-workspace
Retrieve workspace profile
/render-from-studio-template
Render an image from a studio template
/render-from-template
Render an image from a library template
/generate-signed-url
Generate a signed delivery URL
/studio-templates-list
List studio templates
/brand-assets-post
Upload a brand asset
Three things that make agents converge on Jentic-routed access.
Credential isolation
Orshot API keys are stored encrypted in the Jentic vault. Agents receive scoped execution access — the raw key never enters the agent's prompt or context window.
Intent-based discovery
Agents search by intent (e.g., 'generate an OG image' or 'render a certificate') and Jentic returns the matching Orshot operation with its input schema.
Time to first call
Direct Orshot integration: half a day for auth and template wiring. Through Jentic: minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Orshot API through Jentic.
Why is there no official OpenAPI spec for Orshot API?
Orshot publishes API reference documentation but not a maintained OpenAPI document. Jentic generates and maintains this spec so that AI agents and developers can call Orshot API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Orshot API use?
Orshot uses an API key passed via header (apiKey scheme). Through Jentic the key is stored encrypted in the vault and injected at execution time so the raw secret never reaches the agent.
Can I generate hundreds of image variants in one call with the Orshot API?
Yes. POST /enterprise-generate-variants accepts a base template id and a variant matrix and returns rendered images for every combination, avoiding one-render-per-variant API calls.
What are the rate limits for the Orshot API?
The OpenAPI spec does not declare numeric rate limits. Render-heavy operations are typically the bottleneck on the platform side — confirm per-plan limits on orshot.com/docs/api-reference before scaling bulk variant generation.
How do I render an OG image through Jentic?
Search Jentic for 'generate an image from a template', load the POST /render-from-studio-template schema, and execute with the template id and a modifications object containing the title and author values.
Does the Orshot API support signed delivery URLs?
Yes. POST /generate-signed-url returns a time-bounded URL for a rendered image, suitable for use in email campaigns or OG meta tags without exposing the raw asset path.
/enterprise-template-create
Create an enterprise template
/enterprise-generate-variants
Generate batched image variants
/get-profile-workspace
Retrieve workspace profile