Files
ttstd-infinite-canvas/backend/internal/protocol/docs/volcengine-ark-image.md

2.1 KiB
Raw Blame History

火山方舟图片生成

本插件面向火山方舟 Ark 图片生成 JSON 接口。提示词直接发送,参考图数组映射到 image,连续生成和水印参数可从模型扩展字段透传。

接口、鉴权与区域

{{OPERATIONS}}

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 没有通用映射,必须按模型接口另行适配。

文生图示例

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
  }'

参考图示例

{
  "model":"YOUR_ARK_ENDPOINT_OR_MODEL",
  "prompt":"保持人物服装和发型,生成侧面中景",
  "image":["https://example.com/character.png"],
  "size":"2048x1152"
}

响应解析与限制

响应按 data[] 图片数组解析,元素需包含 url、b64_json 或 data。当前插件没有为 Ark 特有错误码、任务模式或内容过滤结果做专属解包;渠道返回非兼容结构时会明确失败。模型尺寸、参考图数量、序列图上限、水印和计费以控制台当前模型说明为准,不能从插件默认值推断。

官方资料

{{CONTRACT}}