# Behavioral Signals API > Behavioral Signals analyses speech for emotion, behavior and deepfakes through a REST and a streaming API. A coding > agent can get a 30-minute trial key with one request, without an account, and use it straight away. This file covers the trial key and pricing. The full API documentation for agents, with every guide and the API reference, is at https://behavioralsignals.readme.io/llms.txt. ## Try without an account Create a trial key. The request has no body and needs no credentials: ```bash curl -X POST https://portal.behavioralsignals.com/api/v1/anonymous-api-keys ``` The response is 201 Created: ```json { "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 } } ``` `cid` is the client id and `token` is the API key. `expires_at` is the time the key stops working, in ISO 8601. The key comes with these limits: - The key is valid for 30 minutes. - It can run 3 batch jobs, and each file can be at most 5 minutes (300 s) long. - It can stream 30 seconds of audio in total. - It can have 1 stream open at a time. - One IP address can create 3 keys per day. ## Use the key Send the token in the `X-Auth-Token` header to the API at https://api.behavioralsignals.com/v5. Every path below is relative to that base URL. The API has three processing types, and all three work the same way: 1. Upload the file as multipart form data, with the file in the `file` field and an optional job name in `name`. 2. Take the `pid` from the response. 3. Poll the process until its `status` is 2. 4. Fetch the results. ### Behavioral analysis of audio - Upload: `POST /clients//processes/audio` - Poll: `GET /clients//processes/` - Results: `GET /clients//processes//results` ### Audio deepfake detection - Upload: `POST /detection/clients//processes/audio` - Poll: `GET /detection/clients//processes/` - Results: `GET /detection/clients//processes//results` ### Video deepfake detection - Upload: `POST /detection/clients//processes/video` - Poll: `GET /detection/clients//processes/video/` - Results: `GET /detection/clients//processes/video//results` ### Example This request starts a behavioral analysis of `audio.wav`: ```bash curl https://api.behavioralsignals.com/v5/clients//processes/audio \ -H 'X-Auth-Token: ' -F 'file=@audio.wav' -F 'name=test' ``` With the Python SDK, run `pip install behavioralsignals`, set `BEHAVIORALSIGNALS_CID` to the `cid` and `BEHAVIORALSIGNALS_API_KEY` to the `token`, and create a `Client()`. ## Check what is left ```bash curl https://portal.behavioralsignals.com/api/v1/anonymous-api-keys/status \ -H 'X-Auth-Client: ' -H 'X-Auth-Token: ' ``` The response is 200 with these fields: - `expires_at`: the time the key stops working, in ISO 8601. - `batch_jobs_left`: the batch jobs the key can still start. - `stream_seconds_left`: the seconds of streaming the key has left. - `max_file_seconds`: the longest file, in seconds, that a batch job can take. A 401 means that no key matches the `cid`, that the token is wrong, or that the key was claimed into an account, where it keeps working. A 410 means that the key has expired or been revoked. ## When a request is refused - A 403 from the API means the trial key has expired. This blocks uploads, polling and results, even for completed jobs, so fetch results before `expires_at` unless the key is claimed into an account (see Sign up). - A batch job that the key may not run ends with process status -2 "insufficient credits". For a trial key this means one of these: - The key has expired - The file is longer than 5 minutes. - The key has used up its 3 jobs. - A stream that goes past 30 seconds, or a second stream while one is open, ends with the gRPC status `RESOURCE_EXHAUSTED`. - A stream refused with `RESOURCE_EXHAUSTED` and the message `Total stream limit reached` means that all trial streams are busy. Wait a few seconds and try again. - A 429 when creating a key means that this IP has made 3 keys today, or that the daily limit for all callers is reached. The `Retry-After` header says how many seconds to wait. - A 503 when creating a key means that the API could not be reached. Try again later. ## Pricing The trial key is free. An account pays for each minute of audio or video it sends, from one prepaid balance in US dollars that every endpoint draws on: - Behavioral analysis, batch: $0.10 per minute. - Behavioral analysis, streaming: $0.15 per minute. - Audio deepfake detection, batch: $0.25 per minute. - Audio deepfake detection, streaming: $0.50 per minute. - Video deepfake detection, batch: $0.50 per minute. Every new account starts with 30 minutes of behavioral batch processing at no cost, and no credit card is needed to sign up. A payment of $50 or more adds 5% extra credit, $100 or more adds 10%, and $200 or more adds 20%. Only the highest tier the payment reaches applies. For negotiated rates or an on-premises deployment, write to sales@behavioralsignals.com. ## Links - [Full API documentation for agents](https://behavioralsignals.readme.io/llms.txt): every guide and the API reference. - [Sign up](https://portal.behavioralsignals.com/signup): sign up and claim this key to keep using it. In the console, open API Keys, choose "Claim a trial key" and paste the `cid` and `token`. The same `cid` and `token` then work without the trial limits and use the account's credit. A key that had already expired works again, and the results of the trial jobs can still be fetched with the same `cid` and `token`. A key can be claimed until 7 days after it expires, and only by one account. - [Python SDK](https://behavioralsignals.readme.io/docs/behavioral-signals-python-sdk): installation and usage.