FAQs

AI Model Hub for Free: From December 1, 2024, to June 30, 2025, IONOS is offering all foundation models in the AI Model Hub for free. Create your contract today and kickstart your AI journey!

The AI Model Hub is focused on offering an API. While this is great in terms of integrating the solution into your existing code , it has a downside: Errors and problems that arise are often not obvious enough to fix. This FAQ gathers the most important issues:

How do I fix an unauthorized, wrong, or no API Key error?

Our Tutorials and Use Case documentation assume you have an environment variable called IONOS_API_TOKEN. The value of this environment variable needs to be a valid Authentication Token. If you get the described error, two reasons are possible:

• IONOS_API_TOKEN is not set: Check whether your system's environment variable is set. The simplest way to do this is by adding the line

  import os
  print(os.environ.get("IONOS_API_TOKEN"))

  to your code. If nothing is shown, the environment variable is not set. Please set it.

• Your Authentication Token is not valid: If the IONOS_API_TOKEN environment variable is set, but you still see this error, your authentication token might not be valid. Create a new Authentication Token as described in our Access Management tutorial.

How do I fix a 404 Not Found error?

Communication with the AI Model Hub is via API endpoints. These endpoints often contain IDs, like the Collection ID, a Model ID or some similar ID. One typical example of such an API endpoint is the endpoint to see all uploaded documents in a specific document collection:

f"https://inference.de-txl.ionos.com/collections/{COLLECTION_ID}/documents"

Notice that the variable COLLECTION_ID is part of the API endpoint URL. If you, for example, have previously deleted this endpoint, a request to it will return a '404 Not Found' error.

To ensure the ID exists, invoke the higher-level endpoint with a get request. This will return a list of all entries, and you can choose one of the existing IDs. In the above example, the Python command could be:

import requests
HEADERS = {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': f'Bearer {IONOS_API_TOKEN}',
}
print(requests.get(f"https://inference.de-txl.ionos.com/collections", headers=HEADERS).json())

An entry item exists in the resulting JSON document, which gathers all available document collections.

How do I fix a 500 Internal Server error?

We do our best to ensure our service is operational 24 hours, 7 days a week. Hence, you should never encounter any 500 Internal Server errors. If such an error occurs, it may be due to too much traffic on the AI Model Hub or an urgent infrastructure fix. Please retry your request. If the problem persists, contact IONOS support.