修正image-tools技能并新增NAS U盘主图素材

- 清理万相相关内容(SKILL.md、wan_image_edit.py),仅保留豆包Seedream
- 修正豆包万相误称,明确为火山引擎豆包Seedream
- 新增文字渲染技巧章节(双引号包裹、逐字拼写、清晰度约束)
- 更新doubao-api-reference.md模型ID和参数说明
- 新增产品/NAS U盘目录(实拍图、主图、产品名称)
- 清理旧的nascab目录冗余图片和脚本
This commit is contained in:
12600k-rog-d4
2026-07-06 07:48:03 +08:00
parent aa926688c4
commit 3688e40383
22 changed files with 104 additions and 404 deletions

View File

@@ -1,18 +1,21 @@
# Volcengine Ark Image API Reference
# 火山引擎 Ark 图像生成 API 参考
## Endpoint
> 本文档描述字节跳动/火山引擎的豆包 Seedream 模型 API。
> 阿里云万相Wan是不同厂商的产品参见万相相关文档。
## 端点
`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
## Authentication
## 认证
```
Authorization: Bearer ark-119a37ed-f123-42fc-aea6-b38d47d47fc0-f7ddf
```
## Response Format
## 响应格式
### Success Response (response_format: "url")
### 成功响应 (response_format: "url")
```json
{
@@ -26,7 +29,7 @@ Authorization: Bearer ark-119a37ed-f123-42fc-aea6-b38d47d47fc0-f7ddf
}
```
### Success Response (response_format: "b64_json")
### 成功响应 (response_format: "b64_json")
```json
{
@@ -40,7 +43,7 @@ Authorization: Bearer ark-119a37ed-f123-42fc-aea6-b38d47d47fc0-f7ddf
}
```
### Error Response
### 错误响应
```json
{
@@ -51,26 +54,46 @@ Authorization: Bearer ark-119a37ed-f123-42fc-aea6-b38d47d47fc0-f7ddf
}
```
## Available Models
## 可用模型
| Model ID | Capabilities | Max Size |
|---|---|---|
| `doubao-seedream-5-0-260128` | Text-to-image, image-to-image, multi-image fusion, editing, batch | 2K |
| `doubao-seedream-4-5-t2i` | Text-to-image, image-to-image, multi-image fusion | 4K |
| `doubao-seedream-4-0-t2i` | Text-to-image, image-to-image, multi-image fusion | 4K |
| `doubao-seedream-5-0-lite-t2i` | Text-to-image, batch, web search | 3K |
| `doubao-seedream-3-0-t2i` | Text-to-image (with seed/guidance_scale) | 2K |
| `doubao-seededit-3-0-i2i` | Dedicated image editing (with seed/guidance_scale) | adaptive |
| Model ID | 能力 | 最大尺寸 | 备注 |
|---|---|---|---|
| `doubao-seedream-5-0-260128` | 文生图、图生图、多图融合、编辑、批量、联网搜索 | 3K | **默认推荐** |
| `doubao-seedream-5-0-lite-260128` | 文生图、批量、联网搜索 | 3K | 轻量版,速度更快 |
| `doubao-seedream-4-5-251128` | 文生图、图生图、多图融合 | 4K | 高质量 |
| `doubao-seedream-4-0-250828` | 文生图、图生图、多图融合 | 4K | 稳定版 |
| `doubao-seededit-3-0-i2i` | 精确图片编辑 (seed/guidance_scale) | adaptive | **当前API Key无权限** |
## Image Input Formats
> ⚠️ `doubao-seededit-3-0-i2i` 精确编辑模型在当前 API Key 下返回 404暂不可用。
- **URL**: Publicly accessible HTTP/HTTPS URL
## 图片输入格式
- **URL**: 公网可访问的 HTTP/HTTPS URL
- **Base64**: `data:image/<format>;base64,<encoded_data>`
- Format must be lowercase: `data:image/png;base64,...` (not `PNG`)
- Supported formats: png, jpeg, webp
- 格式必须小写: `data:image/png;base64,...`(不是 `PNG`
- 支持格式: png, jpeg, jpg, webp, bmp, tiff, gif
- 文件大小: 不超过 10MB
- 总像素: ≤ 6000×6000
- 宽高比: [1/16, 16]
## Size Constraints
## 尺寸约束
- Pixel range: `[1280, 4096]` for both width and height
- Max aspect ratio: 3:1 (long edge to short edge)
- Custom size format: `"WIDTHxHEIGHT"` (e.g., `"2048x1024"`)
### 方式1分辨率别名
- `2K`(默认)、`3K`仅5.0)、`4K`4.5/4.0
- 需在 prompt 中描述宽高比/形状/用途,由模型判断具体像素
### 方式2精确像素
- 格式: `"WIDTHxHEIGHT"`(如 `"2048x2048"`
- 总像素范围: [3686400, 16777216](即最小约 2560×1440
- 宽高比范围: [1/16, 16]
- 每个维度: [1280, 4096]
> ⚠️ 两种方式不可混用
## image 参数说明
- 类型: `string[]`URL或Base64数组
- 最多 **10** 张参考图
- 输入图 + 输出图总数 ≤ 15
- prompt 中用"图1""图2"等指代图片顺序
- **重要**: image 传入的是参考图,模型会根据 prompt 重新生成不能100%像素级保留原图产品外观