curl --request POST \
--url https://api.tikway.ai/v1beta/models/{model}:generateContent \
--header 'Content-Type: application/json' \
--header 'x-goog-api-key: <api-key>' \
--data '
{
"systemInstruction": {
"parts": [
{
"text": "You are a helpful assistant."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "Write a short bedtime story about a unicorn."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 1024
}
}
'{
"candidates": [
{
"index": 0,
"content": {
"role": "model",
"parts": [
{
"text": "Once upon a time, a magic backpack..."
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 10,
"candidatesTokenCount": 12,
"totalTokenCount": 22
},
"modelVersion": "gemini-2.0-flash"
}Generate Content
curl --request POST \
--url https://api.tikway.ai/v1beta/models/{model}:generateContent \
--header 'Content-Type: application/json' \
--header 'x-goog-api-key: <api-key>' \
--data '
{
"systemInstruction": {
"parts": [
{
"text": "You are a helpful assistant."
}
]
},
"contents": [
{
"role": "user",
"parts": [
{
"text": "Write a short bedtime story about a unicorn."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 1024
}
}
'{
"candidates": [
{
"index": 0,
"content": {
"role": "model",
"parts": [
{
"text": "Once upon a time, a magic backpack..."
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": 10,
"candidatesTokenCount": 12,
"totalTokenCount": 22
},
"modelVersion": "gemini-2.0-flash"
}授权
Tikway API Key。按 Gemini 原生协议通过 x-goog-api-key 请求头传递。
路径参数
模型名称，格式为 models/{model}。
请求体
当前对话内容。单轮请求通常只有一个 Content；多轮对话按顺序包含历史与最新请求。
1Hide child attributes
Hide child attributes
内容部分列表。
1Hide child attributes
Hide child attributes
文本输入。
该部分是否属于模型思考内容。
思考内容签名；回传时保持原样。
内容块关联的自定义元数据。
视频内容的处理方式。
音频转录信息。
语音合成相关元数据。
需要客户端回传的服务端工具调用。
服务端工具调用的执行结果。
视频内容元数据。
内容角色。省略时通常视为 user。
user, model 模型可使用的工具列表，例如函数调用或代码执行。
Hide child attributes
Hide child attributes
函数声明列表。
Hide child attributes
Hide child attributes
函数名称。
函数用途说明。
函数参数 JSON Schema。
函数响应 JSON Schema。
UNSPECIFIED, BLOCKING, NON_BLOCKING 函数参数的 JSON Schema；与 parameters 互斥。
函数响应的 JSON Schema；与 response 互斥。
启用代码执行工具。
启用 Google 搜索工具。
启用 URL 上下文工具。
Google Search 检索配置。
计算机操作工具配置。
文件搜索工具配置。
可连接的 MCP 服务器。
地理位置搜索工具配置。
安全过滤规则；同一类别最多配置一次，覆盖该类别的默认阈值。
Hide child attributes
Hide child attributes
安全类别。
HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT, HARM_CATEGORY_CIVIC_INTEGRITY, HARM_CATEGORY_JAILBREAK 阻止阈值。
HARM_BLOCK_THRESHOLD_UNSPECIFIED, BLOCK_LOW_AND_ABOVE, BLOCK_MEDIUM_AND_ABOVE, BLOCK_ONLY_HIGH, BLOCK_NONE, OFF 生成与输出配置。
Hide child attributes
Hide child attributes
采样温度。
0 <= x <= 2核采样阈值。
每步保留的最高概率候选数。
返回候选回复数量。
x >= 1最大输出词元数。
停止序列。
5输出 MIME 类型。
text/plain, application/json, text/x.enum application/json 输出应遵循的 JSON Schema。
JSON 输出的原始 JSON Schema。
请求的输出模态。
MODALITY_UNSPECIFIED, TEXT, IMAGE, AUDIO 媒体输入解析度设置。
MEDIA_RESOLUTION_UNSPECIFIED, MEDIA_RESOLUTION_LOW, MEDIA_RESOLUTION_MEDIUM, MEDIA_RESOLUTION_HIGH 解码随机种子。
已出现词元的存在惩罚。
已出现词元的频率惩罚。
是否在响应中返回词元对数概率。
返回的高概率候选词元数量；仅在 responseLogprobs 为 true 时有效。
0 <= x <= 20启用增强的公民议题回答。
根据检测到的情绪调整回答。
分别配置文本、音频和图像输出格式。
Hide child attributes
Hide child attributes
音频转录配置。
Hide child attributes
Hide child attributes
语言提示。
语音适配提示短语。
自定义术语。
VERBATIM, SMART 已弃用；使用 languageCodes。
作为上下文使用的缓存内容名称，格式为 cachedContents/{cachedContent}。
请求服务层级。
unspecified, standard, flex, priority 是否记录本请求；若设置，会覆盖项目级日志配置。
响应
Gemini API：models.generateContent 普通响应。完全内联，适合导入 Apifox。
模型生成的候选回复列表。
Hide child attributes
Hide child attributes
候选回复索引。
候选回复内容。
Hide child attributes
Hide child attributes
角色，固定为 model。
model 回复内容部分。
Hide child attributes
Hide child attributes
生成的文本。
是否为思考内容。
思考签名。
内容块关联的自定义元数据。
视频内容的处理方式。
音频转录信息。
语音合成相关元数据。
需要客户端回传的服务端工具调用。
服务端工具调用的执行结果。
视频内容元数据。
候选回复的结束原因。
结束原因的说明。
引用元数据。
候选回复词元数。
候选回复的平均对数概率。
词元对数概率结果。
URL 上下文元数据。
词元使用统计。
Hide child attributes
Hide child attributes
实际使用的模型版本。
响应唯一 ID。