AI asset generation#

This section provides troubleshooting information for issues related to AI asset generation within JSON2Video. These issues can arise from incorrect configurations, limitations with third-party AI services, or account restrictions.

General Errors#

Model [model name] not found#

Cause: The specified AI model is not supported by JSON2Video or is misspelled in your JSON payload.

Solution:

• Verify that the model property is set to a valid and supported model name (e.g., azure, elevenlabs, freepik-classic, flux-pro).
• Refer to the AI asset generation documentation or the element-specific documentation (e.g., Image element, Voice element) for a list of available models.

Voice Generation Related Errors#

A voice name is required for voice generation#

Cause: A voice property is missing in the voice element when trying to generate a voiceover.

Solution:

• Ensure the voice property is included and contains a valid voice name or ID for the selected AI model (model property).

Invalid voice name#

Cause: The provided voice value is not in a valid format.

Solution:

• Verify that the voice value is in the correct format as required by the selected AI model. Check the format of Azure voices or ElevenLabs voices in the Voice element documentation.

Failed to get Azure token#

Cause: The Azure text-to-speech API is temporarily unavailable or experiencing issues.

Solution:

• Wait a few minutes and retry the request. This issue is usually temporary.

Failed to generate voice with Azure. Check if the voice name is correct#

Cause: The voice generation with Azure failed, likely due to an incorrect voice name.

Solution:

• Double-check that the voice property is set to a valid voice name available in Azure.
• Refer to the Azure voice catalog for a list of valid voice names.

Voice not found: [voice name/id]#

Cause: The specified voice name or ID is not available within the ElevenLabs account being used. This can happen in two scenarios:

• Bring Your Own API Key (BYOA): The voice is not available for your ElevenLabs account. This could be due to account level or specific voice permissions.
• JSON2Video's Managed API Keys: The voice is not a standard voice provided through the JSON2Video managed ElevenLabs integration.

Solution:

• BYOA: Ensure the voice is available and properly configured within your ElevenLabs account.
• JSON2Video's Managed API Keys: Choose a different voice. A list of available voices can be found at https://json2video.com/ai-voices/elevenlabs/.

Your ElevenLabs API key has an invalid format. It should start with 'sk_'#

Cause: The ElevenLabs API key provided in the connection has an incorrect format.

Solution:

• Ensure the API key starts with sk_. Verify you have copied the API key correctly from your ElevenLabs account.

Could not check ElevenLabs plan details with your API key or Failed to get ElevenLabs plan details#

Cause: ElevenLabs API could not provide details for the provided API key.

Solution:

• Wait a few minutes and retry the request. If the issue persists, verify that your API key is active and valid within your ElevenLabs account.

Your ElevenLabs API key is not on a paid plan. Only ElevenLabs API keys on paid plans are supported.#

Cause: ElevenLabs does not allow free accounts to be used from public IP pools like Amazon Web Services, where JSON2Video is hosted.

Solution:

• Upgrade your ElevenLabs account to a paid plan.
• Alternatively, use JSON2Video's managed API keys for voice generation.

Your ElevenLabs API key has not enough remaining credits for this request#

Cause: You are using BYOA, and your ElevenLabs account does not have enough credits to fulfill the voice generation request.

Solution:

• Check your ElevenLabs account and purchase more credits if needed.

Too many simultaneous requests to ElevenLabs. Please try again later.#

Cause: The ElevenLabs API is currently overloaded and cannot handle the request.

Solution:

• Wait a few minutes and retry the request. This issue is usually temporary.

ElevenLabs API returned an unexpected response#

Cause: The ElevenLabs API returned a response that could not be processed.

Solution:

• Wait a few minutes and retry the request. If the issue persists, contact JSON2Video support.

ElevenLabs API Key is invalid#

Cause: The provided ElevenLabs API key is incorrect or no longer valid.

Solution:

• Double-check that you have copied the API key correctly from your ElevenLabs account and that the key is still active.

Image Generation Related Errors#

The image generation process failed after 3 attempts#

Cause: The third-party API for image generation failed after multiple retry attempts.

Solution:

• Check your image generation prompt for complexity or potentially problematic content.
• Try simplifying the prompt or rephrasing it.
• Wait a few minutes and retry the request.

Error generating image: NSFW content detected#

Cause: The third-party API classified the image prompt as inappropriate (NSFW: Not Suitable For Work).

Solution:

• Revise your image prompt to remove any suggestive, explicit, or otherwise inappropriate content.

502 gateway#

Cause: The third-party API is currently unavailable or experiencing a temporary outage.

Solution:

• Wait a few minutes and retry the request.