企业官网建设流程全解析

丹青识画开源镜像使用教程：REST API调用与返回结构详解

1. 产品概述

丹青识画是一款融合深度学习技术与东方美学的智能影像理解系统。它能将普通图片转化为富有诗意的书法题跋，为数字内容增添文化韵味。本教程将详细介绍如何通过REST API调用该系统的核心功能。

2. 环境准备

2.1 获取API密钥

在使用API前，您需要：

1. 访问丹青识画官方网站注册账号
2. 在开发者中心创建新应用
3. 获取专属API Key和Secret

2.2 安装必要工具

推荐使用Python进行开发，需要安装：

pip install requests pillow

3. 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星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。