📖 API文档
🚀 快速开始
1. 注册账号并登录
2. 在用户中心创建API密钥
3. 使用API密钥调用接口
API地址：https://api.gshgg.cn/v1
📁 入门指南
API接入指南
欢迎使用涵光云方言AI开放API。本API支持西北地区方言识别、文本翻译等功能。
获取API Key
登录后在用户中心申请API密钥，每个用户可申请多个密钥。
📁 开发文档
调用示例
curl -X POST https://api.gshgg.cn/v1/chat -H "X-API-Key: your_key" -d "{message:你好}"
🔧 接口详情
POST /v1/chat
智能对话接口，支持方言理解
curl -X POST https://api.gshgg.cn/v1/chat \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"message": "咋办呢这个事情",
"dialect": "甘肃",
"context": []
}'
参数说明：
- message: 用户消息内容
- dialect: 方言类型（甘肃/青海/陕西/宁夏/新疆）
- context: 对话上下文（可选）
响应示例：
{
"success": true,
"message": "这个事情可以这样处理...",
"dialect_detected": "甘肃",
"provider": "zhipu"
}
POST /v1/translate
方言文本翻译为标准普通话
curl -X POST https://api.gshgg.cn/v1/translate \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"text": "我勒个去，这咋整呢",
"source_dialect": "甘肃"
}'
响应示例：
{
"success": true,
"original": "我勒个去，这咋整呢",
"translated": "哎呀，这怎么办呢",
"dialect": "甘肃"
}
POST /v1/detect
识别文本中的方言类型
curl -X POST https://api.gshgg.cn/v1/detect \
-H "X-API-Key: dialect_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"text": "你咋这么能呢"
}'
响应示例：
{
"success": true,
"dialect": "甘肃",
"confidence": 0.85,
"keywords": ["咋", "能"]
}
⚠️ 错误码说明
| 错误码 | 说明 |
|---|---|
| 401 | API密钥无效或未提供 |
| 403 | API密钥已禁用或超出速率限制 |
| 400 | 请求参数错误 |
| 500 | 服务器内部错误 |
📦 SDK示例
Python示例：
import requests
api_key = "dialect_xxxxxxxxxxxxxxxx"
url = "https://api.gshgg.cn/v1/chat"
response = requests.post(url, headers={
"X-API-Key": api_key,
"Content-Type": "application/json"
}, json={
"message": "你好",
"dialect": "甘肃"
})
print(response.json())
JavaScript示例：
const apiKey = 'dialect_xxxxxxxxxxxxxxxx';
fetch('https://api.gshgg.cn/v1/chat', {
method: 'POST',
headers: {
'X-API-Key': apiKey,
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: '你好',
dialect: '甘肃'
})
})
.then(res => res.json())
.then(data => console.log(data));