创知Ai 技术文档

全面的技术指南和API参考文档，帮助您快速上手并充分利用创知Ai平台的所有功能。

快速开始

欢迎使用创知Ai技术文档！本节将指导您快速开始使用我们的AI服务平台。

注意： 在开始之前，请确保您已注册创知Ai账户并获取了API密钥。

第一步：获取API密钥

要开始使用创知Ai API，您需要先申请API密钥：

                # 前往官网注册账号并获取API密钥
# 或通过以下方式联系客服获取试用密钥
            

第二步：配置环境

安装必要的依赖包并配置环境变量：

                # 安装SDK（Python示例）
pip install chuangzhi-ai-sdk

# 设置环境变量
export CHUANGZHI_API_KEY="your_api_key_here"
export CHUANGZHI_API_BASE="https://api.chuangzhi.ai"
            

第三步：发送第一个请求

使用以下代码示例测试API连通性：

                import requests

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

response = requests.post(
    "https://api.chuangzhi.ai/v1/chat/completions",
    json={
        "model": "chuangzhi-base",
        "messages": [
            {"role": "user", "content": "你好，介绍一下创知Ai"}
        ]
    },
    headers=headers
)

print(response.json())
            

REST API 参考

创知Ai提供基于REST架构的API接口，支持标准的HTTP方法和JSON格式的数据交换。

POST /v1/chat/completions

创建聊天完成请求，获取AI助手响应。

请求参数

参数	类型	必填	描述
`model`	string	是	使用的模型标识符
`messages`	array	是	对话消息数组
`max_tokens`	integer	否	最大返回令牌数（默认：1024）
`temperature`	number	否	采样温度（0-1，默认：0.7）

响应示例

                {
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "chuangzhi-base",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "创知Ai是一个先进的AI技术平台..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 56,
    "completion_tokens": 128,
    "total_tokens": 184
  }
}
            

智能对话API

创知Ai智能对话API提供自然语言处理能力，支持多轮对话、上下文理解和情感分析。

功能特性：

多轮对话上下文记忆
情感分析与情感识别
多语言支持（中文、英文、日文等）
自定义知识库集成

对话上下文管理

维护对话上下文是创建连续对话体验的关键：

                messages = [
    {"role": "system", "content": "你是一个专业的AI助手"},
    {"role": "user", "content": "什么是机器学习？"},
    {"role": "assistant", "content": "机器学习是..."},
    {"role": "user", "content": "那深度学习和机器学习有什么区别？"}
]
            

立即开始构建

准备好将AI能力集成到您的应用中了吗？查看我们的快速开始指南，立即开始您的AI之旅。

查看快速开始指南

故障排除

常见问题及解决方案：

API请求失败

如果遇到API请求失败，请检查以下事项：

API密钥是否正确配置
网络连接是否正常
API端点URL是否正确
请求参数格式是否符合要求

性能优化建议

提升API调用性能的技巧：

使用连接池管理HTTP连接
合理设置请求超时时间
批量处理请求以减少往返次数
使用异步调用提高并发性能