2.1 KiB
2.1 KiB
火山方舟图片生成
本插件面向火山方舟 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}}