获取 API 密钥

登录 Coze 平台，进入开发者中心或账户设置页面，找到 API 密钥管理选项，生成新的 API 密钥并妥善保存。

安装必要依赖

确保已安装 Python 环境，使用以下命令安装 Coze API 官方 SDK 或 HTTP 请求库（如 requests）：

pip install requests

调用 API 示例代码

以下为通过 requests 调用 Coze API 的 Python 示例代码：

import requests

api_key = "your_api_key_here"
url = "https://api.coze.com/v1/chat/completions"  # 替换为实际 API 端点

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

data = {
    "model": "coze-model-name",  # 替换为具体模型名称
    "messages": [{"role": "user", "content": "Hello!"}]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

参数说明

• model: 指定调用的模型名称（如 coze-1.0）。
• messages: 对话历史列表，每条消息需包含 role（user/assistant）和 content。
• temperature: 控制生成文本的随机性（默认 0.7）。

错误处理

检查响应状态码，处理常见错误（如 401 未授权或 429 限频）：

if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Error:", response.status_code, response.text)

返回结果解析

成功响应包含 choices 字段，其中 message.content 为生成的回复内容：

reply = response.json()["choices"][0]["message"]["content"]

注意事项

• 生产环境建议将 API 密钥存储在环境变量中，避免硬编码。
• 调用频率需遵守平台限流规则（参考官方文档）。