琴葉的图片服务 API 完整使用指南
功能说明：该端点提供批量图片上传服务，支持通过 HTTP POST 请求上传多张图片文件。上传的文件将被保存到服务器临时目录，随后由后台处理线程异步处理并上传至图库系统。
特性：
适用场景：需要批量上传大量图片，且不需要立即获取处理结果的场景。推荐在生产环境中使用此端点。
# 批量上传示例
curl -X POST https://site.avonsaria.fun/upload_batch \
-F "files=@/path/to/image1.jpg" \
-F "files=@/path/to/image2.png" \
-F "files=@/path/to/image3.gif"
功能说明：该端点提供批量图片上传服务，支持通过 HTTP POST 请求上传多张图片文件。上传的文件将被保存到服务器临时目录，随后由后台处理线程异步处理并上传至图库系统。
特性：
适用场景：需要批量上传大量图片，且不需要立即获取处理结果的场景。推荐在生产环境中使用此端点。
# 批量上传示例
curl -X POST https://site.avonsaria.fun/upload_batch \
-F "files=@/path/to/image1.jpg" \
-F "files=@/path/to/image2.png" \
-F "files=@/path/to/image3.gif"
功能说明：该端点接收图片文件的二进制数据，直接上传至图库系统进行处理。请求采用同步阻塞模式，客户端需要等待服务器完成图片处理并返回结果。
特性：
请求格式：使用 multipart/form-data 格式，字段名为 file，值为图片文件的二进制数据。
适用场景：需要立即获取图片处理结果的场景。由于响应时间较长，不推荐在高并发或批量上传场景中使用。
# 使用 curl 上传图片文件
curl -X POST https://n8n.kotoba.avonsaria.fun/webhook/animeDB/upload/v1 \
-F "file=@/path/to/image.jpg"
成功响应（HTTP 200）将返回 JSON 格式的图片信息，包含图片 URL、描述、标签等元数据。响应时间约 30 秒，取决于图片处理复杂度。
功能说明：该端点接收图片文件的 Base64 编码字符串，解码后上传至图库系统进行处理。请求采用同步阻塞模式，客户端需要等待服务器完成图片处理并返回结果。
特性：
请求格式：使用 JSON 格式，包含 Base64 编码的图片数据。需要在请求体中包含图片的 Base64 字符串。
适用场景：需要在 JSON 请求中直接嵌入图片数据的场景。由于响应时间较长且数据体积较大，不推荐在高并发或批量上传场景中使用。
# 使用 curl 上传 Base64 编码的图片
curl -X POST https://n8n.kotoba.avonsaria.fun/webhook/animeDB/upload/v2 \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."
}'
成功响应（HTTP 200）将返回 JSON 格式的图片信息，包含图片 URL、描述、标签等元数据。响应时间约 30 秒，取决于图片处理复杂度。Base64 字符串需要包含数据 URI 前缀（如 data:image/jpeg;base64,）。
功能说明：该端点提供批量表情包上传服务，支持通过 HTTP POST 请求上传多张表情包文件。上传的文件将被保存到服务器临时目录，随后由后台处理线程异步处理并上传至表情包库系统。
特性：
重要提示：此端点专门用于上传表情包，而非普通图片。请确保上传的文件为表情包格式。
适用场景：需要批量上传大量表情包，且不需要立即获取处理结果的场景。推荐在生产环境中使用此端点。
# 批量上传表情包示例
curl -X POST https://site.avonsaria.fun/upload_emoji_batch \
-F "files=@/path/to/emoji1.jpg" \
-F "files=@/path/to/emoji2.png" \
-F "files=@/path/to/emoji3.gif"
功能说明：该端点从图库中随机获取一张或多张图片的元数据信息，以 JSON 格式返回。返回的数据包含图片的 URL、描述、角色信息、安全评级和标签等详细信息。
特性：
count 参数指定获取的图片数量响应字段说明：
url：图片的完整访问 URLdescription：图片的英文描述信息character：角色信息（可能为 null）safety_rating：安全评级（如 "safe"）tags：图片标签的 JSON 字符串数组| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
count |
number | 否 | 获取图片数量，默认为 1 |
# 获取单张随机图片
GET https://n8n.kotoba.avonsaria.fun/webhook/animeDB/get/random/v1
# 获取 5 张随机图片
GET https://n8n.kotoba.avonsaria.fun/webhook/animeDB/get/random/v1?count=5
功能说明：该端点从图库中随机获取一张图片，直接返回图片文件的二进制数据。响应内容类型为图片格式（如 image/jpeg、image/png 等），可直接用于显示或保存。
特性：
适用场景：需要直接获取图片文件用于显示、下载或进一步处理的场景。适合在 HTML img 标签中直接使用，或作为文件下载。
# 直接获取图片文件
GET https://n8n.kotoba.avonsaria.fun/webhook/animeDB/get/random/v2
功能说明：该端点从表情包库中获取一个表情包图片，支持根据指定的情绪类型进行筛选。响应直接返回表情包图片的二进制数据，内容类型为图片格式。
特性：
emotion 参数指定情绪类型，共 28 种情绪可选情绪参数说明：参数值为字符串类型，必须使用小写字母。支持的情绪类型包括：admiration（钦佩）、amusement（娱乐）、anger（愤怒）、annoyance（烦恼）、approval（赞同）、caring（关心）、confusion（困惑）、curiosity（好奇）、desire（渴望）、disappointment（失望）、disapproval（不赞同）、disgust（厌恶）、embarrassment（尴尬）、excitement（兴奋）、fear（恐惧）、gratitude（感激）、grief（悲伤）、joy（快乐）、love（爱）、nervousness（紧张）、neutral（中性）、optimism（乐观）、pride（骄傲）、realization（领悟）、relief（宽慰）、remorse（懊悔）、sadness（悲伤）、surprise（惊讶）。
适用场景：需要在应用或网站中动态获取表情包的场景，如聊天应用、社交媒体、内容创作等。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
emotion |
string | 否 | 指定的情绪类型，共 28 种可选 |
# 获取随机表情包
GET https://n8n.kotoba.avonsaria.fun/webhook/emojis/get/v1
# 获取指定情绪的表情包
GET https://n8n.kotoba.avonsaria.fun/webhook/emojis/get/v1?emotion=joy