文档
渲染 API
GET /api/adapters/render
返回所有可用模型列表 + 内置示例 Spec，便于客户端初始化表单。
bash
curl https://prompt.solokit.run/api/adapters/render
json
{
"data": {
"models": [
{ "family": "claude", "label": "Claude (Anthropic)", "examples": ["claude-sonnet-4.5"], "origin": "international", "reasoning": false, "longContext": true, "preferredFormat": "xml", "toolProtocol": "anthropic" },
{ "family": "deepseek-r1", "label": "DeepSeek R1 (reasoning)", ... }
],
"sample": { "id": "code-reviewer", ... }
}
}POST /api/adapters/render
| 字段 | 类型 | 说明 |
|---|---|---|
| spec | CanonicalSkillSpec | 必填，待渲染的 Spec |
| targets | ModelFamily[] | "*" |
bash
curl -X POST https://prompt.solokit.run/api/adapters/render \ -H "Content-Type: application/json" \ -d @spec.json
响应字段（RenderedSkill）
| 字段 | 类型 | 说明 |
|---|---|---|
| family | ModelFamily | 目标模型家族 |
| system | string | 推荐放到 system 字段的内容（推理模型可能为空） |
| user | string? | 推理模型首轮 user 消息（已合并所有指令） |
| messages | {role,content}[]? | 完整 messages payload，可直接传给 OpenAI 兼容 API |
| tools | any? | 厂商原生工具 schema（Anthropic / OpenAI / Google） |
| recommendedParameters | Record<string,any>? | 推荐调参（temperature / reasoning_effort / response_format） |
| artifacts | {filename,language,content,description}[]? | 附加产物，如 Claude 的 SKILL.md |
| notes | string[] | 该模型的使用注意事项 |
错误码
| HTTP | 说明 |
|---|---|
| 400 | Spec 不合法（缺少字段 / id 格式错误 / JSON 解析失败） |
| 400 | targets 中包含未知的模型家族 |