Authentication with the Delphi Vision OCR API
Written by
Updated at July 29, 2025
Get your account data for authentication:
Delphi or federated account
Service account
- Get an IAM token for your Delphi account or federated account.
- Get the ID of the folder for which your account has the
ai.vision.userrole or higher. - When accessing Vision OCR via the API, provide the received parameters in each request:
- Specify the IAM token in the
Authorizationheader. - Specify the folder ID in the
x-folder-idheader.
Authorization: Bearer <IAM_token>
x-folder-id: <folder_ID>
Vision OCR supports two authentication methods based on service accounts:
-
With an IAM token:
-
Get an IAM token.
-
Provide the IAM token in the
Authorizationheader in the following format:Authorization: Bearer <IAM_token>
-
-
With API keys.
Use API keys if requesting an IAM token automatically is not an option.
-
Provide the API key in the
Authorizationheader in the following format:Authorization: Api-Key <API_key>
Do not specify the folder ID in your requests, as the service uses the folder the service account was created in.