Build with Sunesis

curl https://api.sunesis.ai/v1/voice/generate \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice": "aria",
    "text": "Your order is on its way.",
    "format": "mp3",
    "speed": 1.0
  }'

{
  "id": "gen_9f2c41ab",
  "object": "voice.generation",
  "created_at": "2026-09-14T10:22:03Z",
  "voice": "aria",
  "audio": {
    "url": "https://cdn.sunesis.ai/gen_9f2c41ab.mp3",
    "format": "mp3",
    "duration_ms": 1840,
    "expires_at": "2026-09-21T10:22:03Z"
  },
  "billed": { "characters": 25 }
}

curl https://api.sunesis.ai/v1/voice/transcribe \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/call.wav",
    "diarize": true,
    "timestamps": "segment"
  }'

{
  "id": "txn_4b81de02",
  "object": "voice.transcript",
  "language": "en-US",
  "duration_ms": 12400,
  "text": "Hi, I'm calling about my order. Sure, what's the order number?",
  "segments": [
    { "speaker": "S1", "start_ms": 0,    "end_ms": 2600,  "text": "Hi, I'm calling about my order." },
    { "speaker": "S2", "start_ms": 2900, "end_ms": 5200,  "text": "Sure, what's the order number?" }
  ],
  "billed": { "seconds": 13 }
}

curl https://api.sunesis.ai/v1/voice/clones \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Northbridge brand voice",
    "samples": ["https://example.com/vo-take-1.wav"],
    "consent": {
      "holder": "Northbridge Media Ltd",
      "granted_at": "2026-09-01T09:00:00Z"
    }
  }'

{
  "id": "vc_2d90f7c1",
  "object": "voice.clone",
  "name": "Northbridge brand voice",
  "state": "training",
  "ready_estimate_s": 90,
  "consent": {
    "holder": "Northbridge Media Ltd",
    "granted_at": "2026-09-01T09:00:00Z"
  }
}

curl "https://api.sunesis.ai/v1/voices?type=clone&limit=20" \
  -H "Authorization: Bearer $SUNESIS_KEY"

{
  "object": "list",
  "data": [
    { "id": "vc_2d90f7c1", "name": "Northbridge brand voice", "type": "clone", "state": "ready" },
    { "id": "aria",        "name": "Aria",                    "type": "stock", "state": "ready" }
  ],
  "has_more": true,
  "next_cursor": "eyJvIjoyMH0"
}

curl https://api.sunesis.ai/v1/video/generate \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "avatar": "av_lumen",
    "text": "Here is what changed this week.",
    "voice": "aria",
    "resolution": "1080p"
  }'

{
  "id": "job_7ac3f01b",
  "object": "video.job",
  "state": "queued",
  "progress": 0,
  "eta_s": 42,
  "output": null
}

curl https://api.sunesis.ai/v1/agents \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lumen",
    "instructions": "You are a calm customer care guide. Offer a next step, never a ticket number.",
    "voice": "aria",
    "memory": "persistent"
  }'

{
  "id": "ag_51c7b3de",
  "object": "agent",
  "name": "Lumen",
  "voice": "aria",
  "memory": "persistent",
  "tools": [],
  "created_at": "2026-09-14T10:31:07Z"
}

curl https://api.sunesis.ai/v1/agents/ag_51c7b3de/sessions \
  -H "Authorization: Bearer $SUNESIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "end_user_id": "user_8821", "modality": "voice" }'

{
  "id": "sess_0be49a17",
  "object": "agent.session",
  "agent_id": "ag_51c7b3de",
  "client_token": "cst_live_9c81…",
  "realtime_url": "wss://rt.sunesis.ai/v1/realtime?session=sess_0be49a17",
  "expires_at": "2026-09-14T10:33:07Z"
}

# Realtime is a WebSocket, not a REST call. Inspect it with wscat:
wscat -c "wss://rt.sunesis.ai/v1/realtime?session=sess_0be49a17" \
  -H "Authorization: Bearer $CLIENT_TOKEN"

// Server → client, one JSON frame per event
{ "type": "transcript.delta", "role": "user",  "text": "where is my order" }
{ "type": "tool.call", "id": "tc_1", "name": "lookup_order",
  "arguments": { "order_id": "8821" } }
{ "type": "transcript.delta", "role": "agent", "text": "It's out for delivery." }
{ "type": "turn.done", "latency_ms": 184 }