核心 AI 设置 API

修改你的 Convai 角色核心 AI 设置所需的所有相关 API。

此 API 仅适用于 Professional Plan 及以上套餐。

角色模型选择

POST https://api.convai.com/character/update

Update API 可用于更改角色所使用的 LLM。目前支持以下模型。

实时/在线模型

OpenAI

模型	模型代码	旗舰
GPT 实时 1.5（测试版）	gpt-realtime-1.5
GPT 实时 Mini（测试版）	gpt-realtime-mini

Google

模型	模型代码	旗舰
Gemini 2.5 Flash Live（测试版）	gemini-2.5-flash-live
Gemma 4 31B Fast（测试版）	realtime-gemma-4-31b-it
Gemma 4 26B A4B Fast（测试版）	realtime-gemma-4-26b-a4b-it

标准模型

OpenAI

旗舰

模型	模型代码	旗舰
GPT-5.4	gpt-5.4
GPT-5.x（最新）	gpt-5.x
GPT-OSS-120B（测试版）	gpt-oss-120b
GPT-5.1（测试版）	gpt-5.1
GPT-4.1	gpt-4.1
GPT-5.4-nano	gpt-5.4-nano
GPT-5.x-nano（最新）	gpt-5.x-nano
GPT-5.4-mini	gpt-5.4-mini
GPT-5.x-mini（最新）	gpt-5.x-mini
GPT-4.1-mini	gpt-4.1-mini
GPT-5.3 Instant	gpt-5.3-instant
GPT-4o	gpt-4o
GPT-4.1-nano	gpt-4.1-nano
GPT-4o-mini	gpt-4o-mini

Anthropic

模型	模型代码	旗舰
Claude 4.5 Sonnet（测试版）	claude-4-5-sonnet
Claude 4.5 Haiku（测试版）	claude-4-5-haiku
Claude Sonnet（最新）	claude-sonnet
Claude Haiku（最新）	claude-haiku

Google

模型	模型代码	旗舰
Gemini 3.5 Flash	gemini-3.5-flash
Gemini Flash（最新）	gemini-flash
Gemini 3.1 Flash Lite	gemini-3.1-flash-lite
Gemini Flash Lite（最新）	gemini-flash-lite
Gemini 2.5 Flash	gemini-2.5-flash
Gemini 2.5 Flash Lite	gemini-2.5-flash-lite

Qwen

模型	模型代码	旗舰
Qwen3.6 27B（测试版）	qwen3.6-27b
Qwen3.6 35B A3B（测试版）	qwen3.6-35b-a3b

Llama

模型	模型代码	旗舰
Llama 4 Maverick（测试版）	llama-4-maverick
Llama 4 Scout（测试版）	llama-4-scout
Llama3 70B	llama3-70b

xAI

模型	模型代码	旗舰
Grok 4.3	grok-4.3

当调用 update API 为您的角色更新模型时，请确保传入 模型代码 对应于 模型 上表中的项。

请求头

名称	类型	描述
CONVAI-API-KEY*	字符串	为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在钥匙图标下找到。

请求体

名称	类型	描述
charID	字符串	您的角色 ID。
model_group_name	字符串	您想更新到的模型的模型代码。参见上表。

200：OK 模型已成功更新。

{"STATUS": "SUCCESS"}

401 API 密钥验证失败

以下是一些示例代码，用于演示该端点的请求格式 -->

Python

import requests
import json

url = "https://api.convai.com/character/update"

headers = { 
    'CONVAI-API-KEY': '<Your-API-Key>',
    'Content-Type': 'application/json'
}

# 为 JSON 负载创建一个字典
payload = { 
    "charID": "<Your-Character-Id>",
    "model_group_name": "claude-3-5-sonnet"
}

# 将负载转换为 JSON
json_payload = json.dumps(payload)

response = requests.post(url, headers=headers, data=json_payload)

print(response.text)

cURL

温度设置

POST https://api.convai.com/character/update

与 AI 聊天时，温度设置就像在调节回复会有多么有创意或多么可预测。较低的温度会让 AI 更贴近它确定知道的内容（更少幻觉），而较高的温度则会让它更有想象力，并可能带来惊喜（更适合角色扮演）。

请求头

名称	类型	描述
CONVAI-API-KEY*	字符串	为每位用户提供的唯一 API 密钥。登录 Convai 账户后，可在钥匙图标下找到。

请求体

名称	类型	描述
charID	字符串	您的角色 ID。
temperature	浮点数	温度值。必须介于 0 和 1 之间。

200：OK 温度已成功更新

{"STATUS": "SUCCESS"}

401 API 密钥验证失败

以下是一些示例代码，用于演示该端点的请求格式 -->

Python

import requests
import json

url = "https://api.convai.com/character/update"

headers = { 
    'CONVAI-API-KEY': '<Your-API-Key>',
    'Content-Type': 'application/json'
}

# 为 JSON 负载创建一个字典
payload = { 
    "charID": "<Your-Character-Id>",
    "temperature": 0.42
}

# 将负载转换为 JSON
json_payload = json.dumps(payload)

response = requests.post(url, headers=headers, data=json_payload)

print(response.text)

cURL