62 lines
2.1 KiB
Markdown
62 lines
2.1 KiB
Markdown
# 火山方舟图片生成
|
||
|
||
本插件面向火山方舟 Ark 图片生成 JSON 接口。提示词直接发送，参考图数组映射到 `image`，连续生成和水印参数可从模型扩展字段透传。
|
||
|
||
## 接口、鉴权与区域
|
||
|
||
{{OPERATIONS}}
|
||
|
||
```http
|
||
POST {channel_base_url}/api/v3/images/generations
|
||
Authorization: Bearer <ARK_API_KEY>
|
||
Content-Type: application/json
|
||
```
|
||
|
||
Base URL、鉴权方式和可用模型受火山方舟控制台、区域与接入方式影响。若使用 AK/SK 签名网关，应由渠道层完成签名，不能把 Secret Key 写入插件文档或浏览器。
|
||
|
||
## 模型与支持边界
|
||
|
||
模型 ID、尺寸范围与能力以火山方舟控制台为准。
|
||
|
||
## 参数与字段映射
|
||
|
||
{{PARAMETERS}}
|
||
|
||
当前实现：`aspectRatio -> size`，所有 `images -> image[]`；`extra` 可透传 `size`、`sequential_image_generation`、`sequential_image_generation_options`、`watermark`。`imageCount`、`quality` 与 `resolution` 没有通用映射，必须按模型接口另行适配。
|
||
|
||
## 文生图示例
|
||
|
||
```bash
|
||
curl "{channel_base_url}/api/v3/images/generations" \
|
||
-H "Authorization: Bearer <ARK_API_KEY>" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model":"YOUR_ARK_ENDPOINT_OR_MODEL",
|
||
"prompt":"古城屋顶追逐，低机位，动态构图",
|
||
"size":"2048x1152",
|
||
"watermark":false
|
||
}'
|
||
```
|
||
|
||
## 参考图示例
|
||
|
||
```json
|
||
{
|
||
"model":"YOUR_ARK_ENDPOINT_OR_MODEL",
|
||
"prompt":"保持人物服装和发型，生成侧面中景",
|
||
"image":["https://example.com/character.png"],
|
||
"size":"2048x1152"
|
||
}
|
||
```
|
||
|
||
## 响应解析与限制
|
||
|
||
响应按 `data[]` 图片数组解析，元素需包含 `url`、`b64_json` 或 `data`。当前插件没有为 Ark 特有错误码、任务模式或内容过滤结果做专属解包；渠道返回非兼容结构时会明确失败。模型尺寸、参考图数量、序列图上限、水印和计费以控制台当前模型说明为准，不能从插件默认值推断。
|
||
|
||
## 官方资料
|
||
|
||
- [火山方舟视觉模型 API 文档](https://www.volcengine.com/docs/82379)
|
||
- [火山方舟 API 接入与鉴权文档](https://www.volcengine.com/docs/82379/1263279)
|
||
|
||
{{CONTRACT}}
|