Langame (1.0.9)

Download OpenAPI specification:Download

E-mail: [email protected] URL: https://help.langa.me License: Apache 2.0 Terms of Service

Machine conversations for human conversations

Welcome! You are at the right place to find out how to use Langame API.

You don't have an API key? Create an account and get one on Langame website.

Langame API is in beta and freely available under a rate limit, if you want to increase the rate limit, please contact us at [email protected].

For more information, read this.

Authentication

api_key

Security Scheme Type	API Key
Header parameter name:	X-Api-Key

Conversation

Augment your service conversations.

Starter

Request a conversation starter on any topic(s).

This is the entrypoint to request a conversation on any topic(s). You can then use it in your service.

Authorizations:

api_key

Request Body schema: application/json

Customisation of the conversation starter, default is "ice breaker".

topics	Array of strings List of topics the conversation starters should be related to. The conversation starters will be about any of these topics.
limit	integer Quantity of conversation starters to return.
translated	boolean Whether to return translations (increase latency).
personas	Array of strings A list of personas to be used to generate the conversation starters aligned on. Overwrites the given topics.

Responses

Request samples

Payload

Content type

application/json

Example

Ice breaker related to travelling.

{"topics": ["ice breaker",
"travel"
],
"limit": 2,
"translated": true
}

Response samples

200
400
401
429
500

Content type

application/json

Example

Ice breaker related to travelling.

{"topics": ["ice breaker",
"travel"
],
"limit": 2,
"translated": true,
"results": [{"conversation_starter": {"de": "Was würde Sie veranlassen, eine dramatische Veränderung in Ihrem Leben vorzunehmen? Ist es das wert?",
"en": "What are examples of the benefits and drawbacks of being a global citizen?",
"es": "¿Qué te impulsaría a hacer un cambio dramático en tu vida? ¿Vale la pena?",
"fr": "Qu'est-ce qui vous pousserait à faire un changement radical dans votre vie. Est-ce que ça vaut le coup?",
"it": "Cosa ti spingerebbe a fare un cambiamento drammatico nella tua vita. Ne vale la pena?",
"ja": "あなたの人生に劇的な変化をもたらすためにあなたを促すものは何ですか。その価値はありますか？",
"ko": "당신의 삶에 극적인 변화를 불러일으키는 것은 무엇입니까? 그만한 가치가 있습니까?",
"pt": "O que o levaria a fazer uma mudança dramática em sua vida. Vale a pena?",
"ru": "Что побудило бы вас кардинально изменить свою жизнь. Стоит ли оно того?",
"zh-CN": "什么会促使你在你的生活中做出巨大的改变。这值得么？"
},
"id": "ECdi87CAvHoHELwXcUjT"
},
{"conversation_starter": {"de": "Was hast du auf Reisen gelernt?",
"en": "What is something you learned while traveling?",
"es": "¿Qué aprendiste mientras viajabas?",
"fr": "Qu'avez-vous appris en voyageant ?",
"it": "Qual è qualcosa che hai imparato viaggiando?",
"ja": "旅行中に学んだことは何ですか？",
"ko": "여행을 하면서 배운 것은 무엇인가요?",
"pt": "O que você aprendeu durante a viagem?",
"ru": "Что вы узнали во время путешествия?",
"zh-CN": "你在旅行中学到了什么？"
},
"id": "Uy4Z7ZQ4ZQ4ZQ4ZQ4ZQ4"
}
]
}

Collection starter

List collections.

Authorizations:

api_key

Responses

Response samples

200
400
401
429
500

Content type

application/json

{"results": [{"topics": ["science",
"technology",
"history",
"geography",
"art",
"literature",
"philosophy",
"religion"
],
"id": "uTge4ZQ4ZQ4ZQ4jQ4Zo",
"name": "Brainy stuff"
}
]
}

Create a collection.

Authorizations:

api_key

Request Body schema: application/json

name	string Name of the collection.

Responses

Request samples

Payload

Content type

application/json

{"name": "brainy"
}

Response samples

200
400
401
429
500

Content type

application/json

{"name": "brainy",
"id": "uTge4ZQ4ZQ4ZQ4ZQ4Zo"
}

Get a collection.

Authorizations:

api_key

path Parameters

collectionId

required

string

Examples:

uTge4ZQ4ZQ4ZQ4ZQ4Zo - A sample ID value

Collection ID to get.

Responses

Response samples

200
400
401
429
500

Content type

application/json

{"results": [{"topics": ["science",
"technology",
"history",
"geography",
"art",
"literature",
"philosophy",
"religion"
],
"id": "uTge4ZQ4ZQ4ZQ4jQ4Zo",
"name": "Brainy stuff"
}
]
}

Get a collection' conversation starter(s).

Authorizations:

api_key

path Parameters

collectionId

required

string

Examples:

uTge4ZQ4ZQ4ZQ4ZQ4Zo - A sample ID value

Collection ID to get.

Responses

Response samples

200
400
401
429
500

Content type

application/json

Example

Ice breaker related to travelling.

{"results": [{"conversation_starter": {"de": "Was würde Sie veranlassen, eine dramatische Veränderung in Ihrem Leben vorzunehmen? Ist es das wert?",
"en": "What are examples of the benefits and drawbacks of being a global citizen?",
"es": "¿Qué te impulsaría a hacer un cambio dramático en tu vida? ¿Vale la pena?",
"fr": "Qu'est-ce qui vous pousserait à faire un changement radical dans votre vie. Est-ce que ça vaut le coup?",
"it": "Cosa ti spingerebbe a fare un cambiamento drammatico nella tua vita. Ne vale la pena?",
"ja": "あなたの人生に劇的な変化をもたらすためにあなたを促すものは何ですか。その価値はありますか？",
"ko": "당신의 삶에 극적인 변화를 불러일으키는 것은 무엇입니까? 그만한 가치가 있습니까?",
"pt": "O que o levaria a fazer uma mudança dramática em sua vida. Vale a pena?",
"ru": "Что побудило бы вас кардинально изменить свою жизнь. Стоит ли оно того?",
"zh-CN": "什么会促使你在你的生活中做出巨大的改变。这值得么？"
},
"id": "ECdi87CAvHoHELwXcUjT",
"updated_at": "2021-03-01T12:00:00.000Z",
"original_id": "z2X4ZuQ4ZuQfcUjT",
"topics": ["travel",
"ice breaker"
]
}
]
}

Add a conversation starter to a collection.

Authorizations:

api_key

path Parameters

collectionId required	string Examples: uTge4ZQ4ZQ4ZQ4ZQ4Zo - A sample ID value Collection ID to add.
starterId required	string Examples: ffee3Gbefg3Gbefg3Gbe - A sample ID value Starter ID to add.

Responses

Response samples

200
400
401
429
500

Content type

application/json

Example

Ice breaker related to travelling.

{"results": [{"conversation_starter": {"de": "Was würde Sie veranlassen, eine dramatische Veränderung in Ihrem Leben vorzunehmen? Ist es das wert?",
"en": "What are examples of the benefits and drawbacks of being a global citizen?",
"es": "¿Qué te impulsaría a hacer un cambio dramático en tu vida? ¿Vale la pena?",
"fr": "Qu'est-ce qui vous pousserait à faire un changement radical dans votre vie. Est-ce que ça vaut le coup?",
"it": "Cosa ti spingerebbe a fare un cambiamento drammatico nella tua vita. Ne vale la pena?",
"ja": "あなたの人生に劇的な変化をもたらすためにあなたを促すものは何ですか。その価値はありますか？",
"ko": "당신의 삶에 극적인 변화를 불러일으키는 것은 무엇입니까? 그만한 가치가 있습니까?",
"pt": "O que o levaria a fazer uma mudança dramática em sua vida. Vale a pena?",
"ru": "Что побудило бы вас кардинально изменить свою жизнь. Стоит ли оно того?",
"zh-CN": "什么会促使你在你的生活中做出巨大的改变。这值得么？"
},
"id": "ECdi87CAvHoHELwXcUjT",
"updated_at": "2021-03-01T12:00:00.000Z",
"original_id": "z2X4ZuQ4ZuQfcUjT",
"topics": ["travel",
"ice breaker"
]
}
]
}

Remove a conversation starter from a collection.

Authorizations:

api_key

path Parameters

collectionId required	string Examples: uTge4ZQ4ZQ4ZQ4ZQ4Zo - A sample ID value Collection ID to add.
starterId required	string Examples: ffee3Gbefg3Gbefg3Gbe - A sample ID value Starter ID to add.

Responses

Response samples

200
400
401
429
500

Content type

application/json

Example

Ice breaker related to travelling.

{"results": [{"conversation_starter": {"de": "Was würde Sie veranlassen, eine dramatische Veränderung in Ihrem Leben vorzunehmen? Ist es das wert?",
"en": "What are examples of the benefits and drawbacks of being a global citizen?",
"es": "¿Qué te impulsaría a hacer un cambio dramático en tu vida? ¿Vale la pena?",
"fr": "Qu'est-ce qui vous pousserait à faire un changement radical dans votre vie. Est-ce que ça vaut le coup?",
"it": "Cosa ti spingerebbe a fare un cambiamento drammatico nella tua vita. Ne vale la pena?",
"ja": "あなたの人生に劇的な変化をもたらすためにあなたを促すものは何ですか。その価値はありますか？",
"ko": "당신의 삶에 극적인 변화를 불러일으키는 것은 무엇입니까? 그만한 가치가 있습니까?",
"pt": "O que o levaria a fazer uma mudança dramática em sua vida. Vale a pena?",
"ru": "Что побудило бы вас кардинально изменить свою жизнь. Стоит ли оно того?",
"zh-CN": "什么会促使你在你的生活中做出巨大的改变。这值得么？"
},
"id": "ECdi87CAvHoHELwXcUjT",
"updated_at": "2021-03-01T12:00:00.000Z",
"original_id": "z2X4ZuQ4ZuQfcUjT",
"topics": ["travel",
"ice breaker"
]
}
]
}