Skip to main content
POST
/
cs
/
v1
/
content_creation
/
conversations
/
generate
Generate a reply
curl --request POST \
  --url https://api.dumgum.com/cs/v1/content_creation/conversations/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userProfile": {
    "id": "<string>",
    "gender": "WOMAN",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "ethnicity": "ASIAN",
      "height": 123,
      "weight": 123,
      "eyesColor": "BLACK",
      "hairColor": "BLACK",
      "hairLength": "AVERAGE",
      "maritalStatus": "SINGLE",
      "job": "<string>",
      "interests": [
        "TAILORING"
      ],
      "bdsmInterests": [
        "BDSM_BLOOD_PLAY"
      ],
      "sexualInterests": [
        "ANAL"
      ],
      "lookingFor": [
        "MAN"
      ],
      "sexualOrientation": "HETEROSEXUAL",
      "childrenCount": 123,
      "wantsChildren": "YES",
      "surgeryStatus": "UNKNOWN",
      "unitSystem": "METRIC",
      "livingWith": "ALONE"
    },
    "personality": "SUPPORTIVE",
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "gender": "WOMAN",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "sex": "MALE",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "personaProfile": {
    "id": "<string>",
    "gender": "WOMAN",
    "version": "2025-01-01T12:34:20Z",
    "firstName": "<string>",
    "nickname": "<string>",
    "description": "<string>",
    "birthdate": "1990-05-14",
    "countryCode": "FR",
    "city": "<string>",
    "postalCode": "<string>",
    "timeZone": "Europe/Paris",
    "features": {
      "ethnicity": "ASIAN",
      "height": 123,
      "weight": 123,
      "eyesColor": "BLACK",
      "hairColor": "BLACK",
      "hairLength": "AVERAGE",
      "maritalStatus": "SINGLE",
      "job": "<string>",
      "interests": [
        "TAILORING"
      ],
      "bdsmInterests": [
        "BDSM_BLOOD_PLAY"
      ],
      "sexualInterests": [
        "ANAL"
      ],
      "lookingFor": [
        "MAN"
      ],
      "sexualOrientation": "HETEROSEXUAL",
      "childrenCount": 123,
      "wantsChildren": "YES",
      "surgeryStatus": "UNKNOWN",
      "unitSystem": "METRIC",
      "livingWith": "ALONE"
    },
    "personality": "SUPPORTIVE",
    "mainPictureUrl": "https://example.org/images/public.jpg",
    "pictures": [
      "https://example.org/images/public.jpg"
    ],
    "privatePictures": [
      "https://example.org/images/private.jpg"
    ],
    "expiresAt": "2025-01-01T12:34:20Z",
    "children": [
      {
        "name": "<string>",
        "gender": "WOMAN",
        "age": 123
      }
    ],
    "pets": [
      {
        "name": "<string>",
        "sex": "MALE",
        "age": 123,
        "breed": "<string>",
        "type": "<string>"
      }
    ]
  },
  "language": "EN",
  "messages": [
    {
      "id": "<string>",
      "sender": "USER",
      "date": "2023-04-25T10:00:00Z",
      "pictureUrls": [
        "<string>"
      ],
      "poke": true,
      "gifts": [
        {
          "name": "<string>",
          "tier": "LOW"
        }
      ],
      "text": "<string>"
    }
  ],
  "additionalLanguages": [
    "EN"
  ],
  "tags": {},
  "replyParameters": {
    "chatModel": "dating-smart-1",
    "bufferSeconds": "5",
    "maxProcessingTimeSeconds": "300",
    "enableSexualTextContent": null,
    "fixedResponseLength": false,
    "sentenceLength": null,
    "messageLength": null,
    "personaPersonality": null,
    "generatePersonality": null,
    "shareablePictures": [
      {
        "id": "<string>",
        "url": "<string>",
        "caption": "<string>"
      }
    ],
    "profileDistance": 123,
    "emojis": "FREQUENT",
    "fluencyDegradation": null,
    "multipleMessagesPerReply": false,
    "multipleMessagesPerReplyFrequency": null,
    "questionFrequency": 0.5,
    "replyTypingDelay": "INSTANT",
    "icebreakerType": null,
    "engage": null,
    "disableSafetyFeatures": true,
    "guardrails": {
      "maliciousContent": true,
      "aiSuspicion": false,
      "underageDetection": true,
      "unknownLanguage": true,
      "messageRepetition": true
    },
    "preventAggressiveTone": true,
    "personaProfileOverrides": {
      "sexualDrive": "VERY_HIGH"
    },
    "vision": {
      "userProfilePictureAnalysis": false,
      "personaProfilePictureAnalysis": false,
      "sharedPicturesAnalysis": false,
      "shareablePicturesAnalysis": true
    }
  }
}
'
{
  "answers": [
    {
      "id": "answer_XXXXXXXXXXXXXXXXXX",
      "userProfileId": "<string>",
      "personaProfileId": "<string>",
      "type": "TEXT",
      "tags": {},
      "cost": "<string>",
      "responseTime": 123,
      "sequenceNumber": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "text": "Lorem ipsum dolor sit amet.",
      "pictureUrl": null,
      "conversationStopReason": null,
      "conversationStoppedUntil": null,
      "parentAnswerId": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is an access key.

Example: Authorization: Bearer sk-proj-XXXXXXXXX

Body

application/json

Represents a request to generate a response to a conversation

userProfile
object
required

A user profile; this will represent the profile that will receive the generated reply.

personaProfile
object
required

A persona profile; this will represent the profile that our operator will impersonate.

language
enum<string>
required

The language used to generate the reply.

Available options:
EN,
EN_GB,
FR,
FR_BE,
RO,
NL,
ES,
DE,
IT,
ES_LATAM,
BG,
HE,
JA,
NL_BE,
EN_AU,
PT_PT,
PT_BR,
SV_SE,
DA_DK,
FI_FI,
PL_PL,
LT_LT,
NB_NO,
NN_NO,
SL_SI,
HU_HU,
CS_CZ,
EL_GR,
HR_HR,
TR_TR,
EN_IE,
AF_ZA,
ZU_ZA
messages
object[]
required

A list of message describing the history of the conversation

additionalLanguages
enum<string>[]

A list of additional languages that can be used to generate the reply. Currently, we support only one additional language.

Maximum array length: 1
Available options:
EN,
EN_GB,
FR,
FR_BE,
RO,
NL,
ES,
DE,
IT,
ES_LATAM,
BG,
HE,
JA,
NL_BE,
EN_AU,
PT_PT,
PT_BR,
SV_SE,
DA_DK,
FI_FI,
PL_PL,
LT_LT,
NB_NO,
NN_NO,
SL_SI,
HU_HU,
CS_CZ,
EL_GR,
HR_HR,
TR_TR,
EN_IE,
AF_ZA,
ZU_ZA
tags
object

A map of tags to associate with the generated answer. You can use any key-value pair to store additional information along with your request. You can use this to store arbitrary metadata, for events tracking or statistics.

replyParameters
object

A set of parameters that allow you to customize the reply you receive from us, enabling greater flexibility and control over the response format, content, and behavior.

Response

200 - */*

OK

answers
object[]
required