---
updatedAt: 2026-02-08T07:30:01.000Z
---

Fetch the complete documentation index at: https://docs.d-id.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Quickstart

Create talking head videos from a photo and text

Create a realistic video of a human presenter from just an image and text.\
The Talks endpoint transforms any photo into a speaking avatar.

<CoolSteps name="talks-quickstart">
  <CoolStep number={1} title="Create a video">
    Send a POST request with your image URL and the text you want the avatar to speak.

    ```yaml Request
    curl -X POST "https://api.d-id.com/talks" \
    -H "Authorization: Basic <YOUR KEY>" \
    -H "Content-Type: application/json" \
    -d '{
    "source_url": "https://create-images-results.d-id.com/DefaultPresenters/Noelle_f/image.png",
    "script": {
        "type": "text",
        "input": "Hello! This is my first talking avatar video.",
        "provider": {
            "type": "microsoft",
            "voice_id": "en-US-JennyNeural"
        }
    }
    }'
    ```

    ```json Response
    {
      "id": "tlk_abc123",
      "created_at": "2024-01-15T10:30:00.000Z",
      "status": "created",
      "object": "talk"
    }
    ```

    Save the `id` from the response — you'll need it to check the status and retrieve the video.
  </CoolStep>

  <CoolStep number={2} title="Check the video status">
    Poll the GET endpoint until the status changes to `done`. The video typically takes 10-30 seconds to process.

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

    ```json Response
    {
      "id": "tlk_abc123",
      "status": "done",
      "result_url": "https://result.d-id.com/.../video.mp4"
    }
    ```

    Poll until `status` is `done`. The video typically takes 10-30 seconds to process.
  </CoolStep>

  <CoolStep number={3} title="Get your video">
    Once the status is `done`, the `result_url` field contains a direct link to your generated video. Download or stream the video from this URL.

    ```curl
    curl -O "https://result.d-id.com/.../video.mp4"
    ```

    The video URL is valid for 24 hours. Store the video or re-fetch the talk to get a fresh URL.
  </CoolStep>
</CoolSteps>