需依据官方v3.2.1结构化教程系统学习：一、Playground沙箱初始化；二、文本生成需协同配置System Prompt、User Input与参数；三、图像理解须合规上传≤2MB/1024×1024的jpg/png；四、API密钥须环境变量安全注入并验证；五、图像生成提示词须含主体-动作-场景-风格-画质五要素。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望系统性掌握AI卡皮巴拉平台的核心功能与标准操作路径，则需依据其官方发布的结构化教程展开学习。该文档覆盖从环境接入、任务构建到参数调优的完整链路，所有说明均基于平台当前稳定版本v3.2.1的实际界面与API行为。以下是官方文档中关键模块的逐层解读：
一、Playground沙箱环境初始化
Playground是官方文档明确指定的首选实验入口，作为免部署实时执行环境，其设计目标是隔离开发测试与生产调用，确保提示词逻辑验证过程可复现、无副作用。该环节不涉及模型训练或数据上传，仅触发单次推理请求。
1、访问https://www.php.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。
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'}。
五、图像生成任务的提示词工程规范
官方文档专章强调中文提示词需遵循“主体-动作-场景-风格-画质”五要素结构，缺失任一维度将显著降低生成图像与意图匹配度。平台内置提示词解析器会对模糊词汇自动降权，如“可爱”权重仅为具象词“豆豆眼”的1/8。
1、在提示词输入框中按顺序组织内容，例如：“一只侧身躺卧的卡皮巴拉（主体），正用前爪拨弄蒲公英（动作），背景为春日樱花林荫道（场景），吉卜力工作室手绘风格（风格），8K超高清细节（画质）”。
2、删除所有主观修饰语，将“非常可爱”替换为“圆脸+短鼻+微张嘴露出两颗门牙”。
3、添加构图控制词，例如在句末追加“居中构图，浅景深，柔焦效果”，避免模型自由发挥导致主体偏移。
