Try without an account
Get a 30-minute trial key with one request, without signing up
You can try the Behavioral Signals API without creating an account. One request returns an anonymous API key that works for 30 minutes, which is enough to send a few short files and open one short stream. The request needs no credentials, so a script or a coding agent can get a key on its own.
🔑 Get a trial key
Send an empty POST request to the console:
curl -X POST 'https://portal.behavioralsignals.com/api/v1/anonymous-api-keys'The server answers with 201 Created and the key:
{
"cid": "10001234",
"token": "cd9cd8fefa3d4804981461f7049ebba7",
"expires_at": "2026-10-29T12:14:08.759994Z",
"limits": {
"lifetime_seconds": 1800,
"max_jobs": 3,
"max_seconds_per_file": 300,
"max_streaming_seconds": 30,
"max_streams": 1
}
}The cid and the token work like the Client ID and the Token of a regular API key: the cid goes in the request path and the token goes in the X-Auth-Token header. expires_at is the time, in ISO 8601, at which the key stops working.
⏳ What a trial key can do
A trial key comes with these limits, which the limits object in the response repeats:
- The key is valid for 30 minutes.
- It can run 3 batch jobs, and each file can be at most 5 minutes (300 seconds) long.
- It can stream 30 seconds of audio in total, with one stream open at a time.
One IP address can create 3 trial keys a day.
🌐 Use the key
You use a trial key the same way as a regular one. This request submits an audio file for behavioral analysis:
curl --location 'https://api.behavioralsignals.com/v5/clients/<cid>/processes/audio' \
--header 'X-Auth-Token: <token>' \
--form 'file=@"/path/to/your/file.wav"' \
--form 'name="my-first-audio"'The response carries the process ID (pid). Poll https://api.behavioralsignals.com/v5/clients/<cid>/processes/<pid> until the status is 2, then fetch the results from https://api.behavioralsignals.com/v5/clients/<cid>/processes/<pid>/results. Check the progress of a process and Get results after completion describe both steps. Deepfake detection uses the same paths under https://api.behavioralsignals.com/v5/detection/clients/<cid>/.
With the Python SDK, install the package and put the key in the two environment variables that Client() reads:
pip install behavioralsignals
export BEHAVIORALSIGNALS_CID="<cid>"
export BEHAVIORALSIGNALS_API_KEY="<token>"📊 Check what is left
The status route tells you how much of the trial a key has left. The key goes in two headers, X-Auth-Client for the cid and X-Auth-Token for the token:
curl 'https://portal.behavioralsignals.com/api/v1/anonymous-api-keys/status' \
--header 'X-Auth-Client: <cid>' \
--header 'X-Auth-Token: <token>'{
"expires_at": "2026-10-29T12:14:08.759994Z",
"batch_jobs_left": 2,
"stream_seconds_left": 18,
"max_file_seconds": 300
}expires_atis the time at which the key expires.batch_jobs_leftis the number of batch jobs the key can still start.stream_seconds_leftis the number of streaming seconds the key has left.max_file_secondsis the length, in seconds, of the longest file a batch job accepts.
The route answers 401 Unauthorized when no key matches the cid or the token is wrong, and 410 Gone once the key has expired or been revoked.
⛔ When a request is refused
- A
403from the API means the trial key has expired. This blocks uploads, polling and results, even for completed jobs, so fetch results beforeexpires_at. - A batch job that the key is not allowed to run ends with process status
-2"Insufficient credits". With a trial key, that status means one of three things: the key has expired, the file is longer than 5 minutes, or the 3 jobs are used up. The status route shows how many jobs the key has left and when it expires; compare your file's length withmax_file_secondsyourself. - A stream that goes past 30 seconds, or a second stream opened while one is running, ends with the gRPC status
RESOURCE_EXHAUSTED. - A stream refused with
RESOURCE_EXHAUSTEDand the messageTotal stream limit reachedmeans that all trial streams are busy. Wait a few seconds and try again. - A
429 Too Many Requestsfrom the key request means a daily limit on new keys is reached, usually the 3 keys per IP address. TheRetry-Afterheader says how many seconds to wait. - A
503 Service Unavailablefrom the key request means the API could not be reached, so try again later.
🚀 Keep going with an account
To keep using the API after the trial, register for an account and claim the trial key, so the scripts and agents that already use it keep working. Every new account starts with 30 minutes of behavioral batch processing.
To claim the key, sign in to the console, open API Keys, choose Claim a trial key and paste the cid and the token. After the claim:
- The same
cidandtokenwork as a regular API key of your account, without the trial limits, and use your account's credit. - A key that had already expired works again.
- The results of the jobs you ran during the trial can still be fetched with the same
cidandtoken.
A key can be claimed until 7 days after it expires, and only by one account. You can also create a new API key instead.
Coding agents can read the same instructions as plain text at https://portal.behavioralsignals.com/llms.txt.
Updated 5 days ago

