99.9%
服务可用性
<100ms
平均响应时间
10M+
日均调用次数
24/7
技术支持
快速导航
简介 认证方式 频率限制 智能对话（流式） 智能对话（标准） 翻译服务 文件转换 图片压缩 错误码

简介

云天AI API提供了强大的AI能力接口，包括智能对话、翻译、文件处理等功能。通过简单的HTTP请求，您可以将这些能力集成到您的应用中。

基础URL：chat.qicaiyun.top

请求格式

所有API请求均使用JSON格式，需要在请求头中设置 Content-Type: application/json。

响应格式

所有响应均为JSON格式，包含以下字段：

  • code - 状态码，200表示成功
  • message - 状态信息
  • data - 返回数据

认证方式

API使用Access ID和Access Key进行认证。在每次请求中，需要将这两个参数包含在请求体中。

获取密钥：登录后在个人中心查看您的API密钥。

认证示例

{
    "access_id": "YOUR_ACCESS_ID",
    "access_key": "YOUR_ACCESS_KEY",
    "message": "你好"
}

安全提示：请妥善保管您的Access Key，不要在客户端代码中暴露。建议在服务端进行API调用。

频率限制

为保障服务稳定性，API请求有以下限制：

  • 默认频率限制：100次/分钟
  • 单次请求最大文件大小：50MB
  • 每日调用次数：根据套餐等级而定

超过限制将返回 429 Too Many Requests 错误。

接口详情

POST /api/chat_v1/stream.php 智能对话（流式）

流式输出对话内容，适合实时展示场景

请求参数

参数名 类型 必填 说明
access_id string 是 用户Access ID
access_key string 是 用户Access Key
message string 是 用户消息内容
model string 否 模型ID，默认使用系统默认模型
conversation_id string 否 会话ID，用于多轮对话
stream boolean 否 是否流式输出，默认true

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "content": "AI回复内容",
        "model": "使用的模型",
        "usage": {
            "prompt_tokens": 10,
            "completion_tokens": 20,
            "total_tokens": 30
        }
    }
}

代码示例

// PHP 示例
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'chat.qicaiyun.top/api/chat_v1/stream.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'access_id' => 'YOUR_ACCESS_ID',
    'access_key' => 'YOUR_ACCESS_KEY',
    'message' => '你好，请介绍一下自己',
    'model' => 'gpt-3.5-turbo'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
POST /api/chat_v1/api.php 智能对话（标准）

标准响应格式，适合批量处理场景

请求参数

参数名 类型 必填 说明
access_id string 是 用户Access ID
access_key string 是 用户Access Key
message string 是 用户消息内容
model string 否 模型ID
conversation_id string 否 会话ID

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "content": "AI回复内容",
        "model": "gpt-3.5-turbo"
    }
}

代码示例

# Python 示例
import requests

response = requests.post(
    'chat.qicaiyun.top/api/chat_v1/api.php',
    json={
        'access_id': 'YOUR_ACCESS_ID',
        'access_key': 'YOUR_ACCESS_KEY',
        'message': '你好',
        'model': 'gpt-3.5-turbo'
    }
)
print(response.json())
POST /api/translation/index.php 翻译服务

多语言翻译服务，支持100+语言互译

请求参数

参数名 类型 必填 说明
access_id string 是 用户Access ID
access_key string 是 用户Access Key
text string 是 待翻译文本
source_lang string 否 源语言，默认auto自动检测
target_lang string 是 目标语言，如zh、en、ja等

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "translated_text": "翻译结果",
        "source_lang": "auto",
        "target_lang": "en"
    }
}

代码示例

# cURL 示例
curl -X POST 'chat.qicaiyun.top/api/translation/index.php' \
  -H 'Content-Type: application/json' \
  -d '{
    "access_id": "YOUR_ACCESS_ID",
    "access_key": "YOUR_ACCESS_KEY",
    "text": "你好，世界",
    "target_lang": "en"
  }'
POST /api/convert/index.php 文件转换

文件格式转换服务，支持PDF转图片、PDF转Word等

请求参数

参数名 类型 必填 说明
access_id string 是 用户Access ID
access_key string 是 用户Access Key
file file 是 待转换文件（multipart/form-data）
action string 是 转换类型：pdf2img, pdf2word, pdf2excel, img2pdf等

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "download_url": "chat.qicaiyun.top\/downloads\/converted_file.pdf",
        "filename": "converted_file.pdf"
    }
}

代码示例

// PHP 文件上传示例
$curl = curl_init();
$postFields = [
    'access_id' => 'YOUR_ACCESS_ID',
    'access_key' => 'YOUR_ACCESS_KEY',
    'action' => 'pdf2img',
    'file' => new CURLFile('/path/to/file.pdf')
];
curl_setopt($curl, CURLOPT_URL, 'chat.qicaiyun.top/api/convert/index.php');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
POST /api/image_compress/index.php 图片压缩

智能图片压缩服务，保持画质的同时减小文件体积

请求参数

参数名 类型 必填 说明
access_id string 是 用户Access ID
access_key string 是 用户Access Key
file file 是 图片文件
quality integer 否 压缩质量1-100，默认80

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "download_url": "chat.qicaiyun.top\/downloads\/compressed.jpg",
        "original_size": 1024000,
        "compressed_size": 512000,
        "compression_ratio": "50%"
    }
}

错误码

错误码 说明
200 请求成功
400 请求参数错误
401 认证失败，Access ID或Access Key无效
403 权限不足或账户已被禁用
429 请求过于频繁，请稍后重试
500 服务器内部错误
503 服务暂时不可用

立即开始

注册账户即可获得免费API调用额度

免费注册