Agent Quickstart

Create an interactive AI agent with a digital avatar. Define the avatar appearance, voice, and LLM instructions in a single API call.

Create an agent

Create an agent with a video avatar (Clip type) and define how it should behave.

curl -X POST "https://api.d-id.com/agents" \
  -H "Authorization: Basic <YOUR KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "preview_name": "Amber",
    "presenter": {
      "type": "clip",
      "presenter_id": "v2_public_Amber@0zSz8kflCN",
      "voice": {
        "type": "microsoft",
        "voice_id": "en-US-JennyMultilingualV2Neural"
      }
    },
    "llm": {
      "provider": "openai",
      "model": "gpt-4.1-mini",
      "instructions": "you are a helpful assistant"
    }
  }'

{
  "id": "agt_abc123",
  "preview_name": "Amber",
  "status": "created",
  "created": "2024-01-15T10:30:00.000Z",
  "presenter": {
    "type": "clip",
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "voice": {
      "type": "microsoft",
      "voice_id": "en-US-JennyMultilingualV2Neural"
    }
  },
  "llm": {
    "provider": "openai",
    "model": "gpt-4.1-mini",
    "instructions": "you are a helpful assistant"
  }
}

Save the id — this is your agentId for creating sessions and managing the agent.

Verify the agent

Confirm the agent was created successfully by fetching its details.

curl -X GET "https://api.d-id.com/agents/agt_abc123" \
  -H "Authorization: Basic <YOUR KEY>"

{
  "id": "agt_abc123",
  "preview_name": "Amber",
  "status": "done",
  "presenter": {
    "type": "clip",
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "idle_video": "https://clips-presenters.d-id.com/.../idle.mp4"
  }
}

Your agent is ready! The idle_video URL contains the avatar's idle animation. Next, create a client key and use the SDK to start real-time conversations.