1 Commits
v0.1.3 ... main

Author SHA1 Message Date
9abe55db31 fill nas agent api token 2026-05-09 19:29:58 +08:00

View File

@@ -1,4 +1,4 @@
# API 图片绘制及修改 Agent 调用说明 NAS 版
# API 图片绘制及修改 Agent 调用说明 NAS 版
本文件用于部署在 NAS 上的 Gemini Draw。默认 NAS 服务地址:
@@ -21,13 +21,13 @@ Container Station 创建应用时不要再使用相对环境文件路径。NAS
调用时二选一携带:
```txt
Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN
Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978
```
或:
```txt
x-api-key: YOUR_LONG_RANDOM_API_TOKEN
x-api-key: 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978
```
## Gemini API Key
@@ -43,7 +43,7 @@ Gemini API Key 可以通过三种方式提供:
```bash
curl -X POST http://192.168.31.5:4000/api/config/api-key \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN" \
-H "Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978" \
-d "{\"apiKey\":\"YOUR_GEMINI_API_KEY\",\"persist\":false}"
```
@@ -73,21 +73,21 @@ curl http://192.168.31.5:4000/api/health
```bash
curl -X POST http://192.168.31.5:4000/api/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN" \
-H "Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978" \
-d "{\"prompt\":\"画一个蓝天白云下的极简风景插画\",\"imageSize\":\"1K\",\"aspectRatio\":\"1:1\"}"
```
PowerShell 保存返回图片:
```powershell
$token='YOUR_LONG_RANDOM_API_TOKEN'; $body=@{prompt='画一个蓝天白云下的极简风景插画'; imageSize='1K'; aspectRatio='1:1'} | ConvertTo-Json -Depth 5; $r=Invoke-RestMethod -Uri 'http://192.168.31.5:4000/api/generate' -Method Post -Headers @{Authorization="Bearer $token"} -ContentType 'application/json; charset=utf-8' -Body $body; [IO.File]::WriteAllBytes((Join-Path (Get-Location) 'nas-output.png'), [Convert]::FromBase64String($r.images[0].data))
$token='5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978'; $body=@{prompt='画一个蓝天白云下的极简风景插画'; imageSize='1K'; aspectRatio='1:1'} | ConvertTo-Json -Depth 5; $r=Invoke-RestMethod -Uri 'http://192.168.31.5:4000/api/generate' -Method Post -Headers @{Authorization="Bearer $token"} -ContentType 'application/json; charset=utf-8' -Body $body; [IO.File]::WriteAllBytes((Join-Path (Get-Location) 'nas-output.png'), [Convert]::FromBase64String($r.images[0].data))
```
## 修改已有图片
```bash
curl -X POST http://192.168.31.5:4000/api/edit-image \
-H "Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN" \
-H "Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978" \
-F "prompt=保留主体不变,把背景改成干净的白色摄影棚,增强产品质感" \
-F "imageSize=1K" \
-F "aspectRatio=1:1" \
@@ -98,7 +98,7 @@ curl -X POST http://192.168.31.5:4000/api/edit-image \
```bash
curl -X POST http://192.168.31.5:4000/api/analyze-document \
-H "Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN" \
-H "Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978" \
-F "prompt=用中文总结这份文档,提取关键结论和待办事项" \
-F "files=@report.pdf"
```
@@ -108,7 +108,7 @@ curl -X POST http://192.168.31.5:4000/api/analyze-document \
```bash
curl -X POST http://192.168.31.5:4000/api/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN" \
-H "Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978" \
-d "{
\"prompt\":\"把这张图改成赛博朋克夜景风格,但保留人物脸部特征\",
\"imageSize\":\"1K\",
@@ -132,8 +132,9 @@ curl -X POST http://192.168.31.5:4000/api/generate \
## Agent 调用建议
1. NAS 固定 API 地址使用 `http://192.168.31.5:4000`
2. 每次调用都必须携带 `Authorization: Bearer YOUR_LONG_RANDOM_API_TOKEN``x-api-key`
2. 每次调用都必须携带 `Authorization: Bearer 5065a4dbb20509600252e6c6a3e9ef075de1d81e0dde19d40800fbbad402d978``x-api-key`
3. 绘制新图用 `POST /api/generate`
4. 修改已有图片用 `POST /api/edit-image`
5. 文档分析用 `POST /api/analyze-document`
6. 返回图片使用 `images[0].dataUrl` 预览,或解码 `images[0].data` 保存为文件。