GETTING STARTED
KLai API 文档
使用统一、兼容的 HTTP API 接入 KLai 模型。下面只保留从获得密钥到完成第一次请求所必需的内容。
Base URL
https://ai.kuo.la/v1快速开始
- 1创建 API Key
登录控制台，在 API Keys 页面创建密钥。密钥只会完整显示一次。
- 2选择模型 ID
在模型库打开模型详情，复制页面展示的公开 Model ID。
- 3发起请求
将密钥放入 Bearer Authorization 请求头。
身份认证
所有模型调用都使用 Bearer Token。请只在服务端保存 API Key，不要把它放进浏览器代码或公开仓库。
HTTP
Authorization: Bearer $KLAI_API_KEY获取模型列表
使用模型列表接口读取当前账户可调用的公开模型 ID。
GET
/v1/models文本生成
接口兼容常见的 Chat Completions 请求结构。更换模型时通常只需要修改 model。
POST
/v1/chat/completionscURL
curl https://ai.kuo.la/v1/chat/completions \
-H "Authorization: Bearer $KLAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-id",
"messages": [{"role": "user", "content": "你好"}]
}'图像生成
提交提示词后，接口可能直接返回结果，也可能返回异步任务 ID。具体参数以模型详情页为准。
POST
/v1/images/generationscURL
curl https://ai.kuo.la/v1/images/generations \
-H "Authorization: Bearer $KLAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"your-image-model","prompt":"一座未来城市"}'视频生成
视频生成采用异步任务模式。创建成功后保存响应中的任务 ID，并轮询任务接口。
POST
/v1/videos/generations查询异步任务
当状态为 succeeded 时读取结果；为 failed 时根据安全错误信息调整请求。
GET
/v1/tasks/:idcURL
curl https://ai.kuo.la/v1/tasks/{task_id} \
-H "Authorization: Bearer $KLAI_API_KEY"错误处理
| 状态码 | 含义 | 建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查模型 ID 与参数格式 |
| 401 | 认证失败 | 确认 API Key 有效 |
| 402 | 余额不足 | 充值后重试 |
| 429 | 请求过快 | 指数退避后重试 |
| 5xx | 服务暂不可用 | 稍后重试并保留请求信息 |