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

5) Invalid Video Dimensions

6) Brand New Account

  • Follow this playbook to warm up your social media accounts properly, it makes a huge difference: ​https://help.blotato.com/platforms/tiktok/brand-new-accounts

  • Don't connect 3rd party apps like Blotato until your account is warmed up. Otherwise, you'll be flagged as a bot.

  • Error messages like reached_active_user_cap are due to new accounts, not properly warmed up.


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


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.


Seeing error "Error uploading video to Tiktok: Please review our URL ownership verification rules"?

This error means you're trying to post to Tiktok with a URL that Tiktok rejects.

First, upload your media, then use the Blotato URL to post to Tiktok.

Here's a sample Blotato video URL to test it out:

https://database.blotato.io/storage/v1/object/public/public_media/4ddd33eb-e811-4ab5-93e1-2cd0b7e8fb3f/videogen-4c61a730-7eb2-47e9-a3a3-524740a1b877.mp4

Last updated