---
title: "Get talks"
method: GET
path: "/talks"
tags: ["Talks (Standard Avatars)"]
---

# Get talks

`GET /talks`

## Query parameters

- `limit` number, double
- `token` string

## Response `200`

OK

- GetTalksDto
  - `talks` GetTalkDto[], required
    - `id` string, required — Unique identifier for the object
    - `user_id` string, required — Unique identifier of the user that submitted the talk
    - `source_url` string, required — The URL of the source image to be animated by the driver video. Image type of .jpg | .png
    - `driver_url` string — The URL of the driver video to drive the talk, if not provided a driver video will be selected for you from the predefined DriversBank
    - `created_at` string, required — Talk creation time as iso-8601 string
    - `created_by` string — The user id of the user that created the talk
    - `audio_url` string
    - `started_at` string — Talk start time as iso-8601 string
    - `modified_at` string, required — last modified time as iso-8601 string
    - `status` 'created' | 'done' | 'error' | 'started' | 'rejected', required
    - `result_url` string — s3 uri to the resulting video
    - `metadata` RecordStringAny — Construct a type with a set of properties K of type T
    - `webhook` string — A webhook URL for sending the payload including animate details. In a case of empty value, the webhook will not be triggered
    - `config` TalksConfig
      - `logo` Logo
        - `url` string, required — https url to an ARGB jpg/png image, a default logo is used otherwise
        - `position` integer[], required — position of the logo in pixels from the top left corner (w,h) negative values are subtracted from last pixel
      - `stitch` boolean — Stitch back the animated result to the original image
      - `result_format` 'mp4' | 'mov'
      - `fluent` boolean — Interpolate between the last & first frames of the driver video
      - `pad_audio` number, double — Pad the audio with silence at the end (given in seconds) Will increase the video duration & the credits it consumes
      - `driver_expressions` ExpressionConfig
        - `expressions` TimedExpression[], required — List of TimedExpression to use
          - `start_frame` number, double, required — The frame number for the expression start point.
          - `expression` 'neutral' | 'happy' | 'serious' | 'surprise', required
          - `intensity` number, double, required — Controls the intensity you want for this expression (between 0 no expression, 1 maximum)
        - `transition_frames` number, double — Number of frames to use for the transition between expressions
  - `token` string

## Other responses

- `401` — AuthorizationError

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/revisions/2f2425e1b6b6/schema)