{"info":{"name":"AlefBot Public API v1","description":"Generated from AlefBot's canonical OpenAPI contract.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://alef-bot.top/api/v1"},{"key":"apiKey","value":"alef_sk_test_your_key_here"},{"key":"uploadId","value":"replace-after-create-upload"},{"key":"jobId","value":"replace-after-create-transcription"},{"key":"artifactFormat","value":"srt"}],"item":[{"name":"Account & keys","item":[{"name":"List API keys","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/keys","description":"List API keys without revealing their secret values."}},{"name":"Create an API key","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/keys","description":"Create a live or test API key with an explicit access scope.","body":{"mode":"raw","raw":"{\n  \"name\": \"CI key\",\n  \"scope\": \"full_access\",\n  \"mode\": \"test\"\n}","options":{"raw":{"language":"json"}}}}},{"name":"Get API account status","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/account","description":"Check plan eligibility, balance, and public API access."}}]},{"name":"Uploads","item":[{"name":"Create an upload slot","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Idempotency-Key","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/uploads","description":"Reserve a short-lived location for one media file.","body":{"mode":"raw","raw":"{\n  \"filename\": \"lecture.mp3\",\n  \"content_type\": \"audio/mpeg\",\n  \"size_bytes\": 10485760\n}","options":{"raw":{"language":"json"}}}},"event":[{"listen":"test","script":{"type":"text/javascript","exec":["const body = pm.response.json(); pm.collectionVariables.set('uploadId', body.upload_id);"]}}]},{"name":"Upload media bytes","request":{"method":"PUT","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/octet-stream"}],"url":"{{baseUrl}}/uploads/{{uploadId}}/binary","description":"Transfer the exact number of bytes declared for an upload slot.","body":{"mode":"file","file":{"src":"path/to/lecture.mp3"}}}}]},{"name":"Transcriptions","item":[{"name":"List transcriptions","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/transcriptions?limit=20&cursor=0","description":"Page through transcription jobs owned by the authenticated account."}},{"name":"Create transcription","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Idempotency-Key","value":"{{$guid}}","type":"text"},{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/transcriptions","description":"Start a transcription from a completed upload. Test keys complete synchronously; live keys normally return 202.","body":{"mode":"raw","raw":"{\n  \"upload_id\": \"{{uploadId}}\",\n  \"translate_to_hebrew\": false,\n  \"model_tier\": \"standard\",\n  \"user_prompt\": \"Preserve legal terminology\",\n  \"output_format\": \"srt\",\n  \"webhook_url\": \"https://client.example.com/webhooks/alefbot\"\n}","options":{"raw":{"language":"json"}}}},"event":[{"listen":"test","script":{"type":"text/javascript","exec":["const body = pm.response.json(); pm.collectionVariables.set('jobId', body.job_id);"]}}]},{"name":"Get transcription status","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/transcriptions/{{jobId}}","description":"Read the latest job state, analysis, usage, and artifact link."}},{"name":"Download a transcription artifact","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/transcriptions/{{jobId}}/artifact?format={{artifactFormat}}","description":"Download the completed transcript in the requested representation."}},{"name":"Download an artifact by extension","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/transcriptions/{{jobId}}/artifact.{{artifactFormat}}","description":"Download a completed transcript using a filename-style format suffix."}}]},{"name":"Webhooks","item":[{"name":"Send a test webhook","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"{{baseUrl}}/webhooks/test","description":"Send a signed test event to a public HTTPS endpoint.","body":{"mode":"raw","raw":"{\n  \"webhook_url\": \"https://client.example.com/webhooks/alefbot\",\n  \"event_type\": \"transcription.completed\"\n}","options":{"raw":{"language":"json"}}}}}]}]}