---
updatedAt: 2026-02-08T21:15:57.000Z
agentTools:
  projectIndex: https://docs.d-id.com/llms.txt
---

# Agents

Create an AI agent with a digital avatar

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

<CoolSteps name="agent-quickstart">
  <CoolStep number={1} title="Create an agent">
    Create an agent with a video avatar (Clip type) and define how it should behave.

    ```yaml Request
    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"
        }
      }'
    ```

    ```json Response
    {
      "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.
  </CoolStep>

  <CoolStep number={2} title="Verify the agent">
    Confirm the agent was created successfully by fetching its details.

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

    ```json Response
    {
      "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.
  </CoolStep>
</CoolSteps>