---
title: "Get conversation details"
method: GET
path: "/getConversationById"
---

# Get conversation details

`GET /getConversationById`

Query conversation details by providing the conversation ID.

## Query parameters

- `conversationId` string, required

## Response `200`

Successfully retrieved conversation details

- GetConversationDetailsResponse
  - `code` string — Response code
  - `message` string — Text message returned by the API
  - `msg` string — Additional message field
  - `success` boolean — Request success flag
  - `data` object — Main conversation data
    - `id` string — Conversation ID
    - `conversationName` string — Conversation name
    - `language` string — Conversation language
    - `corpId` string — Corporate ID
    - `userId` string — User ID
    - `conversationConfigDto` object — Conversation configuration
    - `maxConversation` integer — Maximum concurrent conversations
    - `dataModelIsUsed` integer — Whether data model is used
    - `knowledgeIsUsed` integer — Whether knowledge base is used
    - `fileIsUsed` integer — Whether file is used
    - `thirdIsUsed` integer — Whether third-party integration is used
    - `isFreedom` integer — Whether in freedom mode
    - `asrProvider` string — ASR provider
    - `conversationInfoDto` object — Conversation information details
      - `id` integer — Info ID
      - `name` string — Name
      - `nickName` string — Nickname
      - `gender` integer — Gender (1=Male, 2=Female)
      - `age` integer — Age
      - `height` integer — Height
      - `weight` integer — Weight
      - `characters` string — Character traits
      - `backStory` string — Background story
    - `detailDto` object — Conversation resource details (includes model, background, and TTS configuration)
      - `id` integer — Detail ID
      - `conversationId` string — Conversation ID
      - `proportion` string — Video proportion
      - `terminalType` integer — Terminal type
      - `modelId` string — Model ID
      - `modelIdType` integer — Model type (0 = Cloud Digital Human, 1 = Local Digital Human)
      - `imageId` string — Image ID
      - `sceneId` string — Scene ID
      - `modelName` string — Model name
      - `sceneType` integer — Scene type
      - `background` integer — Background type
      - `backgroundDto` object — Background resource details
        - `id` integer — Background ID
        - `backgroundCode` string — Background code
        - `backgroundName` string — Background name
        - `backgroundUrl` string — Background image or video URL
        - `fileType` integer — File type
        - `proportion` string — Background proportion
        - `userId` string — User ID
      - `modelConfig` object — Model configuration
      - `ttsId` string — TTS ID
      - `ttsName` string — TTS name
      - `ttsConfig` object — TTS configuration
      - `ttsUrl` string — TTS URL
      - `ttsVolume` integer — TTS volume
      - `ttsSpeaker` string — TTS speaker ID
      - `ttsSpeedRate` integer — TTS speed rate
      - `ttsPitch` integer — TTS pitch
      - `ttsSource` integer — TTS source
      - `samplePictureUrl` string — Sample picture URL
      - `videoWidth` integer — Video width
      - `videoHeight` integer — Video height
      - `humanProportion` string — Human proportion
      - `humanWidth` integer — Human width
      - `humanHeight` integer — Human height
      - `humanX` integer — Human X coordinate
      - `humanY` integer — Human Y coordinate
      - `localModelInfo` object — Local digital human information
    - `knowledgeDtoList` unknown[] — Knowledge base list
      - unknown
    - `kbConversationDto` object — Knowledge base conversation
    - `modelDtoList` object[] — Model data transfer object list
      - `id` integer — Model DTO ID
      - `conversationId` string — Conversation ID
      - `largeModelType` integer — Large model type
      - `modelCode` integer — Model code
      - `largeName` string — Large model name
      - `modelId` string — Model ID
      - `prompt` string — Prompt template for the model
      - `botUrl` string — Bot URL
    - `thirdDto` object — Third-party integration data
    - `scriptDtoList` object[] — Predefined dialog scripts
      - `id` integer — Script ID
      - `conversationId` string — Conversation ID
      - `scriptType` integer — Script type (0: Wake-up Word, 1: Opening Line, 2: Waiting Phrase, 3: Unknown Question, 4: Farewell, 5: Interruption, 6: Interruption Sentence, 7: Guiding Phrase)
      - `scriptContent` string — Script text
      - `ttsContent` string — Script audio file URL
      - `emotion` string — Emotion level

---

[API](https://skmtc.dev/duix/apis/duix-openapi-v2.md) · [All operations](https://skmtc.dev/duix/apis/duix-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/duix/duix-openapi-v2/revisions/4ac8f73b87fe/schema)