Working with Authentication Tokens

Creating a New Authentication Token

To create a new token for AI Gateway authentication:

1. Go to the Authentication Token tab in the AI Gateway management interface.

2. Click the Create authentication token button to open the token creation popup.

3. In the popup window:

   • Enter a Token name (required). This is an identifier to help you manage tokens more easily.

   • Examples: token-user01, token-user02,...

4. Click Create to generate the token.

Each token is associated with a specific AI Gateway and can be used to securely call APIs or access the Gateway.

Managing the Token List

After creation, the token will appear in the list with the following information:

Field	Description
Token name	The identifier you assigned when creating the token
Created at	Creation timestamp
Status	Token status (e.g: ACTIVE)
Action	Delete the token when it is no longer needed

Only tokens with ACTIVE status can be used to authenticate API Gateway requests.

Deleting an Authentication Token

To delete a token:

1. Select the token from the list.

2. Click the Delete button.

3. Confirm the deletion to complete the action.

Once deleted, the token can no longer be used to authenticate access to the AI Gateway.

Notes:

• Tokens function as temporary credentials — keep them secure and never share them publicly.

• Each token is valid for only one specific AI Gateway.

• It is recommended to periodically review and remove unused tokens to reduce security risks.

Integrating Authentication Tokens to Call APIs

Once a token has been created and is in ACTIVEstatus, you can use it to call APIs through the AI Gateway.

You must include the token in the HTTP request header. The AI Gateway will validate the token before forwarding the request to the LLM model.

Example with curl:

curl -X POST https://user-123456-demo-gateway.ai-gateway.vngcloud.vn/deepseek/deepseek-chat/chat/completions \
                --header 'Authorization: Bearer {YOUR_TOKEN}' \
                --header 'Content-Type: application/json' \
                --data '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "What is AI?"}]}'

Where:

• <YOUR_TOKEN> is the token you created earlier.

If the token is invalid or expired, AI Gateway will return the error Invalid authentication token.