Developer API · Version 1

Connect AlefBot to your system with an AI agent

Start with a Test key and a prepared agent prompt. Integrate the API into your product after the connection works

Common uses

What you can build

Send audio or video for transcription, track progress and receive a ready result

Media uploadUpload a file securely and start a transcription job

Reliable trackingTrack job status with polling or a webhook

Ready resultsDownload subtitles or text and use them in your existing workflow

First steps

Start with a safe connection

Run a small isolated check first, then integrate the connection into your product

1
Create a Test key
This key checks the connection without processing real media
2
Store it securely
Set `ALEFBOT_API_KEY` in the environment without pasting the secret into chat
3
Copy the agent prompt
The prompt points the agent to the API specifications and asks for a connection check
4
Verify the connection
Continue to product integration and real media only after success

Who can access the API

API keys are available on Premium and Platinum accounts. You can read the guides and documentation before signing up or upgrading

Next step

Check your connection

Create a Test key and store it in an environment variable, then give the prepared prompt to your agent. Never include the key itself in the prompt

API access and keys

View prompt

Help me verify an אלף בוט Public API integration in isolated Test Mode.

Before changing code, inspect the existing workspace and read these canonical sources:
- Agent index: https://alef-bot.top/developers/llms.txt
- OpenAPI: https://alef-bot.top/api/v1/openapi.json
- Arazzo workflow: https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml

Security requirements:
- Read the API key only from the ALEFBOT_API_KEY environment variable.
- Never ask me to paste the key into chat, code, a URL, logs, or test output.
- Do not expose or print the environment variable.

Work in two phases:
1. Create the smallest isolated Test Mode check that follows the documented Upload → Transcribe → Track → Download workflow without processing real media.
2. Run the check and report the files changed, commands run, and observed result.

Do not integrate this into the product until the isolated check succeeds. Do not proceed to Live mode or real media without my explicit approval.

Read the setup guide

Technical sources for agents and developers

Choose the right source: OpenAPI for requests and responses, Arazzo for the complete workflow, Postman for manual checks and llms.txt for AI agents

API reference in English