方舟图片协议接入
本页只介绍方舟图片生成协议的接入方法，不绑定具体模型或版本。请在 控制台 选择已开通的图片模型，并将示例中的 YOUR_IMAGE_MODEL 替换为实际模型 ID。
开始前准备
- 在 控制台 确认图片能力已开通。
- 复制实际可调用的模型 ID，不根据展示名自行推导请求值。
- 确认渠道使用方舟原生兼容协议及 Bearer API Key 鉴权。
| 操作 | 平台兼容地址 | 请求类型 |
|---|---|---|
| 图片生成 | POST https://art-api.yuyuflow.com/api/v3/images/generations | application/json |
兼容前提
该地址仅适用于平台已开放方舟图片生成兼容路由的渠道。上游官方 SDK 定义了图片生成请求结构，但不构成平台路由、全部可选能力或精确模型 ID 的保证。若控制台提供不同路径或异步封装，请按渠道说明接入。
最小文生图请求
官方方舟 API 使用 Bearer API Key；平台兼容渠道应使用平台发放的 Key。把 YOUR_IMAGE_MODEL 替换为控制台中的实际值：
bash
curl --fail-with-body -X POST "https://art-api.yuyuflow.com/api/v3/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL",
"prompt": "一张现代家居产品海报，白色台灯，柔和自然光，干净背景"
}' --output response.json先使用默认参数完成一次请求，再根据当前渠道说明选择尺寸和结果格式，不要套用其他渠道的尺寸、图片数量或文件限制。
请求字段
以下为方舟图片协议字段。除最小请求的 model、prompt 外，可选字段是否可用，须以当前渠道说明为准。
| 字段 | 类型 | 使用说明 |
|---|---|---|
model | string | 已开通的完整模型 ID |
prompt | string | 图片主体、场景、风格及编辑目标 |
image | string / string[] | 渠道支持参考图时使用；官方协议可表达图片 URL 或 Base64 数据 URL |
size | string | 输出尺寸；可用取值以当前渠道说明为准 |
response_format | string | 渠道支持时选择 url 或 b64_json |
watermark | boolean | 水印选项，按模型及平台政策设置 |
stream | boolean | 流式响应选项；本页示例不启用流式 |
sequential_image_generation | string | 组图生成选项；未确认支持时不要传入 |
带参考图的请求体模板
仅在渠道明确支持参考图输入时，用以下 JSON 替换最小请求的 body；请求地址不变：
json
{
"model": "YOUR_IMAGE_MODEL",
"prompt": "保留参考图中台灯的外形，将背景改为暖色客厅",
"image": "data:image/png;base64,BASE64_OF_INPUT_PNG"
}数据 URL 包含 MIME 和 base64, 前缀，区别于 Gemini inlineData.data 的纯 Base64。使用图片 URL 时需确保服务端可访问且有效期足够；不要提供本地文件路径。参考图数量和文件限制需按渠道确认。
处理结果
非流式方舟图片结果使用 data 数组，图片项可包含 url、b64_json 和 size；还可能返回 model、usage 等信息。不要假定每次响应都同时含有 URL 和 Base64。
json
{
"data": [
{"b64_json": "BASE64_IMAGE_DATA"}
]
}上面仅展示选择并获准使用 Base64 输出时的结构，不代表默认响应格式。
- URL 结果：读取
data[].url，及时下载保存。不要将临时链接当作永久存储地址。 - Base64 结果：解码
data[].b64_json后保存，扩展名与实际图片编码一致；不要默认所有 Base64 都是 PNG。 - 失败或空结果：先检查 HTTP 状态、响应
error及每个图片项；保留必要的请求标识用于排查，不记录密钥或完整图片。 - 流式 / 异步渠道：按渠道约定解析事件或任务状态，不能用本页非流式 JSON 逻辑直接解析。
常见问题
- 模型不存在：检查是否把平台展示名误当成了实际模型 ID，或当前令牌分组没有权限。
- 尺寸或组图参数报错：删除可选参数，用最小请求验证；不要复用其他图片模型的限制。
- 参考图读取失败：确认图片编码、MIME、访问权限、链接有效期及渠道是否支持参考图。
- 接口返回 404：确认渠道是否开放
/api/v3/images/generations，不要自行改用 OpenAI 或视频接口。