图片接入指南​

通过 yuyuflow 接入图片生成与编辑。不同模型使用的协议、图片输入方式和结果格式不同，请先选定模型，再按对应指南接入，不要只替换模型名。

开始前准备​

1. 在 控制台 创建 API Key，确认余额、令牌分组和模型权限。
2. 复制控制台提供的完整模型 ID，确认使用同步接口还是异步封装。
3. 平台 API 根地址为 https://art-api.yuyuflow.com。确认接口路径及鉴权方式后再发送请求，不要向第三方地址发送平台密钥。

选择接入协议​

同步结果与异步任务​

• 同步接口：请求完成后返回图片数据；HTTP 成功不代表一定有图片，还需检查结果数组和错误信息。
• 异步封装：提交后需按平台任务协议取得最终结果。任务 ID 字段、查询路径、状态枚举、回调及结果外层结构必须以实际开通接口说明为准。
• Gemini 平台封装的内容输入、最终生成内容按官方结构接入；异步任务层单独处理。不要把首次提交的任务回执当成 GenerateContentResponse。
• 不要套用视频任务查询接口查询图片，也不要把流式响应当作异步任务查询协议。

专用接口接入说明​

平台专用接口不一定兼容上述三类协议。接入前先取得渠道说明，确认提交路径、鉴权方式、请求字段和结果结构；不能仅替换 model 就假定生成或编辑接口可用。

若接口返回任务回执，应按指定查询方法和间隔等待任务进入终态：成功后读取最终图片，失败时处理错误，超过等待时限后先确认任务状态再决定是否重试。回调、取消等操作仅在渠道明确提供时使用，不猜测路由或状态字段。

图片结果与调用安全​

• Base64 解码后保存为与实际 MIME / 输出格式一致的文件，不要把 Base64 文本当成图片 URL。
• 下载链接可能有有效期，获取结果后及时保存；不要依赖固定的链接寿命。
• 编辑时仅上传有权使用的图片。密钥、参考图和完整 Base64 不应写入公开日志。
• 超时不一定表示服务端未执行；先确认结果或任务状态，再决定是否重试，避免重复扣费。

常见问题​

继续阅读：快速开始 · OpenAI 图片 · Gemini 图片 · 方舟图片协议