You have control to the full experience - create conversations, stream responses, manage tags, and track usage through simple HTTP requests.

Base URL: https://api.delphi.ai

Current version: v3

Getting started

1Get an API key

API access is available on the Immortal plan. To get started, reach out to your Delphi contact or email support@delphi.ai.

2Authenticate

Include your API key in the x-api-key header on every request:

curl https://api.delphi.ai/v3/conversation/list?email=user@example.com \  
-H "x-api-key: YOUR_API_KEY"

3Start a conversation

curl -X POST https://api.delphi.ai/v3/conversation \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \ 
-d '{"user_email": "user@example.com"}'

This returns a conversation_id and the clone's initial greeting.

Authentication

All endpoints require an API key passed in the x-api-key header. The key is scoped to a single clone - you can only interact with conversations and users belonging to that clone.

Rate limits

• 120 requests per 60 seconds per API key

• Rate limiting is applied across all endpoints

• If you exceed the limit, you'll receive a 429 Too Many Requests response

Available endpoints

• Audience - Store and manage contextual information about users in your audience.

• Conversations - Create conversations, stream responses, view history, and manage conversation lifecycle.

• Clone - Retrieve your clone's public profile information.

• Questions - Retrieve suggested questions configured for your clone.

• Tags -Create tags and organize your audience.

• Usage - Track consumption metrics and access tiers for your users.

• Voice - Stream voice responses as real-time PCM audio.