必须为codegeex api请求设计清晰数据模型：一、用json schema约束字段类型与校验规则；二、用typescript接口定义强类型结构并配合运行时校验；三、用yaml模板描述多版本契约并支持锚点复用；四、用自然语言精准描述嵌套结构与业务约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeGeeX构建API请求时需要明确定义请求体、响应体或参数格式，则必须为这些交互环节设计清晰的数据模型。以下是为CodeGeeX API请求定义数据结构的具体方法：
一、基于JSON Schema声明输入输出结构
JSON Schema是一种标准化的元描述语言，可用于精确约束API请求与响应的数据类型、字段必选性、嵌套层级及校验规则。CodeGeeX支持将Schema直接嵌入提示词或配置文件中，以引导模型生成符合结构的代码或响应。
1、定义一个包含prompt（字符串）、max_tokens（整数）和temperature（浮点数）字段的请求Schema。
2、在Schema中将prompt标记为"required"字段，并为max_tokens设置最小值为1、最大值为4096的约束。
3、为temperature字段添加"minimum": 0.0和"maximum": 2.0限制，并指定默认值为0.7。
4、将该Schema作为上下文的一部分提供给CodeGeeX，例如在系统提示中写入："请严格遵循以下JSON Schema生成API请求体：{...}"。
二、使用TypeScript接口生成强类型模型
TypeScript接口可被CodeGeeX识别并用于推导字段语义与结构关系，尤其适用于前端调用或Node.js后端集成场景。通过接口定义，模型能自动生成符合类型安全要求的序列化/反序列化逻辑。
1、声明一个名为CodeGeeXRequest的接口，包含model: string、input: string[]、parameters?: Record<string unknown></string>三个属性。
2、为input字段添加注释说明：“每个字符串代表一行源代码片段，按顺序拼接为完整上下文”。
3、在调用CodeGeeX前，使用zod或io-ts将该接口转换为运行时校验器，并传入实际数据进行验证。
4、将接口定义原文作为指令的一部分提交给CodeGeeX，例如："你正在为TypeScript项目生成API客户端，请基于以下interface实现fetch调用：interface CodeGeeXRequest {...}"。
三、利用YAML模板描述多版本数据契约
当API需兼容多个版本（如v1/v2）或不同终端（Web/CLI/Mobile）时，YAML因其可读性强、支持注释和锚点复用的特点，适合作为数据模型的描述格式。CodeGeeX可解析YAML结构并据此生成对应语言的模型类。
1、创建一个request-v1.yaml文件，定义language（枚举：python|javascript|java）、context_lines（整数）和include_comments（布尔值）字段。
2、在同目录下新建request-v2.yaml，新增project_type字段并引用v1中已定义的context_lines锚点，避免重复描述。
3、在提示中明确要求CodeGeeX：“根据request-v2.yaml生成Python dataclass，字段名与YAML键名一致，类型映射遵循PEP 563规范。”
4、确保YAML中所有枚举值均以enum:关键字显式列出，并在关键字段旁添加# required注释，例如："language: # required, enum: [python, javascript, java]"。
四、通过自然语言约束生成嵌套对象结构
在缺乏形式化Schema工具链的轻量级场景中，可依赖精准的中文描述驱动CodeGeeX生成嵌套数据模型。该方式强调字段语义、层级关系与业务约束的自然表达，适用于快速原型阶段。
1、描述请求主体为“一个包含用户身份信息与代码上下文的对象”，其中“用户身份信息”必须含user_id（8位十六进制字符串）和session_token（JWT格式字符串）。
2、说明“代码上下文”是一个数组，每个元素包含file_path（非空字符串）、line_number（正整数）和code_snippet（长度不超200字符的字符串）。
3、强调所有字符串字段均须做trim处理，且line_number不得为零或负数。
4、在指令末尾加入硬性约束："生成的JSON对象必须完全匹配上述描述，不可增删字段，不可改变嵌套层级，不可省略任何必填项。"。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
