{"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":"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":"{{createUploadIdempotencyKey}}","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":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.collectionVariables.get('createUploadIdempotencyKey')) { pm.collectionVariables.set('createUploadIdempotencyKey', pm.variables.replaceIn('{{$guid}}')); }"]}},{"listen":"test","script":{"type":"text/javascript","exec":["const body = pm.response.json(); pm.collectionVariables.set('uploadId', body.upload_id);","if (pm.response.code >= 200 && pm.response.code < 300) { pm.collectionVariables.unset('createUploadIdempotencyKey'); }"]}}]},{"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":"{{createTranscriptionIdempotencyKey}}","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}","options":{"raw":{"language":"json"}}}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.collectionVariables.get('createTranscriptionIdempotencyKey')) { pm.collectionVariables.set('createTranscriptionIdempotencyKey', pm.variables.replaceIn('{{$guid}}')); }"]}},{"listen":"test","script":{"type":"text/javascript","exec":["const body = pm.response.json(); pm.collectionVariables.set('jobId', body.job_id);","if (pm.response.code >= 200 && pm.response.code < 300) { pm.collectionVariables.unset('createTranscriptionIdempotencyKey'); }"]}}]},{"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 as SRT, TXT, PDF, or DOCX. Format selection uses the path extension first, then the `format` query parameter, then the `Accept` header, and finally the transcription's `output_format`"}},{"name":"Download an artifact by extension","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"{{baseUrl}}/transcriptions/{{jobId}}/artifact.{{artifactFormat}}","description":"Download the completed transcript as SRT, TXT, PDF, or DOCX using a filename-style path extension. The path extension takes precedence over the `format` query parameter and `Accept` header"}}]},{"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"}}}}}]}]}