Ruby

RubyRuby

Generate an image from a template with a single POST request, using only the Ruby standard library. Imejis returns the finished image directly, so there are no webhooks and nothing to poll.

Set two environment variables first: IMEJIS_API_KEY (from your dashboard) and IMEJIS_DESIGN_ID (any design's ID). Then send the fields you want to change as component.property pairs, for example headline.text.

require "net/http"
require "json"
require "uri"
 
design_id = ENV.fetch("IMEJIS_DESIGN_ID")
api_key = ENV.fetch("IMEJIS_API_KEY")
 
uri = URI("https://render.imejis.io/v1/#{design_id}")
request = Net::HTTP::Post.new(uri)
request["dma-api-key"] = api_key
request["Content-Type"] = "application/json"
request.body = { "headline.text" => "Hello from Ruby" }.to_json
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
File.binwrite("output.jpg", response.body)
puts "status #{response.code} bytes #{response.body.bytesize}"

Override any field. Each dynamic component exposes keys like headline.text, title.color, or image.image. Send only the ones you want to change. You can find a design's overridable fields in its Share / API panel.

The response is the raw image (image/jpeg by default). Save it to disk, stream it, or return it straight from your own endpoint.