Troubleshooting API Errors

To troubleshoot Blotato API errors, check your "Failed" dashboard: https://my.blotato.com/failed

---

UPLOAD Step - Most Common Errors

Here are the most common reasons the UPLOAD step fails 👇

1) Wrong Blotato API Key:

• check you've copied it correctly without whitespaces

• check the blotato-api-key variable is populated correctly in the UPLOAD step

2) URL is empty:

• check that the url you're passing in is NOT empty

• if the url is empty, this is because your previous step did not finish creating your video/carousel, so you need to increase WAIT time and check you didn't run out of credits

---

PUBLISH Step - Most Common Errors

Here are the most common reasons the PUBLISH step fails 👇

1) Wrong Account ID

• check you've copied the social account ID correctly

• check that accountId variable in PUBLISH step is correctly populated with the value

2) Wrong Page ID

• Facebook requires passing in Page ID, along with Account ID

• Check you've copied Page ID correctly. There are 2 buttons "Copy Account ID" and "Copy Page ID":

3) Escape Multi-Line Paragraphs

• if you have a long text with linebreaks, make sure it is escaped

• in n8n, use the function toJsonString() like this:

"text": $("Prepare for Publish").item.json.final_text_long.toJsonString()

4) Invalid File Format

• Check that your file format is valid per Blotato API docs

5) Invalid Video Dimensions

• As a sanity check, try uploading this video

---

CREATE FACELESS VIDEO Step - Most Common Errors

Here are the most common reasons the CREATE FACELESS VIDEO step fails 👇

1) Wrong Blotato API Key:

• check you've copied it correctly without whitespaces

• check the blotato-api-key variable is populated correctly in the UPLOAD step

2) You Ran Out Of AI Credits:

• go to Settings to check if you have enough credits

3) Wrong Template Parameters:

• Blotato API offers multiple video templates.
• Each template has a different set of parameters, so check what you're passing in.

4) Missing AI Voice

• "POV" template doesn't include AI voice because that's not the style of viral POV videos

• To get AI voiceover, use the template ID empty

---

CREATE CAROUSEL/SLIDESHOW Step - Most Common Errors

Here are the most common reasons the CREATE CAROUSEL/SLIDESHOW step fails 👇

1) Wrong Blotato API Key:

• check you've copied it correctly without whitespaces

• check the blotato-api-key variable is populated correctly in the UPLOAD step

2) You Ran Out Of AI Credits:

• go to Settings to check if you have enough credits

3) Wrong Template Parameters:

• Blotato API offers multiple video templates.
• Each template has a different set of parameters, so check what you're passing in.

4) Missing Music

• You can now add music to Tiktok slideshows. In the PUBLISH TO TIKTOK step, add the parameter autoAddMusic: true (Blotato API docs here)

---

CREATE HEYGEN AVATAR VIDEO Step - Most Common Errors

Here are the most common reasons the CREATE HEYGEN AVATAR VIDEO step fails 👇

1) Wrong Heygen API Key and IDs:

• check you've copied it correctly without whitespaces

• check you've copied the HEYGEN AVATAR ID, not the Heygen Avatar GROUP ID

2) You're On Heygen Free Plan

• HeyGen API requires you to pay for its $99/mo API plan. The Free API plan won't work.

3) Your Avatar Has a Background

• if you want to use your avatar's default background, NOT a green screen, you'll need to update CREATE AVATAR VIDEO step

• set matting to false

• remove the section background

4) Increase Wait Time

• Avatar videos take awhile to make, so I recommend testing with a short script (1 sentence)

• When you increase the length of the script, increase the WAIT time accordingly

---

How Do I Fix Invalid JSON Error?

How to fix invalid JSON:

1) Check your JSON is valid with this free tool: https://jsonlint.com

2) Copy and paste the following prompt into ChatGPT to compare your JSON with Blotato's API docs: ​

I need help fixing my JSON request to Blotato API.

Here's Blotato API docs: https://help.blotato.com/api-reference ​ Here's my JSON request:

<insert_your_json>

---

API Error: "The service is receiving too many requests from you"

This API error means you are calling the Blotato API too fast.

The Blotato API has a rate limit to prevent spamming and abusing social media endpoints, which helps keep Blotato's integration in good standing with the social platforms.

The Upload Media endpoint has a user-level rate limit of 10 requests per minute.

The Publish Post endpoint has a user-level rate limit of 30 requests per minute.

---

API Error: "The aspect ratio is not supported"

This API error means the video you're trying to upload is not an aspect ratio supported by the platform.

For example, a video with dimensions 2160x2880 is 3:4. But the only supported Instagram formats are 1:1, 4:5, 1.91:1, 9:16 (as an example).

---

Seeing error 400 "body/template/id must be equal to constant"?

This error means you need to pass in a template object and id. For example, when generating a video through Blotato API, try this from the examples:

{
    "script": "you wake up as a pharaoh",
    "style": "cinematic",
    "template": {
        "id": "base/pov/wake-up"
    }
}

---

---

I'm making faceless videos via API but GET VIDEO node returns an empty/null mediaURL?

If your GET VIDEO node returns a null or empty mediaUrl, typically the issue is: 1. Your video is not yet done being created. Increase wait time. 2. You ran out of Blotato AI credits, so the video could not finish.

---