API Key Settings

The FuriosaAI NPU Runtime and FuriosaAI NPU Python SDK include web service based tools provided by FuriosaAI; to use these tools, you need to set a web service API key.

Note

If you don’t have an API key, you can get one through the FuriosaAI SDK and NPU evaluation program process by sending a request to contact@furiosa.ai.

Write and save your own API key in $HOME/.furiosa/credentials file as follows.

FURIOSA_ACCESS_KEY_ID=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
FURIOSA_SECRET_ACCESS_KEY=YYYYYYYYYYYYYYYYYYYYYYYYYYYYY

Authentication Testing

You can verify that the API key is set up correctly by using the Python SDK or the command line tools included with the FuriosaAI SDK.

Authentication Testing using Command Line Tools

$ furiosa toolchain list
Available Toolchains:
[0] 0.1.0 (rev: 952707e5f built_at: 2020-12-15 23:38:22)

If the API key is invalid or not set properly, you will see the following error.

$ furiosa toolchain list
Client version: .dev0+bd0a54fdfba11243139668eff5fdf5dccfe4c470.dirty
ERROR: fail to get version (http_status: 401, error_code: InvalidAPIKey, message: Your API Key is invalid. Please use a correct API key.