Interactions
Updated: Nov 11, 2026
Native Gemini Interactions format. Supports Gemini models only. Background execution (background: true) is not supported.
See API Guide - Authentication.
See API Guide - Common Request Headers.
application/json- body
model?stringModel ID, e.g. gemini-3.5-flash. Specify either model or agent.
agent?stringAgent name. Specify either model or agent.
input*||array<>Input, either a string, a single message, or an array of messages.
system_instruction?stringSystem instruction.
generation_config?Generation parameters, such as temperature and max_output_tokens.
tools?array<>Tool definitions.
stream?booleanWhether to stream the response.
previous_interaction_id?stringID of the previous interaction, used to continue a multi-turn conversation.
background?booleanWhether to run in the background. Only false is supported.
falseSuccessful response
application/json- response
id?stringInteraction ID.
model?stringID of the model actually used.
status?stringInteraction status, such as completed.
outputs?array<>List of outputs.
usage?Token usage statistics.
curl -X POST 'https://api.cysuo.com/v1beta/interactions' \ -H 'Content-Type: application/json' \ -d '{ "model": "gemini-3.5-flash", "input": "Hello, please introduce yourself."}'{ "id": "string", "model": "string", "status": "string", "outputs": [ { "type": "string", "text": "string" } ], "usage": { "total_input_tokens": 0, "total_output_tokens": 0, "total_thought_tokens": 0, "total_cached_tokens": 0, "total_tokens": 0 }}