API 文档
通过 HTTP 接口调用渊洋智能文本生成算法。
鉴权
在请求头携带 X-API-Key，密钥在API 密钥页获取。
POST /api/v1/generate
请求体
{
"prompt": "用一句话介绍杭州",
"model": "qwen-plus" // qwen-plus | qwen-max | qwen-turbo
}
cURL 示例
curl -X POST https://cliapi.yydata.tech/api/v1/generate \
-H "X-API-Key: sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{"prompt":"用一句话介绍杭州"}'
响应（已含 AI 显式标识与隐式溯源元数据）
{
"content": "杭州是浙江省省会...",
"explicit_label": "本内容由 AI 生成",
"metadata": {
"aigc": true, "provider": "杭州渊洋信息科技有限公司",
"providerCode": "YY-CLIAPI-0001", "contentId": "C000123"
}
}
错误码
| 状态码 | 含义 |
|---|---|
| 401 | 密钥无效 |
| 403 | 账号未实名 |
| 400 | 输入/输出内容被安全检测拦截 |
| 502 | 上游模型调用失败 |