Understanding Error IDs and Generation IDs in Stability AI's Image to Video API Response

Introduction:

Stability AI's Image to Video API endpoint provides a powerful tool for generating videos based on an initial image. Occasionally, users may encounter confusion when interpreting the API response due to the similarity between Error IDs and Generation IDs. In this article, we'll clarify the distinction between these IDs and guide you on how to correctly identify them, including the context of a potential 403 error.

Error IDs vs Generation IDs:

Error IDs: Error IDs are unique identifiers assigned when an error occurs during the generation process. 

They are labeled as Generation IDs in the API response if an HTTP 403 error has occurred.

To differentiate between an Error ID and a Generation ID, pay attention to the HTTP status code.

If the response contains a HTTP 403 error, it indicates an Error ID is present as a "Generation ID".

Generation IDs: A valid Generation ID is a 64-character alphanumeric identifier assigned upon successful video generation. It uniquely identifies the generated video. 

Identifying Error IDs: To correctly identify Error IDs, follow these steps:

• Examine the HTTP status code in the API response.
• If the status code is 403, it signifies an Error ID. This error typically occurs when an API request is flagged by Stability AI's content moderation system due to potential violation of guidelines or restrictions. (see more information about why this may occur here)
• Error IDs are not indicative of failed video generation but rather indicate permission issues or other errors during the process. 

Interpreting Generation IDs: To ensure you're correctly interpreting Generation IDs, follow these guidelines:

• Look for a 64-character alphanumeric string in the API response.
• Confirm that the HTTP status code is HTTP 200, indicating successful video generation. 

Conclusion:

Understanding the distinction between Error IDs and Generation IDs is crucial for effectively utilizing Stability AI's Image to Video API endpoint. Always refer to the HTTP status code and look for a 64-character alphanumeric string to accurately identify Error IDs and Generation IDs in API responses. If a 403 error occurs, it signifies that your request was flagged by Stability AI's content moderation system, and you may need to revise your request or reach out to Stability AI's support team for further assistance.