← Back to Cast

Technical reference

Cast API (powered by E3D)

Full curl reference, CLI usage, and agent integration guide for cast.e3d.ai.

---

Base URL

https://cast.e3d.ai

Authentication

Paid endpoints require an E3D Cast credit key as a Bearer token:

Authorization: Bearer e3d_cast_pay_<key>

Purchase credits via the Cast UI or the payments API.

---

Endpoints

GET Health

curl -s https://cast.e3d.ai/api/cast/health

GET Capabilities

curl -s https://cast.e3d.ai/api/cast/capabilities

POST Quote a job

curl -s -X POST https://cast.e3d.ai/api/cast/jobs/quote \
  -H 'content-type: application/json' \
  -d '{
    "input": { "kind": "transcript", "text": "Host: Hello world\nGuest: Welcome to Cast." },
    "preset": "transcript_short",
    "tier": "starter"
  }'

POST Submit a job

curl -s -X POST https://cast.e3d.ai/api/cast/jobs \
  -H 'Authorization: Bearer e3d_cast_pay_<key>' \
  -H 'Idempotency-Key: my-job-001' \
  -H 'content-type: application/json' \
  -d '{
    "input": { "kind": "transcript", "text": "Host: Hello world\nGuest: Welcome to Cast." },
    "preset": "transcript_short",
    "options": {
      "dryRun": true,
      "subtitleStyle": "bold_mobile",
      "title": "My episode",
      "madeWithCast": true
    }
  }'

GET Job status

curl -s https://cast.e3d.ai/api/cast/jobs/<jobId> \
  -H 'Authorization: Bearer e3d_cast_pay_<key>'

GET Artifacts

curl -s https://cast.e3d.ai/api/cast/jobs/<jobId>/artifacts \
  -H 'Authorization: Bearer e3d_cast_pay_<key>'

POST Cancel a job

curl -s -X POST https://cast.e3d.ai/api/cast/jobs/<jobId>/cancel \
  -H 'Authorization: Bearer e3d_cast_pay_<key>'

POST Revise a job

curl -s -X POST https://cast.e3d.ai/api/cast/jobs/<jobId>/revise \
  -H 'Authorization: Bearer e3d_cast_pay_<key>' \
  -H 'Idempotency-Key: revision-001' \
  -H 'content-type: application/json' \
  -d '{ "revisionType": "subtitle_style", "options": { "subtitleStyle": "clean_podcast" } }'

POST Archive to IPFS

curl -s -X POST https://cast.e3d.ai/api/cast/jobs/<jobId>/archive-ipfs \
  -H 'Authorization: Bearer e3d_cast_pay_<key>' \
  -H 'content-type: application/json' \
  -d '{ "consent": true, "include": ["video","thumbnail","captions","manifest"] }'

---

Credit balance

curl -s 'https://cast.e3d.ai/api/payments/credits/balance?product=cast' \
  -H 'Authorization: Bearer e3d_cast_pay_<key>'

---

e3d-agent CLI

e3d-agent cast render \
  --preset transcript_short \
  --dry-run \
  --webhook https://your-server.com/hooks/cast

---

OpenAPI spec

curl -s https://cast.e3d.ai/openapi/e3d-cast.yaml

LLMs.txt

curl -s https://cast.e3d.ai/llms.txt

Agent capabilities

curl -s https://cast.e3d.ai/.well-known/agent-capabilities.json

---