丹青识画开源镜像使用教程：REST API调用与返回结构详解
1. 产品概述
丹青识画是一款融合深度学习技术与东方美学的智能影像理解系统。它能将普通图片转化为富有诗意的书法题跋，为数字内容增添文化韵味。本教程将详细介绍如何通过REST API调用该系统的核心功能。
2. 环境准备
2.1 获取API密钥
在使用API前，您需要：
- 访问丹青识画官方网站注册账号
- 在开发者中心创建新应用
- 获取专属API Key和Secret
2.2 安装必要工具
推荐使用Python进行开发，需要安装：
pip install requests pillow3. API调用详解
3.1 基础请求结构
所有API请求都需要包含以下头部信息：
headers = { "Content-Type": "application/json", "X-API-Key": "您的API密钥", "X-API-Secret": "您的API密钥" }3.2 图片上传接口
请求示例：
import requests url = "https://api.danqing.com/v1/image/upload" files = {'image': open('example.jpg', 'rb')} response = requests.post(url, files=files, headers=headers)参数说明：
image: 必填，支持JPG/PNG格式max_size: 可选，图片最大边长（默认1024px）
4. 核心功能API
4.1 基础识别接口
请求示例：
data = { "image_id": "上传返回的图片ID", "style": "regular" # 可选：regular/cursive/seal } response = requests.post("https://api.danqing.com/v1/analyze", json=data, headers=headers)4.2 高级定制接口
支持更多个性化参数：
data = { "image_id": "图片ID", "style": "cursive", "background": "xuan_paper", # 宣纸背景 "ink_color": "#8B0000", # 墨色 "output_size": "1080p" # 输出分辨率 }5. 返回数据结构
5.1 成功响应示例
{ "code": 200, "data": { "image_id": "abcd1234", "description": "远山含黛，近水含烟", "calligraphy_url": "https://.../result.png", "elements": [ {"object": "山", "confidence": 0.92}, {"object": "水", "confidence": 0.88} ] } }5.2 错误响应示例
{ "code": 400, "message": "无效的图片格式", "details": "仅支持JPG/PNG格式" }6. 常见问题解答
6.1 图片大小限制
- 最大支持10MB
- 建议分辨率：1024x1024px
6.2 请求频率限制
- 免费版：5次/分钟
- 付费版：50次/分钟
6.3 结果保存时效
- 生成结果保留7天
- 可调用下载接口永久保存
7. 总结
通过本教程，您已经掌握了丹青识画REST API的基本使用方法。这套接口设计简洁但功能强大，能够帮助开发者快速集成智能影像理解能力到各类应用中。建议先使用测试API Key进行开发调试，再部署到生产环境。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
