Skip to main content

Onboarding

This page takes you from your first login to your first request.

Pilot phase

The team creates your account. You receive your username and a temporary password from us. To get access, see Access.

1. Log in to Authentik​

Authentik is the identity service of the platform. You use it to log in to the Developer Portal.

  1. Open Authentik and sign in with your username and the temporary password.
  2. On your first login, set a new password. Click the gear icon in the top right corner to open the settings.

2. Open the Developer Portal​

Click the Developer Portal application (the "D" icon) under My applications. You can also open the Developer Portal directly. Click Login with Authentik and sign in with your username and your new password.

3. Create your API key​

Your API key authenticates your requests. Without a valid key, the platform rejects every request.

  1. In the sidebar, open Developer, then API Keys.
  2. Click Generate API Key.
  3. Copy the key. The portal shows it only once.
caution

Treat your API key like a password. Do not commit it to version control or share it. If you lose it, use Regenerate.

See API Keys for details.

4. Request access in the API Catalog​

Open Platform, then API Catalog. The catalog lists all services, also those you cannot use yet.

  • Granted (green): you can use the service now.
  • Pending (yellow): an admin has not yet reviewed your request.
  • Request Access (grey button): click it to ask for access. Admins review each request and approve or deny it.

See API Catalog for details.

5. Send your first request​

Click a granted service in the catalog. The detail page shows its endpoint path, the model name, and an example request. Send your API key in the apikey header.

curl https://aifactory-dev.ai-factory.datalab.tuwien.ac.at<endpoint-path> \
  -H "apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model-name>",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Replace <endpoint-path> with the endpoint path from the detail page, for example /gemma-2b-instruct/v1/chat/completions. Replace <model-name> with the model name shown there, and <your-api-key> with your key. See Using the API.

The Compute API is in the infrastructure section of the catalog. Its endpoints are limited during the pilot, see Limitations.

Questions​

If you have questions or concerns, contact us at software.platform@ai-at.eu.