curl --request POST \
--url https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"userProfileId": "<string>",
"personaProfileId": "<string>",
"additionalLanguages": [],
"userProfileVersion": "<string>",
"personaProfileVersion": "<string>",
"tags": {},
"testMode": true,
"replyParameters": {
"chatModel": "chat-2-smart",
"bufferSeconds": "5",
"maxProcessingTimeSeconds": "300",
"enableSexualTextContent": null,
"fixedResponseLength": false,
"sentenceLength": null,
"messageLength": null,
"personaPersonality": null,
"generatePersonality": null,
"shareablePictures": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"shareableVideos": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"fluencyDegradation": null,
"multipleMessagesPerReply": false,
"multipleMessagesPerReplyFrequency": null,
"questionFrequency": 0.5,
"replyTypingDelay": "INSTANT",
"icebreakerType": null,
"engageType": null,
"meetingPolicy": null,
"engage": null,
"fictionalDisclosure": true,
"disableSafetyFeatures": true,
"guardrails": {
"maliciousContent": false,
"maliciousContentOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"aiSuspicion": true,
"aiSuspicionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"underageDetection": true,
"underageDetectionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"unknownLanguage": true,
"unknownLanguageOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"messageRepetition": true,
"messageRepetitionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"prohibitedIllegalContent": false,
"prohibitedIllegalContentOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"dangerousDrugUse": false,
"dangerousDrugUseOptionSet": {
"answer": true,
"banDurations": [
123
]
}
},
"preventAggressiveTone": true,
"serviceLoyalty": true,
"personaProfileOverrides": {},
"vision": {
"userProfilePictureAnalysis": false,
"personaProfilePictureAnalysis": false,
"sharedPicturesAnalysis": false,
"sharedVideosAnalysis": false,
"shareablePicturesAnalysis": true,
"shareableVideosAnalysis": false
},
"forcePictureSharing": "<string>",
"forceVideoSharing": "<string>",
"postProcessing": {
"greekRewrite": false,
"russianRewrite": false
}
}
}
'import requests
url = "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue"
payload = {
"userProfileId": "<string>",
"personaProfileId": "<string>",
"additionalLanguages": [],
"userProfileVersion": "<string>",
"personaProfileVersion": "<string>",
"tags": {},
"testMode": True,
"replyParameters": {
"chatModel": "chat-2-smart",
"bufferSeconds": "5",
"maxProcessingTimeSeconds": "300",
"enableSexualTextContent": None,
"fixedResponseLength": False,
"sentenceLength": None,
"messageLength": None,
"personaPersonality": None,
"generatePersonality": None,
"shareablePictures": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"shareableVideos": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"fluencyDegradation": None,
"multipleMessagesPerReply": False,
"multipleMessagesPerReplyFrequency": None,
"questionFrequency": 0.5,
"replyTypingDelay": "INSTANT",
"icebreakerType": None,
"engageType": None,
"meetingPolicy": None,
"engage": None,
"fictionalDisclosure": True,
"disableSafetyFeatures": True,
"guardrails": {
"maliciousContent": False,
"maliciousContentOptionSet": {
"answer": True,
"banDurations": [123]
},
"aiSuspicion": True,
"aiSuspicionOptionSet": {
"answer": True,
"banDurations": [123]
},
"underageDetection": True,
"underageDetectionOptionSet": {
"answer": True,
"banDurations": [123]
},
"unknownLanguage": True,
"unknownLanguageOptionSet": {
"answer": True,
"banDurations": [123]
},
"messageRepetition": True,
"messageRepetitionOptionSet": {
"answer": True,
"banDurations": [123]
},
"prohibitedIllegalContent": False,
"prohibitedIllegalContentOptionSet": {
"answer": True,
"banDurations": [123]
},
"dangerousDrugUse": False,
"dangerousDrugUseOptionSet": {
"answer": True,
"banDurations": [123]
}
},
"preventAggressiveTone": True,
"serviceLoyalty": True,
"personaProfileOverrides": {},
"vision": {
"userProfilePictureAnalysis": False,
"personaProfilePictureAnalysis": False,
"sharedPicturesAnalysis": False,
"sharedVideosAnalysis": False,
"shareablePicturesAnalysis": True,
"shareableVideosAnalysis": False
},
"forcePictureSharing": "<string>",
"forceVideoSharing": "<string>",
"postProcessing": {
"greekRewrite": False,
"russianRewrite": False
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
userProfileId: '<string>',
personaProfileId: '<string>',
additionalLanguages: [],
userProfileVersion: '<string>',
personaProfileVersion: '<string>',
tags: {},
testMode: true,
replyParameters: {
chatModel: 'chat-2-smart',
bufferSeconds: '5',
maxProcessingTimeSeconds: '300',
enableSexualTextContent: null,
fixedResponseLength: false,
sentenceLength: null,
messageLength: null,
personaPersonality: null,
generatePersonality: null,
shareablePictures: [{id: '<string>', url: '<string>', caption: '<string>'}],
shareableVideos: [{id: '<string>', url: '<string>', caption: '<string>'}],
fluencyDegradation: null,
multipleMessagesPerReply: false,
multipleMessagesPerReplyFrequency: null,
questionFrequency: 0.5,
replyTypingDelay: 'INSTANT',
icebreakerType: null,
engageType: null,
meetingPolicy: null,
engage: null,
fictionalDisclosure: true,
disableSafetyFeatures: true,
guardrails: {
maliciousContent: false,
maliciousContentOptionSet: {answer: true, banDurations: [123]},
aiSuspicion: true,
aiSuspicionOptionSet: {answer: true, banDurations: [123]},
underageDetection: true,
underageDetectionOptionSet: {answer: true, banDurations: [123]},
unknownLanguage: true,
unknownLanguageOptionSet: {answer: true, banDurations: [123]},
messageRepetition: true,
messageRepetitionOptionSet: {answer: true, banDurations: [123]},
prohibitedIllegalContent: false,
prohibitedIllegalContentOptionSet: {answer: true, banDurations: [123]},
dangerousDrugUse: false,
dangerousDrugUseOptionSet: {answer: true, banDurations: [123]}
},
preventAggressiveTone: true,
serviceLoyalty: true,
personaProfileOverrides: {},
vision: {
userProfilePictureAnalysis: false,
personaProfilePictureAnalysis: false,
sharedPicturesAnalysis: false,
sharedVideosAnalysis: false,
shareablePicturesAnalysis: true,
shareableVideosAnalysis: false
},
forcePictureSharing: '<string>',
forceVideoSharing: '<string>',
postProcessing: {greekRewrite: false, russianRewrite: false}
}
})
};
fetch('https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'userProfileId' => '<string>',
'personaProfileId' => '<string>',
'additionalLanguages' => [
],
'userProfileVersion' => '<string>',
'personaProfileVersion' => '<string>',
'tags' => [
],
'testMode' => true,
'replyParameters' => [
'chatModel' => 'chat-2-smart',
'bufferSeconds' => '5',
'maxProcessingTimeSeconds' => '300',
'enableSexualTextContent' => null,
'fixedResponseLength' => false,
'sentenceLength' => null,
'messageLength' => null,
'personaPersonality' => null,
'generatePersonality' => null,
'shareablePictures' => [
[
'id' => '<string>',
'url' => '<string>',
'caption' => '<string>'
]
],
'shareableVideos' => [
[
'id' => '<string>',
'url' => '<string>',
'caption' => '<string>'
]
],
'fluencyDegradation' => null,
'multipleMessagesPerReply' => false,
'multipleMessagesPerReplyFrequency' => null,
'questionFrequency' => 0.5,
'replyTypingDelay' => 'INSTANT',
'icebreakerType' => null,
'engageType' => null,
'meetingPolicy' => null,
'engage' => null,
'fictionalDisclosure' => true,
'disableSafetyFeatures' => true,
'guardrails' => [
'maliciousContent' => false,
'maliciousContentOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'aiSuspicion' => true,
'aiSuspicionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'underageDetection' => true,
'underageDetectionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'unknownLanguage' => true,
'unknownLanguageOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'messageRepetition' => true,
'messageRepetitionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'prohibitedIllegalContent' => false,
'prohibitedIllegalContentOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'dangerousDrugUse' => false,
'dangerousDrugUseOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
]
],
'preventAggressiveTone' => true,
'serviceLoyalty' => true,
'personaProfileOverrides' => [
],
'vision' => [
'userProfilePictureAnalysis' => false,
'personaProfilePictureAnalysis' => false,
'sharedPicturesAnalysis' => false,
'sharedVideosAnalysis' => false,
'shareablePicturesAnalysis' => true,
'shareableVideosAnalysis' => false
],
'forcePictureSharing' => '<string>',
'forceVideoSharing' => '<string>',
'postProcessing' => [
'greekRewrite' => false,
'russianRewrite' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue"
payload := strings.NewReader("{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}"
response = http.request(request)
puts response.read_bodyGenerate (asynchronous)
Enqueue a conversation to be processed asynchronously
curl --request POST \
--url https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"userProfileId": "<string>",
"personaProfileId": "<string>",
"additionalLanguages": [],
"userProfileVersion": "<string>",
"personaProfileVersion": "<string>",
"tags": {},
"testMode": true,
"replyParameters": {
"chatModel": "chat-2-smart",
"bufferSeconds": "5",
"maxProcessingTimeSeconds": "300",
"enableSexualTextContent": null,
"fixedResponseLength": false,
"sentenceLength": null,
"messageLength": null,
"personaPersonality": null,
"generatePersonality": null,
"shareablePictures": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"shareableVideos": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"fluencyDegradation": null,
"multipleMessagesPerReply": false,
"multipleMessagesPerReplyFrequency": null,
"questionFrequency": 0.5,
"replyTypingDelay": "INSTANT",
"icebreakerType": null,
"engageType": null,
"meetingPolicy": null,
"engage": null,
"fictionalDisclosure": true,
"disableSafetyFeatures": true,
"guardrails": {
"maliciousContent": false,
"maliciousContentOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"aiSuspicion": true,
"aiSuspicionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"underageDetection": true,
"underageDetectionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"unknownLanguage": true,
"unknownLanguageOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"messageRepetition": true,
"messageRepetitionOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"prohibitedIllegalContent": false,
"prohibitedIllegalContentOptionSet": {
"answer": true,
"banDurations": [
123
]
},
"dangerousDrugUse": false,
"dangerousDrugUseOptionSet": {
"answer": true,
"banDurations": [
123
]
}
},
"preventAggressiveTone": true,
"serviceLoyalty": true,
"personaProfileOverrides": {},
"vision": {
"userProfilePictureAnalysis": false,
"personaProfilePictureAnalysis": false,
"sharedPicturesAnalysis": false,
"sharedVideosAnalysis": false,
"shareablePicturesAnalysis": true,
"shareableVideosAnalysis": false
},
"forcePictureSharing": "<string>",
"forceVideoSharing": "<string>",
"postProcessing": {
"greekRewrite": false,
"russianRewrite": false
}
}
}
'import requests
url = "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue"
payload = {
"userProfileId": "<string>",
"personaProfileId": "<string>",
"additionalLanguages": [],
"userProfileVersion": "<string>",
"personaProfileVersion": "<string>",
"tags": {},
"testMode": True,
"replyParameters": {
"chatModel": "chat-2-smart",
"bufferSeconds": "5",
"maxProcessingTimeSeconds": "300",
"enableSexualTextContent": None,
"fixedResponseLength": False,
"sentenceLength": None,
"messageLength": None,
"personaPersonality": None,
"generatePersonality": None,
"shareablePictures": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"shareableVideos": [
{
"id": "<string>",
"url": "<string>",
"caption": "<string>"
}
],
"fluencyDegradation": None,
"multipleMessagesPerReply": False,
"multipleMessagesPerReplyFrequency": None,
"questionFrequency": 0.5,
"replyTypingDelay": "INSTANT",
"icebreakerType": None,
"engageType": None,
"meetingPolicy": None,
"engage": None,
"fictionalDisclosure": True,
"disableSafetyFeatures": True,
"guardrails": {
"maliciousContent": False,
"maliciousContentOptionSet": {
"answer": True,
"banDurations": [123]
},
"aiSuspicion": True,
"aiSuspicionOptionSet": {
"answer": True,
"banDurations": [123]
},
"underageDetection": True,
"underageDetectionOptionSet": {
"answer": True,
"banDurations": [123]
},
"unknownLanguage": True,
"unknownLanguageOptionSet": {
"answer": True,
"banDurations": [123]
},
"messageRepetition": True,
"messageRepetitionOptionSet": {
"answer": True,
"banDurations": [123]
},
"prohibitedIllegalContent": False,
"prohibitedIllegalContentOptionSet": {
"answer": True,
"banDurations": [123]
},
"dangerousDrugUse": False,
"dangerousDrugUseOptionSet": {
"answer": True,
"banDurations": [123]
}
},
"preventAggressiveTone": True,
"serviceLoyalty": True,
"personaProfileOverrides": {},
"vision": {
"userProfilePictureAnalysis": False,
"personaProfilePictureAnalysis": False,
"sharedPicturesAnalysis": False,
"sharedVideosAnalysis": False,
"shareablePicturesAnalysis": True,
"shareableVideosAnalysis": False
},
"forcePictureSharing": "<string>",
"forceVideoSharing": "<string>",
"postProcessing": {
"greekRewrite": False,
"russianRewrite": False
}
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
userProfileId: '<string>',
personaProfileId: '<string>',
additionalLanguages: [],
userProfileVersion: '<string>',
personaProfileVersion: '<string>',
tags: {},
testMode: true,
replyParameters: {
chatModel: 'chat-2-smart',
bufferSeconds: '5',
maxProcessingTimeSeconds: '300',
enableSexualTextContent: null,
fixedResponseLength: false,
sentenceLength: null,
messageLength: null,
personaPersonality: null,
generatePersonality: null,
shareablePictures: [{id: '<string>', url: '<string>', caption: '<string>'}],
shareableVideos: [{id: '<string>', url: '<string>', caption: '<string>'}],
fluencyDegradation: null,
multipleMessagesPerReply: false,
multipleMessagesPerReplyFrequency: null,
questionFrequency: 0.5,
replyTypingDelay: 'INSTANT',
icebreakerType: null,
engageType: null,
meetingPolicy: null,
engage: null,
fictionalDisclosure: true,
disableSafetyFeatures: true,
guardrails: {
maliciousContent: false,
maliciousContentOptionSet: {answer: true, banDurations: [123]},
aiSuspicion: true,
aiSuspicionOptionSet: {answer: true, banDurations: [123]},
underageDetection: true,
underageDetectionOptionSet: {answer: true, banDurations: [123]},
unknownLanguage: true,
unknownLanguageOptionSet: {answer: true, banDurations: [123]},
messageRepetition: true,
messageRepetitionOptionSet: {answer: true, banDurations: [123]},
prohibitedIllegalContent: false,
prohibitedIllegalContentOptionSet: {answer: true, banDurations: [123]},
dangerousDrugUse: false,
dangerousDrugUseOptionSet: {answer: true, banDurations: [123]}
},
preventAggressiveTone: true,
serviceLoyalty: true,
personaProfileOverrides: {},
vision: {
userProfilePictureAnalysis: false,
personaProfilePictureAnalysis: false,
sharedPicturesAnalysis: false,
sharedVideosAnalysis: false,
shareablePicturesAnalysis: true,
shareableVideosAnalysis: false
},
forcePictureSharing: '<string>',
forceVideoSharing: '<string>',
postProcessing: {greekRewrite: false, russianRewrite: false}
}
})
};
fetch('https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'userProfileId' => '<string>',
'personaProfileId' => '<string>',
'additionalLanguages' => [
],
'userProfileVersion' => '<string>',
'personaProfileVersion' => '<string>',
'tags' => [
],
'testMode' => true,
'replyParameters' => [
'chatModel' => 'chat-2-smart',
'bufferSeconds' => '5',
'maxProcessingTimeSeconds' => '300',
'enableSexualTextContent' => null,
'fixedResponseLength' => false,
'sentenceLength' => null,
'messageLength' => null,
'personaPersonality' => null,
'generatePersonality' => null,
'shareablePictures' => [
[
'id' => '<string>',
'url' => '<string>',
'caption' => '<string>'
]
],
'shareableVideos' => [
[
'id' => '<string>',
'url' => '<string>',
'caption' => '<string>'
]
],
'fluencyDegradation' => null,
'multipleMessagesPerReply' => false,
'multipleMessagesPerReplyFrequency' => null,
'questionFrequency' => 0.5,
'replyTypingDelay' => 'INSTANT',
'icebreakerType' => null,
'engageType' => null,
'meetingPolicy' => null,
'engage' => null,
'fictionalDisclosure' => true,
'disableSafetyFeatures' => true,
'guardrails' => [
'maliciousContent' => false,
'maliciousContentOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'aiSuspicion' => true,
'aiSuspicionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'underageDetection' => true,
'underageDetectionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'unknownLanguage' => true,
'unknownLanguageOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'messageRepetition' => true,
'messageRepetitionOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'prohibitedIllegalContent' => false,
'prohibitedIllegalContentOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
],
'dangerousDrugUse' => false,
'dangerousDrugUseOptionSet' => [
'answer' => true,
'banDurations' => [
123
]
]
],
'preventAggressiveTone' => true,
'serviceLoyalty' => true,
'personaProfileOverrides' => [
],
'vision' => [
'userProfilePictureAnalysis' => false,
'personaProfilePictureAnalysis' => false,
'sharedPicturesAnalysis' => false,
'sharedVideosAnalysis' => false,
'shareablePicturesAnalysis' => true,
'shareableVideosAnalysis' => false
],
'forcePictureSharing' => '<string>',
'forceVideoSharing' => '<string>',
'postProcessing' => [
'greekRewrite' => false,
'russianRewrite' => false
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue"
payload := strings.NewReader("{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dumgum.com/cs/v1/content_creation/conversations/enqueue")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"userProfileId\": \"<string>\",\n \"personaProfileId\": \"<string>\",\n \"additionalLanguages\": [],\n \"userProfileVersion\": \"<string>\",\n \"personaProfileVersion\": \"<string>\",\n \"tags\": {},\n \"testMode\": true,\n \"replyParameters\": {\n \"chatModel\": \"chat-2-smart\",\n \"bufferSeconds\": \"5\",\n \"maxProcessingTimeSeconds\": \"300\",\n \"enableSexualTextContent\": null,\n \"fixedResponseLength\": false,\n \"sentenceLength\": null,\n \"messageLength\": null,\n \"personaPersonality\": null,\n \"generatePersonality\": null,\n \"shareablePictures\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"shareableVideos\": [\n {\n \"id\": \"<string>\",\n \"url\": \"<string>\",\n \"caption\": \"<string>\"\n }\n ],\n \"fluencyDegradation\": null,\n \"multipleMessagesPerReply\": false,\n \"multipleMessagesPerReplyFrequency\": null,\n \"questionFrequency\": 0.5,\n \"replyTypingDelay\": \"INSTANT\",\n \"icebreakerType\": null,\n \"engageType\": null,\n \"meetingPolicy\": null,\n \"engage\": null,\n \"fictionalDisclosure\": true,\n \"disableSafetyFeatures\": true,\n \"guardrails\": {\n \"maliciousContent\": false,\n \"maliciousContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"aiSuspicion\": true,\n \"aiSuspicionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"underageDetection\": true,\n \"underageDetectionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"unknownLanguage\": true,\n \"unknownLanguageOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"messageRepetition\": true,\n \"messageRepetitionOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"prohibitedIllegalContent\": false,\n \"prohibitedIllegalContentOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n },\n \"dangerousDrugUse\": false,\n \"dangerousDrugUseOptionSet\": {\n \"answer\": true,\n \"banDurations\": [\n 123\n ]\n }\n },\n \"preventAggressiveTone\": true,\n \"serviceLoyalty\": true,\n \"personaProfileOverrides\": {},\n \"vision\": {\n \"userProfilePictureAnalysis\": false,\n \"personaProfilePictureAnalysis\": false,\n \"sharedPicturesAnalysis\": false,\n \"sharedVideosAnalysis\": false,\n \"shareablePicturesAnalysis\": true,\n \"shareableVideosAnalysis\": false\n },\n \"forcePictureSharing\": \"<string>\",\n \"forceVideoSharing\": \"<string>\",\n \"postProcessing\": {\n \"greekRewrite\": false,\n \"russianRewrite\": false\n }\n }\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
Bearer authentication header of the form Bearer <token>, where <token> is an access key.
Example: Authorization: Bearer sk-proj-XXXXXXXXX
Body
Represents a request to enqueue a conversation
A user profile ID; this will represent the profile that will receive the generated reply.
A persona profile ID; this will represent the profile that our operator will impersonate.
The language used to generate the reply.
EN, EN_GB, FR, FR_BE, RO, NL, ES, DE, DE_CH, DE_AT, 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_HU, CS_CZ, EL_GR, EL_GR_LATIN, EL_GR_GREEK, HR_HR, TR_TR, EN_IE, AF_ZA, ZU_ZA, LV_LV, SK_SK, GA_IE, SR_RS, ET_EE, EN_CA, FR_CA, RU_RU, UA_UA A list of additional languages that can be used to generate the reply. Currently, we support only one additional language.
1EN, EN_GB, FR, FR_BE, RO, NL, ES, DE, DE_CH, DE_AT, 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_HU, CS_CZ, EL_GR, EL_GR_LATIN, EL_GR_GREEK, HR_HR, TR_TR, EN_IE, AF_ZA, ZU_ZA, LV_LV, SK_SK, GA_IE, SR_RS, ET_EE, EN_CA, FR_CA, RU_RU, UA_UA Specify the current user profile version. If it differs from the stored version, it will trigger a profile data refresh.
Specify the current persona profile version. If it differs from the stored version, it will trigger a profile data refresh.
Specify whether the conversation should be processed in test mode. In test mode, you will receive a dummy answer, which is useful for testing purposes.
You will not be charged when using test mode.
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.
Hide child attributes
Hide child attributes
Allows you to set the AI chat model to use for generating the reply.
If not specified, the default model will be used.
The default model is dating-smart-1.
π¨π¨π¨ IMPORTANT NOTE: the default model is subject to change at any time, if you want to stick with a specific model make sure to provide it explicitly.
chat-2-smart, chat-2-pro Allows you to set the AI buffer time (in seconds). This delay enables the AI to wait before generating a response, allowing it to accumulate more messages.
If not specified, defaults to 5 seconds.
0 <= x <= 180Allows you to set the maximum processing time (in seconds) for a reply.
If this time limit is exceeded, the conversation will be dropped, and
you will receive an conversation.dropped webhook event.
If not specified, defaults to 300 seconds.
WARNING: This value may occasionally be exceeded by several seconds due to various factors.
300 <= x <= 86400Allows our chat models to generate sexual text content.
If not specified, defaults to true.
Force our chat model to strictly respect aiSentenceLength and aiMessageLength parameters.
If not specified, defaults to false.
Allow you to specify the length of the sentences composing the response.
SHORT, REGULAR, LONG Allow you to specify the length of the response
SHORT, REGULAR, LONG, VERY_LONG Allow you to override the personality given to the persona
SUPPORTIVE, TEASING, CONFIDENT, GEEKY, POETIC, HIGH_ENERGY, INTELLECTUAL, ROMANTIC, SARCASTIC, POSSESSIVE, NATURAL, APPRECIATIVE, PASSIONATE Automatically generate the personality of the persona profile (SoulEngine). This will incurs an additional cost to the reply.
A list of shareable picture objects that the persona is allowed to send when the user requests an image. Picture sharing is only supported on specific chat models:
| Chat Model | Picture Sharing Support |
|---|---|
chat-2-pro | β Enabled |
chat-2-smart | β Enabled |
dating-pro-1 | β Not Supported |
dating-smart-1 | β Not Supported |
Hide child attributes
Hide child attributes
Your identifier for this picture. Keep it stable across requests: we use it to remember which pictures have already been shared in the conversation, so a changing id makes the persona offer the same picture again.
1 - 128URL we fetch the picture from. Maximum 512 characters. HTTPS is strongly recommended.
1 - 512A custom caption of the picture, this can be used to override the default caption generated by our AI.
1 - 100A list of shareable video objects that the persona is allowed to send when the user requests a video. A reply carries at most one medium: either a picture or a video, never both. Video sharing is only supported on specific chat models:
| Chat Model | Video Sharing Support |
|---|---|
chat-2-pro | β Enabled |
chat-2-smart | β Enabled |
dating-pro-1 | β Not Supported |
dating-smart-1 | β Not Supported |
Hide child attributes
Hide child attributes
Your identifier for this video. Keep it stable across requests: we use it to remember which videos have already been shared in the conversation, so a changing id makes the persona offer the same video again.
1 - 128URL we fetch the video from. Maximum 512 characters. HTTPS is strongly recommended.
1 - 512A custom caption of the video, this can be used to override the default caption generated by our AI.
1 - 100Allows our operator/chat models to add emojis to the reply.
| Emoji Frequency | Description |
|---|---|
FREQUENT | 50% at least 1 and maybe 1 more emoji if appropriate / 50% 1 if appropriate |
SOMETIMES | 75% 1 if appropriate / 25% no emoji |
RARELY | 75% no emoji / 25% 1 if appropriate |
NEVER | 100% no emoji |
FREQUENT, SOMETIMES, RARELY, NEVER Allows our chat model to degrade the text content generation quality to improve human-like response. Defaults to NONE or LOW randomly (50/50).
LOW, MEDIUM, HIGH, NONE Allows our AI to split a long response into multiple shorter messages. If not specified, defaults to false.
This provides a more natural conversation flow by breaking down lengthy responses.
Note that every message sent has its own answer.created event.
Changes the chances of replying with several messages.
Ignored unless multiple messages per reply are enabled β either with multipleMessagesPerReply on this request, or in your project settings.
VERY_FREQUENT, FREQUENT, OCCASIONAL, RARE Define the frequency of questions in the conversation.
This can be used to control the pace and engagement of the conversation.
The frequency control is best effort, and it may not always be perfectly accurate due to the nature of AI-generated responses.
Example: 0.5 will result in 50% of the messages being questions.
0 <= x <= 1Introduces a delay between the answer.processing and answer.created events to simulate human-like typing behavior. This can enhance user experience by making responses feel more natural. See the Notify Your End Users use case for implementation example.
INSTANT, FAST, NORMAL Deprecated β use engageType instead. Still honored for backward compatibility (and accepted on NUDGE/REVIVE as well, like engageType).
Specifies the type of icebreaker message to use when starting a conversation.
| Type | Description |
|---|---|
AUTO | Automatically selects appropriate ice-breaker type |
NO_PHOTO | Message about user having no photos |
MISSING_DETAIL | Message about incomplete profile details |
MUCH_YOUNGER | Message addressing significant age difference (user younger) |
MUCH_OLDER | Message addressing significant age difference (user older) |
NEARBY | Message highlighting close proximity |
GENERIC | General conversation starter |
USER_ONLINE | Message acknowledging user is currently online |
USER_OFFLINE | Message for offline users |
JUST_JOINED | Welcome message for new users |
EROTIC | The persona will initiate the conversation with a strongly erotic message |
PHOTO_COMMENT | The Persona will engage the conversation by commenting the User main picture |
HAPPY_BIRTHDAY | Wish the User a happy birthday (valid on ICEBREAKER, NUDGE, and REVIVE) |
Icebreaker-only types (NO_PHOTO, MISSING_DETAIL, MUCH_YOUNGER, MUCH_OLDER, NEARBY, GENERIC, USER_ONLINE, USER_OFFLINE, JUST_JOINED, PHOTO_COMMENT) require engage = AUTO or ICEBREAKER; if sent for an engage mode they are not valid for, they fall back to AUTO.
If PHOTO_COMMENT is used while the user doesn't have a main picture, the type will default to AUTO.
AUTO, NO_PHOTO, MISSING_DETAIL, MUCH_YOUNGER, MUCH_OLDER, NEARBY, GENERIC, USER_ONLINE, USER_OFFLINE, JUST_JOINED, PHOTO_COMMENT, EROTIC, HAPPY_BIRTHDAY Specifies the angle for an engagement message. Applies across engage modes (ICEBREAKER, NUDGE, REVIVE) per each type's applicability. If a type is sent for an engage mode it is not valid for, it falls back to AUTO. Replaces the deprecated icebreakerType.
Two silent fallbacks to AUTO to be aware of: when engage is not set the type is validated against ICEBREAKER, and PHOTO_COMMENT falls back to AUTO when the user profile has no main picture.
AUTO, NO_PHOTO, MISSING_DETAIL, MUCH_YOUNGER, MUCH_OLDER, NEARBY, GENERIC, USER_ONLINE, USER_OFFLINE, JUST_JOINED, PHOTO_COMMENT, EROTIC, HAPPY_BIRTHDAY Controls how the Persona handles in-person meeting requests from the user.
| Value | Description |
|---|---|
DEFAULT_MODE | (default when null) Warm refusal using a plausible personal excuse. Uses the stored long-term memory excuse if one is already present. |
DEFERRED_MEETING | Expresses genuine desire to meet first, then softly refuses with a personal excuse, and ends on a hopeful note. |
RAINCHECK | Declines with a specific, time-bound excuse and explicitly signals that meeting will happen later. Re-engages by showing interest in the user. |
CHAT_ONLY | Firm but warm redirect back to the conversation. No implied future possibility of meeting. No personal-life excuses. |
EAGER_TO_MEET | Always accepts meeting requests with immediate enthusiasm, treating the meeting as real and imminent. Pure fantasy β never refuses, defers, or breaks the illusion. Excluded from the IRL_MEETING_ACCEPTANCE guardrail. |
DEFAULT_MODE, DEFERRED_MEETING, RAINCHECK, CHAT_ONLY, EAGER_TO_MEET Manages engagement messages in conversations. By default, engagement messages are disabled.
Set to AUTO for context-based engagement type selection.
Note: Using specific values instead of AUTO will force that engagement type regardless of context.
| Value | Description |
|---|---|
AUTO | Selects best engagement type based on context |
ICEBREAKER | Sends an icebreaker message when starting a new conversation. You can specify the engageType parameter (the canonical field) to force a specific type; icebreakerType is still accepted for backward compatibility. |
NUDGE | Sends re-engagement message after inactivity |
REVIVE | Sends messages to reactivate dormant conversations |
Takes precedence over action: when an engagement message is produced, an action sent on the same request (such as PAUSE_CONVERSATION or USER_PHOTO_REACTION) is ignored. Send them on separate requests.
AUTO, ICEBREAKER, NUDGE, REVIVE When enabled and the AI Suspicion guardrail is triggered, the persona will disclose that it is a fictitious profile instead of denying it.
Requires the AI Suspicion guardrail to be on (guardrails.aiSuspicion, enabled by default) β with it off, this has no effect.
Allows you to disable the Core Guardian security features for our chat models. You will be responsible for ensuring the content is safe for all users.
Selects which Core Guardian guardrails run for this request.
This object replaces your project's Core Guardian settings β it is not merged with them. Any guardrail you leave out falls back to the platform default, not to what you configured in the dashboard, so send the complete set whenever you use this parameter.
Ignored when disableSafetyFeatures is true, which turns every guardrail off.
Hide child attributes
Hide child attributes
Enable/Disable Malicious Content guardrail
Overrides answer and banDurations for the Malicious Content guardrail. Only applies when maliciousContent is true.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5Enable/Disable AI Suspicion guardrail
Overrides answer and banDurations for the AI Suspicion guardrail. Only applies when aiSuspicion is true.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5Enable/Disable Underage Detection guardrail
Overrides answer and banDurations for the Underage Detection guardrail. Only applies when underageDetection is true.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5Enable/Disable Unknown Language guardrail
Overrides answer and banDurations for the Unknown Language guardrail. Only applies when unknownLanguage is true.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5Enable/Disable Message Repetition guardrail
Overrides answer and banDurations for the Message Repetition guardrail. Only applies when messageRepetition is true.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5[Deprecated: Is not used and will be removed in the future] Enables Prohibited Illegal Content guardrail
This guardrail is deprecated and will be removed in the future.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5[Deprecated: Is not used and will be removed in the future] Enables Dangerous Drug Use guardrail
This guardrail is deprecated and will be removed in the future.
Hide child attributes
Hide child attributes
Whether the persona still sends a final message when this guardrail bans the user. Defaults to true.
Escalating ban durations for this guardrail, in seconds β up to 5 values.
The first applies to the user's first offence, the next to the following one; the last value repeats for every further offence.
Defaults to [7200, 43200, 86400, 172800, 3153600000] (2h, 12h, 24h, 48h, permanent), or [3153600000] for the Underage guardrail.
A permanent ban is the sentinel 3153600000 (about a century).
The dashboard takes these durations in hours and converts them for you.
5If set to true, the AI will avoid using an aggressive or confrontational tone, even when the user is being rude, insulting, or hostile. It will remain calm, polite, and non-reactive in all situations, and will not retaliate or escalate the conversation.
If set to true, the Persona will never validate or agree with complaints about the platform, service, or pricing. Instead, the Persona will deflect warmly in character and occasionally express genuine appreciation for being on the platform. This prevents the Persona from reinforcing negative sentiment that could lead users to disengage.
Allows you to override a subset of persona profile attributes for the current request
Hide child attributes
Hide child attributes
This parameter adjusts the Personaβs sexual appetite and likelihood to engage in sexting.
| Value | Description |
|---|---|
NONE | The Persona will never send sexually explicit replies. |
LOW | The Persona will rarely initiate or respond to sexual topics, even if prompted. |
NORMAL | The Persona may engage in sexting if the conversation naturally leads there. |
HIGH | The Persona will respond positively and proactively to sexual cues from the User faster. |
VERY_HIGH | The Persona will initiate or escalate sexting as soon as the User shows any sexual intent. |
VERY_HIGH, HIGH, NORMAL, LOW, NONE Enable vision features that allow the AI to interpret, analyze, and understand images.
Vision capability by model:
| Model | Vision Support |
|---|---|
chat-2-pro | β Enabled |
chat-2-smart | β Enabled |
dating-pro-1 | β Not Supported |
dating-smart-1 | β Not Supported |
Hide child attributes
Hide child attributes
Enable user profile's picture analysis.
Enable persona profile's picture analysis.
Enable user's shared pictures analysis.
The pictures are analysed on their own, but comparing them against the user's profile picture (so the persona can tell whether it is the same person) also requires userProfilePictureAnalysis.
Enable user's shared videos analysis.
Enable persona's shareable pictures analysis, this will allows our chat model to understand each image it is sharing.
Enable persona's shareable videos analysis, this will allows our chat model to understand each video it is sharing. Videos carrying a caption are never analyzed.
Controls how willingly the persona shares photos. NORMAL (default): only shares when explicitly asked. EAGER: shares naturally when the conversation calls for it.
NORMAL, EAGER Force the persona to share a picture in this reply (chat-2 models only). The value "true" (case-insensitive, surrounding whitespace ignored) forces a send and auto-picks from shareablePictures. Any other value is treated as a picture URL to force (one of shareablePictures, or an arbitrary URL analyzed on the fly). Omit or null for no forcing β the persona decides naturally. If the forced picture fails moderation it is silently dropped to a text-only reply.
Force the persona to share a video in this reply. The value "true" (case-insensitive, surrounding whitespace ignored) β force and auto-pick from shareableVideos. Any other value is treated as a video URL to force (in shareableVideos, or arbitrary β analyzed on the fly). Null β no forcing; the persona decides naturally. A reply carries at most one medium: when forcePictureSharing also resolves, the picture wins. chat-2 only.
Available actions:
| Action | Description |
|---|---|
PAUSE_CONVERSATION | This feature requests the Persona to send a message indicating that they are temporarily pausing the conversation without specifying a timeline for resuming. This is useful if you disconnect your Personas or limit your Users' messages. Optionally, you can specify a pause duration to be respected on DumGum. During this period, our platform will not respond to any new User messages in the affected conversation. |
USER_PHOTO_REACTION | Requests the Persona to send a message reacting to one of the User's photos. Provide a userPhotoReaction object with a source (PROFILE_PICTURE or URL). When source is URL, a url pointing to the photo is required; for PROFILE_PICTURE the User's profile picture is used and url is optional. |
Hide child attributes
Hide child attributes
The type of the action.
PAUSE_CONVERSATION, USER_PHOTO_REACTION Optional pause conversation parameters.
Hide child attributes
Hide child attributes
Optional duration of the pause in seconds (maximum 12 hours). By default, the conversation will not be paused on DumGum side.
1 <= x <= 43200Hide child attributes
Hide child attributes
The source of the photo.
PROFILE_PICTURE, URL The URL of the photo. Required when source is set to URL.
Optional caption describing the photo. When set (non-blank), it is used as the photo description instead of the automatic vision analysis.
Allow you to customize the post-processing of the generated content. This can be used to replace specific characters or remove certain elements from the generated text.
Hide child attributes
Hide child attributes
Used for Greek answer generations. Replace ";" by "?" and accentuated characters by their non-accentuated equivalents.
Used for Russian answer generations. Remove quotation marks the model places around individual slang words or short informal expressions, while leaving genuine quoted sentences intact.
Response
No Content