Flux Art先读字段约定，再转换图片
把 Flux Art 图片用于自建素材管理或业务接口时，前端能显示一串图片字符串，并不表示后端接收字段也认可它。Data URL、纯 Base64、远程 HTTPS 地址和二进制上传各有不同的约定。本文不声称平台任意接口都接收这些形式，具体参数必须查看对应文档。先确定接收端要求哪一种表示，再决定是否转换；不要遇到报错就依次添加前缀、删前缀和再编码，直到某次恰好不报错。
给每次转换标出输入和输出
建议在内部处理记录中写明输入是 File、Blob、字符串还是网络地址，输出字段期望什么，转换发生在哪一层。不要将整条图片字符串写进日志，记录长度、声明类型、操作编号和必要的内容校验值即可。一个普通文本字段并不自动意味着接受 Base64；它也可能仅接受资源编号。先在测试环境以非敏感小文件验证契约，再让真实业务素材进入同一流程。
认识 Data URL 的包装层
FileReader.readAsDataURL 读取完成后给出带声明前缀的 Data URL。若接收端明确要求纯 Base64，需要移除相应声明后再处理负载；不能把整条 Data URL 直接送进只接受 Base64 的解码器。反过来，要求完整 Data URL 的字段也不能只收到裸负载。应验证前缀结构及编码标记，不要按固定字符数截取，因为不同媒体类型的声明长度不同。下表是表示核对，不是接口通用兼容清单。
| 数据形式 | 先核对什么 | 常见误用 |
|---|---|---|
| 完整Data URL | 字段是否接受声明前缀 | 当作裸Base64解码 |
| 纯Base64 | 编码约定及原始字节 | 再次编码字符串 |
| 二进制文件 | 接口规定的传输方式 | 塞进普通文本字段 |
| HTTPS地址 | 字段是否要求远程资源 | 误当图片内容本身 |
| 读取结束 | 成功错误或中止状态 | loadend直接报成功 |
| 接收成功 | 实际保存内容和业务编号 | 只看字符串合法 |
不要对已经编码的文本再编码一次
有些错误来自把 Base64 字符串本身当作原始图片字节再次编码，接收端得到的便是文字，而不是图片。建议用一个已知测试文件核对转换前后：解码所得字节应与原始文件一致，前提是中间没有声明的重编码步骤。若确实进行了缩放或格式转换，应将它登记为新版本，不能再要求字节等同原文件。文件扩展名与声明的媒体类型也不能代替真实内容验证。
读取结束与读取成功分开
读取流程应区分成功、错误和中止。loadend 表示过程结束，不能独自作为成功依据；需要在成功路径取得本次结果，并在错误或取消时阻止继续提交。重复选择文件时，将读取结果绑定当前候选身份，旧回调不得覆盖新结果。若读取失败，保留清楚的错误阶段，不把空字符串发给接收端再猜测服务器为何拒绝，也不显示“已经上传”来掩盖本地读取尚未完成。
用可对照的假设样本排查
假设测试文件甲按接收端约定转换为纯 Base64，文件乙故意带上 Data URL 前缀送往同一字段。这是假设故障注入，不是真实接口测试。应记录甲的约定匹配结果与乙的明确拒绝，不期待接收端自动容错。再把已编码负载编码一次，确认测试能识别解码后不是原始图片。最后测试取消读取，证明没有产生业务提交，不能只看最终HTTP状态。
体积和隐私是独立限制
将二进制变成字符串并不会自动节省传输空间；浏览器还可能同时保留文件、字符串与预览资源。是否需要转换，应由接口约定与应用资源预算决定，不是为了让日志看起来方便。若接口支持合适的二进制方式，可按其文档使用，不自行假定所有接收端都有该能力。图片字符串仍包含完整素材信息，应按图片本身的敏感程度处理，不因为它没有传统文件扩展名就随意分享。
交付一份表示契约而非猜测列表
建议交付字段名、允许表示、媒体类型来源、转换步骤、最大业务输入及错误反馈规则，并附上可复现的非敏感测试样本。大小限制来自实际接收端文档或测试，未知时写待补证，不编造统一数字。接收成功后还要核对业务实际保存的图片能否正确打开及对应原操作编号。字符串格式合法只是前置条件，不代表业务关联、权限和最终素材内容都已验收。
资料和平台使用边界
技术依据核对于2026年11月9日：文件读取的 Data URL 结果见 https://developer.mozilla.org/en-US/docs/Web/API/FileReader/readAsDataURL ，读取结束事件见 https://developer.mozilla.org/en-US/docs/Web/API/FileReader/loadend_event 。Flux Art 生成结果可用于商业用途，输入素材权利和商品真实性需另行核验；具体接口入口为 https://flux-art.net/zh/openapi 。本文不外推任何具体模型的请求字段，实际表示要求以对应接口说明为准。