AI卡皮巴拉官方教程 AI卡皮巴拉官方使用文档解读

2026-04-07 人工智能

需依据官方v3.2.1结构化教程系统学习：一、Playground沙箱初始化；二、文本生成需协同配置System Prompt、User Input与参数；三、图像理解须合规上传≤2MB/1024×1024的jpg/png；四、API密钥须环境变量安全注入并验证；五、图像生成提示词须含主体-动作-场景-风格-画质五要素。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您希望系统性掌握AI卡皮巴拉平台的核心功能与标准操作路径，则需依据其官方发布的结构化教程展开学习。该文档覆盖从环境接入、任务构建到参数调优的完整链路，所有说明均基于平台当前稳定版本v3.2.1的实际界面与API行为。以下是官方文档中关键模块的逐层解读：

一、Playground沙箱环境初始化

Playground是官方文档明确指定的首选实验入口，作为免部署实时执行环境，其设计目标是隔离开发测试与生产调用，确保提示词逻辑验证过程可复现、无副作用。该环节不涉及模型训练或数据上传，仅触发单次推理请求。

1、访问https://www.sztg.com.cn/link/53dcc522f73ee77763e326f63fd70c17，使用已通过邮箱验证的开发者账户登录。

2、登录后检查左上角会话状态栏是否显示“Ready”，若显示“Loading…”持续超10秒，请刷新页面并禁用广告拦截插件。

3、在顶部模型选择器中确认当前加载版本为kapibara-llm-v3.2.1，该标识不可手动修改，若显示其他版本号则需点击右侧“Sync to Latest”同步。

二、文本生成任务的标准配置流程

官方文档将文本生成定义为最基础且高频使用的交互范式，强调系统提示（System Prompt）、用户输入（User Input）与参数面板三者必须协同生效，任一字段留空将导致400错误响应。

1、在任务类型下拉框中选定Text Generation，此时右侧参数区自动展开默认配置。

2、在System Prompt框内粘贴角色指令，例如：“你是一只熟悉Python编程的卡皮巴拉，回答时仅输出可直接运行的代码块，不包含解释文字。”

3、于User Input区域输入具体指令，例如：“写一个函数，接收列表参数，返回其中所有偶数的平方和。”

4、在参数面板中将temperature设为0.2，max_tokens保持默认值256，勾选“Return raw JSON”以获取结构化响应体。

三、多模态图像理解任务的合规上传规范

官方文档特别标注图像理解任务对输入文件具有强约束性，不符合尺寸或格式要求的图片将被前端直接拦截，不进入后端处理队列。该限制由客户端JavaScript校验层强制执行，非服务端报错。

1、点击左上角“+ New Session”，在弹出菜单中选择Image + Text Understanding。

FaceSwapper

FaceSwapper是一款AI在线换脸工具，可以让用户在照片和视频中无缝交换面孔。

下载

2、点击“Upload Image”区域后，系统弹出本地文件选择器，仅接受扩展名为.jpg或.png的文件，其他格式无法触发上传动作。

3、所选图片文件大小须≤2MB，且原始分辨率不得高于1024×1024像素；若超出，页面将显示红色提示：“Image exceeds max resolution: 1024x1024”。

4、在下方文本框中输入指令，必须包含明确视觉动词，例如：“统计图中可见的香蕉数量，并描述每根香蕉的弯曲程度与表皮斑点分布。”

四、API密钥安全配置与SDK调用验证

官方文档将API密钥管理列为最高优先级安全事项，明确禁止在前端代码、Git提交记录或公开笔记中硬编码密钥。所有Python SDK调用示例均以环境变量方式注入凭证，避免明文泄露风险。

1、登录AI卡皮巴拉控制台，在“Security → API Keys”页点击“Create New Key”，生成后立即复制Secret Key字符串（仅显示一次，关闭页面即不可再查）。

2、在本地终端执行：export AIKAPIB_KEY="sk-xxx"，注意引号不可省略，且等号两侧无空格。

3、运行验证脚本：python -c "import os; from aikapibara import KapibaraClient; c = KapibaraClient(api_key=os.getenv('AIKAPIB_KEY')); print(c.healthcheck())"，预期返回{'status': 'ok', 'version': 'v3.2.1'}。