curl --request POST \
--url https://api.dumgum.com/cs/v1/content_creation/suggestion \
--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"
}
],
"sticker": "<string>",
"text": "<string>"
}
]
}
'{
"suggestions": "['Lorem ipsum dolor sit amet.', 'Consectetur adipiscing elit.', 'Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.']"
}Generate suggestions for the user based on the provided conversation history
curl --request POST \
--url https://api.dumgum.com/cs/v1/content_creation/suggestion \
--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"
}
],
"sticker": "<string>",
"text": "<string>"
}
]
}
'{
"suggestions": "['Lorem ipsum dolor sit amet.', 'Consectetur adipiscing elit.', 'Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.']"
}Bearer authentication header of the form Bearer <token>, where <token> is an access key.
Example: Authorization: Bearer sk-proj-XXXXXXXXX
A user profile; this will represent the profile that will receive the generated suggestions.
Hide child attributes
The profile's ID (must be the same as the profileId parameter passed to the endpoint).
Gender of the profile owner.
WOMAN, MAN, TRANS_MAN, TRANSMASCULINE, TRANS_WOMAN, TRANSFEMININE An arbitrary string compared against the one stored in our profile database; any mismatch will trigger a profile data refresh. For example, you can use the latest update date as the version number.
"2025-01-01T12:34:20Z"
First name of the profile owner. You must provide either a first name or a nickname. At least one is required.
Nickname of the profile owner. You must provide either a first name or a nickname. At least one is required.
Description of the profile.
Birthdate of the profile owner, formatted as yyyy-MM-dd.
"1990-05-14"
Country code of the profile owner. Must be a two-letter ISO 3166-1 alpha-2 code.
2"FR"
City of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the city will be ignored.
64Postal code of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the postal code will be ignored.
64Time zone of the profile owner. See our supported time zones list.
"Europe/Paris"
Features of the profile.
Hide child attributes
The ethnicity of the profile. Default is null.
ASIAN, BLACK, CAUCASIAN, MIDDLE_EAST, HISPANIC_LATINO, INDIAN, MEDITERRANEAN, OTHER, UNCERTAIN Height in metric by default (cm). Set unitSystem to IMPERIAL for inches.
Weight in metric by default (kg). Set unitSystem to IMPERIAL for pounds.
The color of the eyes. Default is null.
BLACK, BLUE_GREY, BLUE, BROWN, GREEN_BLUE, GREEN, GREY, OTHER, UNKNOWN The color of the hair. Default is null.
BLACK, BLOND, BROWN, DARK_BLOND, GREY, RED, WHITE, OTHER, UNKNOWN The length of the hair. Default is null.
AVERAGE, BALD, HALF_LONG, LONG, SHORT, VERY_LONG, VERY_SHORT The marital status of the profile. Default is null.
SINGLE, SEPARATED, IN_RELATIONSHIP, MARRIED, DIVORCED, WIDOW The job of the profile. Default is null.
32The interests of the profile. Default is an empty array.
TAILORING, BOOK_READING, TRAVELING, COOKING, GARDENING, PHOTOGRAPHY, PAINTING, MUSIC, MOVIES, CYCLING, HIKING, FITNESS, GAMING, DANCING, YOGA, SOFTWARE_DEVELOPMENT, DIY_PROJECTS, WRITING, LANGUAGES, ASTRONOMY, VOLUNTEERING, FISHING, BIRD_WATCHING, SPORTS, EDUCATION, ECONOMY, FOOD_DRINKING, CULINARY, TECHNOLOGY, MEDICAL, NATURE, CULTURE, ART The BDSM interests of the profile. Default is an empty array.
BDSM_BLOOD_PLAY, BDSM_BONDAGE, BDSM_BREATH_PLAY, BDSM_BUTTOCKS, BDSM_DOMINATION, BDSM_EDGE_PLAY, BDSM_FIRE_PLAY, BDSM_FISTING, BDSM_FLOGGING, BDSM_GOLDEN_SHOWER, BDSM_HARD, BDSM_KINKSTER, BDSM_KNIFE_PLAY, BDSM_MASOCHIST, BDSM_NEEDLE_PLAY, BDSM_ORGASM_DENIAL, BDSM_PET_PLAY, BDSM_QUEENING_FACESITTING, BDSM_SADISM, BDSM_SOFT, BDSM_STRAP_ON_DILDO, BDSM_SUBMISSION, BDSM_SUSPENSION, BDSM_ZENTAI The sexual interests of the profile. Default is an empty array.
ANAL, VAGINAL, ORAL_GIVING, ORAL_RECEIVING, KISSING, CUDDLING, DOMINANCE, SUBMISSION, BDSM, ROLEPLAY, PUBLIC_SEX, GROUP_SEX, SWINGING, WATCHING, BEING_WATCHED, THREESOME, FOREPLAY, DIRTY_TALK, SENSUAL_MASSAGE, TOYS, LIGHT_BONDAGE, SPANKING, CHOKING, FEET, EXHIBITIONISM, VOYEURISM The profile looking for genders. Default is an empty array.
MAN, WOMAN The sexual orientation of the profile. Default is null.
HETEROSEXUAL, GAY, LESBIAN, BISEXUAL, ASEXUAL, DEMISEXUAL, PANSEXUAL, QUEER, QUESTIONING, AROMANTIC, OMNISEXUAL, OTHER The number of children the profile has. Default is null.
The preference for having children. Default is null.
YES, NO, MAYBE For Transgender profile only. The surgery status of the profile. Default is null.
UNKNOWN, PRE_OP, POST_OP, NON_OP, PREFER_NOT_TO_SAY The unit system used for the profile. Default is METRIC.
IMPERIAL, METRIC Describes the user's current living situation. Default is null if unspecified.
ALONE, KIDS, PARENTS, ROOMMATE, PARTNER, PARTNER_AND_KIDS Personality of the profile.
SUPPORTIVE, TEASING, CONFIDENT, GEEKY, POETIC, HIGH_ENERGY, INTELLECTUAL, ROMANTIC, SARCASTIC, POSSESSIVE, NATURAL, APPRECIATIVE, PASSIONNATE URL of the main picture. Must be HTTPS
"https://example.org/images/public.jpg"
List of public picture URLs. All URLs must be HTTPS
["https://example.org/images/public.jpg"]List of private picture URLs. All URLs must be HTTPS
["https://example.org/images/private.jpg"]An ISO-8601 formatted date. By default, set to one week after profile creation. Purges profile data when reached; fresh data is fetched on next use. Avoid setting durations shorter than 24 hours. Use the version parameter for user profile updates.
"2025-01-01T12:34:20Z"
List of children the profile has.
Hide child attributes
List of pets the profile has.
Hide child attributes
Name of the pet.
1 - 32Sex of the pet.
MALE, FEMALE Age of the pet.
Breed of the pet.
1 - 32Type of the pet.
1 - 32A persona profile; this will represent the profile that supposed to receive the suggestions
Hide child attributes
The profile's ID (must be the same as the profileId parameter passed to the endpoint).
Gender of the profile owner.
WOMAN, MAN, TRANS_MAN, TRANSMASCULINE, TRANS_WOMAN, TRANSFEMININE An arbitrary string compared against the one stored in our profile database; any mismatch will trigger a profile data refresh. For example, you can use the latest update date as the version number.
"2025-01-01T12:34:20Z"
First name of the profile owner. You must provide either a first name or a nickname. At least one is required.
Nickname of the profile owner. You must provide either a first name or a nickname. At least one is required.
Description of the profile.
Birthdate of the profile owner, formatted as yyyy-MM-dd.
"1990-05-14"
Country code of the profile owner. Must be a two-letter ISO 3166-1 alpha-2 code.
2"FR"
City of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the city will be ignored.
64Postal code of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the postal code will be ignored.
64Time zone of the profile owner. See our supported time zones list.
"Europe/Paris"
Features of the profile.
Hide child attributes
The ethnicity of the profile. Default is null.
ASIAN, BLACK, CAUCASIAN, MIDDLE_EAST, HISPANIC_LATINO, INDIAN, MEDITERRANEAN, OTHER, UNCERTAIN Height in metric by default (cm). Set unitSystem to IMPERIAL for inches.
Weight in metric by default (kg). Set unitSystem to IMPERIAL for pounds.
The color of the eyes. Default is null.
BLACK, BLUE_GREY, BLUE, BROWN, GREEN_BLUE, GREEN, GREY, OTHER, UNKNOWN The color of the hair. Default is null.
BLACK, BLOND, BROWN, DARK_BLOND, GREY, RED, WHITE, OTHER, UNKNOWN The length of the hair. Default is null.
AVERAGE, BALD, HALF_LONG, LONG, SHORT, VERY_LONG, VERY_SHORT The marital status of the profile. Default is null.
SINGLE, SEPARATED, IN_RELATIONSHIP, MARRIED, DIVORCED, WIDOW The job of the profile. Default is null.
32The interests of the profile. Default is an empty array.
TAILORING, BOOK_READING, TRAVELING, COOKING, GARDENING, PHOTOGRAPHY, PAINTING, MUSIC, MOVIES, CYCLING, HIKING, FITNESS, GAMING, DANCING, YOGA, SOFTWARE_DEVELOPMENT, DIY_PROJECTS, WRITING, LANGUAGES, ASTRONOMY, VOLUNTEERING, FISHING, BIRD_WATCHING, SPORTS, EDUCATION, ECONOMY, FOOD_DRINKING, CULINARY, TECHNOLOGY, MEDICAL, NATURE, CULTURE, ART The BDSM interests of the profile. Default is an empty array.
BDSM_BLOOD_PLAY, BDSM_BONDAGE, BDSM_BREATH_PLAY, BDSM_BUTTOCKS, BDSM_DOMINATION, BDSM_EDGE_PLAY, BDSM_FIRE_PLAY, BDSM_FISTING, BDSM_FLOGGING, BDSM_GOLDEN_SHOWER, BDSM_HARD, BDSM_KINKSTER, BDSM_KNIFE_PLAY, BDSM_MASOCHIST, BDSM_NEEDLE_PLAY, BDSM_ORGASM_DENIAL, BDSM_PET_PLAY, BDSM_QUEENING_FACESITTING, BDSM_SADISM, BDSM_SOFT, BDSM_STRAP_ON_DILDO, BDSM_SUBMISSION, BDSM_SUSPENSION, BDSM_ZENTAI The sexual interests of the profile. Default is an empty array.
ANAL, VAGINAL, ORAL_GIVING, ORAL_RECEIVING, KISSING, CUDDLING, DOMINANCE, SUBMISSION, BDSM, ROLEPLAY, PUBLIC_SEX, GROUP_SEX, SWINGING, WATCHING, BEING_WATCHED, THREESOME, FOREPLAY, DIRTY_TALK, SENSUAL_MASSAGE, TOYS, LIGHT_BONDAGE, SPANKING, CHOKING, FEET, EXHIBITIONISM, VOYEURISM The profile looking for genders. Default is an empty array.
MAN, WOMAN The sexual orientation of the profile. Default is null.
HETEROSEXUAL, GAY, LESBIAN, BISEXUAL, ASEXUAL, DEMISEXUAL, PANSEXUAL, QUEER, QUESTIONING, AROMANTIC, OMNISEXUAL, OTHER The number of children the profile has. Default is null.
The preference for having children. Default is null.
YES, NO, MAYBE For Transgender profile only. The surgery status of the profile. Default is null.
UNKNOWN, PRE_OP, POST_OP, NON_OP, PREFER_NOT_TO_SAY The unit system used for the profile. Default is METRIC.
IMPERIAL, METRIC Describes the user's current living situation. Default is null if unspecified.
ALONE, KIDS, PARENTS, ROOMMATE, PARTNER, PARTNER_AND_KIDS Personality of the profile.
SUPPORTIVE, TEASING, CONFIDENT, GEEKY, POETIC, HIGH_ENERGY, INTELLECTUAL, ROMANTIC, SARCASTIC, POSSESSIVE, NATURAL, APPRECIATIVE, PASSIONNATE URL of the main picture. Must be HTTPS
"https://example.org/images/public.jpg"
List of public picture URLs. All URLs must be HTTPS
["https://example.org/images/public.jpg"]List of private picture URLs. All URLs must be HTTPS
["https://example.org/images/private.jpg"]An ISO-8601 formatted date. By default, set to one week after profile creation. Purges profile data when reached; fresh data is fetched on next use. Avoid setting durations shorter than 24 hours. Use the version parameter for user profile updates.
"2025-01-01T12:34:20Z"
List of children the profile has.
Hide child attributes
List of pets the profile has.
Hide child attributes
Name of the pet.
1 - 32Sex of the pet.
MALE, FEMALE Age of the pet.
Breed of the pet.
1 - 32Type of the pet.
1 - 32The language used to generate the suggestions.
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, HR_HR, TR_TR, EN_IE, AF_ZA, ZU_ZA, LV_LV, SK_SK, GA_IE A list of message describing the history of the conversation
Hide child attributes
The unique identifier of the message. This is used by our system to deduplicate messages.
The sender of the message. Possible values are USER and PERSONA.
USER represents a user message ;PERSONA represents a message sent by a persona (the profile for which we are going to generate content).USER, PERSONA Message timestamp in ISO-8601 format.
"2023-04-25T10:00:00Z"
The URL of the image associated with the message. This will be analyzed if the vision is enabled for the current request.
^https?://.*Flag the message as a poke, our chat models will react to it.
A text description of a sticker sent alongside the message. Our chat models will react to it naturally.
160Message's text content, can be null if the message does not contains text.
512OK
Represents a list of suggestions generated by our platform.
A array of 3 suggestions as text.
"['Lorem ipsum dolor sit amet.', 'Consectetur adipiscing elit.', 'Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.']"