Comment on page

Generate a single PDF

How to generate synchronously a single PDF - Abyssale REST API

This feature is available from the Advanced plan.
Prerequisites:
There are 2 ways to obtain a PDF from the Rest API:
1. Using a Print format in your template
Using one of the available Print format & then choosing the "Print" Type will enable the PDF type  by default when generating that format.
3 steps to enable the PDF generation on a Print format
2. Using the image_file_type property
You can add an image_file_type property to the API generation payload with a "pdf" value. 
Using this property may produce results that differ from the original design (as some design options are not available in PDF)
Generate a PDF
A single PDF is created by sending data and customisation parameters to the POST /banner-builder/{templateId}/generate endpoint, which will respond synchronously with a payload containing the URL of the generated PDF.
Generating a PDF synchronously
Supported template type: Static
Generation response type: Synchronous
post
https://api.abyssale.com
/banner-builder/{templateId}/generate
Generate image
​The full api reference can be found here.​
Properties available for each type of component are available here.
Get the default payload
To ease the creation of your payload, just go to one of your Template and choose Abyssale Rest API in the Generation Methods list. You will find the default associated payload in the console (Feel free to remove unnecessary properties/elements):
To copy the payload to your clipboard, click the Copy Code button.
Sample request
Do not forget to replace {YOUR-API-KEY} and {templateId}
cURL
Javascript
Python
curl -X POST -H "x-api-key:{YOUR-API-KEY}" -H "Content-Type: application/json"  \
-d '{
  "template_format_name": "main-crisp",
  "image_file_type": "pdf",
  "elements": {
    "image": {
      "image_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/9c872731-da6f-4923-b342-7c4250ac94cc/assets/370af020-5e56-445d-bdf7-02e819658a8a.jpeg",
      "fitting_type": "cover",
      "alignment": "middle center"
    },
    "text_title": {
      "payload": "Send best wishes to your lovelies with little easter gifts!",
      "color": "#FFFFFF",
      "font_size": 48,
      "font": "61566327-33c5-11ea-9877-92672c1b8195",
      "font_weight": 700,
      "line_height": 120,
      "alignment": "top left"
    }
  }
}' \
https://api.abyssale.com/banner-builder/{templateId}/generate
const axios = require('axios');
​
const payload = {
  "template_format_name": "main-crisp",
  "image_file_type": "pdf",
  "elements": {
    "image": {
      "image_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/9c872731-da6f-4923-b342-7c4250ac94cc/assets/370af020-5e56-445d-bdf7-02e819658a8a.jpeg",
      "fitting_type": "cover",
      "alignment": "middle center"
    },
    "text_title": {
      "payload": "Send best wishes to your lovelies with little easter gifts!",
      "color": "#FFFFFF",
      "font_size": 48,
      "font": "61566327-33c5-11ea-9877-92672c1b8195",
      "font_weight": 700,
      "line_height": 120,
      "alignment": "top left"
    }
  }
}
​
axios.post("https://api.abyssale.com/banner-builder/{templateId}/generate", payload, {
    headers: {"x-api-key": "{YOUR-API-KEY}", "Content-Type": "application/json", "timeout": 30000}
  }).then(response => {
    console.log(response.data)
})
import json
import requests
​
image_generation_payload = {
  "template_format_name": "main-crisp",
  "image_file_type": "pdf",
  "elements": {
    "image": {
      "image_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/9c872731-da6f-4923-b342-7c4250ac94cc/assets/370af020-5e56-445d-bdf7-02e819658a8a.jpeg",
      "fitting_type": "cover",
      "alignment": "middle center"
    },
    "text_title": {
      "payload": "Send best wishes to your lovelies with little easter gifts!",
      "color": "#FFFFFF",
      "font_size": 48,
      "font": "61566327-33c5-11ea-9877-92672c1b8195",
      "font_weight": 700,
      "line_height": 120,
      "alignment": "top left"
    }
  }
}
​
r = requests.post("https://api.abyssale.com/banner-builder/{templateId}/generate",
  headers={"x-api-key": "YOUR-API-KEY", "Content-Type": "application/json"},
  data=json.dumps(image_generation_payload),
  timeout=30
)
r.json()
Sample response
{
  "id": "5978e8d9-ab34-4735-a2cb-fe95c2c56251",
  "file": {
    "type": "pdf",
    "url": "https://production-banners.s3.eu-west-1.amazonaws.com/demo/996739f4-b563-428a-a6e8-ec3cb8bd03d4.pdf",
    "cdn_url": "https://cdn.abyssale.com/demo/996739f4-b563-428a-a6e8-ec3cb8bd03d4.pdf",
    "filename": "996739f4-b563-428a-a6e8-ec3cb8bd03d4.pdf"
  },
  "format": {
    "id": "Facebook Feed",
    "width": 1200,
    "height": 628
  },
  "template": {
    "id": "46d22c62-d134-44d3-a040-138e4ea9ea08",
    "name": "Abyssale demo - FB Feed",
    "created_at": 1602256303,
    "updated_at": 1602685407
  }
}
Errors
The Abyssale Image Generation API can return the following error codes :
Code
Description
400
Bad Request
Your request is invalid. Either one of the parameter sent in the request is wrong or the generation failed due to one of the given property. 
​
A payload will be returned in the HTTP response explaining the error.
​
For instance, here are payloads returned: 
If a given parameter is invalid (here the given color is invalid):
{"message": "body_validation_errors: {'media': {'text_role': ["The following property is invalid: ({'color': ['Must be an hexadecimal color. i.e. #EAEAEA']})."]}}", "errors": {"media": {"text_role": ["The following property is invalid: ({'color': ['Must be an hexadecimal color. i.e. #EAEAEA']})."]}}}
If a text cannot be inserted:
{"id": "cannot_build_banner", "message": "Element text_name error: The text 'Welcome to the Abyssale Developer Hub' cannot fit within the defined space."}
401
403
Unauthorized
Ensure your API key is the right one.
404
Not Found 
The route (or the given template) cannot be found.
405
Method Not Allowed
You tried to access Abyssale with an invalid method.
429
API Limits reached
All of your image generation API calls are consumed: You should upgrade to a higher plan.
500
Internal Server Error
Try again later: Contact us on [email protected] if the error occurs.

Code	Description
`400`	Bad Request Your request is invalid. Either one of the parameter sent in the request is wrong or the generation failed due to one of the given property. A payload will be returned in the HTTP response explaining the error. For instance, here are payloads returned: If a given parameter is invalid (here the given color is invalid): `{"message": "body_validation_errors: {'media': {'text_role': ["The following property is invalid: ({'color': ['Must be an hexadecimal color. i.e. #EAEAEA']})."]}}", "errors": {"media": {"text_role": ["The following property is invalid: ({'color': ['Must be an hexadecimal color. i.e. #EAEAEA']})."]}}}` If a text cannot be inserted: `{"id": "cannot_build_banner", "message": "Element text_name error: The text 'Welcome to the Abyssale Developer Hub' cannot fit within the defined space."}`
`401` `403`	Unauthorized Ensure your API key is the right one.
`404`	Not Found The route (or the given template) cannot be found.
`405`	Method Not Allowed You tried to access Abyssale with an invalid method.
`429`	API Limits reached All of your image generation API calls are consumed: You should upgrade to a higher plan.
`500`	Internal Server Error Try again later: Contact us on `[email protected]` if the error occurs.

Generate a single image

Generate Images

Last modified 3mo ago