Flutter for OpenHarmony 实战：通义万相联调与相册持久化

Flutter for OpenHarmony 实战：通义万相联调与相册持久化

在鸿蒙生态中，文件的存储安全与权限管理有着极其严格的标准。本篇我们将打通阿里云通义万相的 API 联调，并深度解析如何调用鸿蒙底层能力，将创意艺术品永久存入用户相册。

开发环境与前置准备

为了确保代码能够准确运行，请参考以下实战环境配置：

环境项	版本/要求	备注
Flutter SDK	3.7.12-ohos	HarmonyOS 适配版
DevEco Studio	4.1 Release	对应 HarmonyOS Next API 11+
API 服务	阿里云 DashScope	需开启通义万相模型权限
核心依赖	http, saver_gallery	详见架构篇配置

AI 服务联调：接入阿里云通义万相

通义万相提供了基于 Messages 的多模态生成接口。在鸿蒙上，我们主要处理异步的 POST 请求。

封装 AI 绘图服务

为了提升请求的健壮性，我们引入了超时处理逻辑。

Future<String> generateImage({
  required String prompt,
  required String apiKey,
  String model = "qwen-image-max",
}) async {
  final headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer $apiKey',
  };
  final body = jsonEncode({
    "model": model,
    "input": {
      "messages": [
        {"role": "user", "content": [{"text": prompt}]}
      ]
    },
    "parameters": {"size": "1024*1024", "n": 1}
  });

  try {
    // 增加 30 秒超时处理，适配 AI 生成的长周期特性
    final response = await http
        .post(Uri.parse(_baseUrl), headers: headers, body: body)
        .timeout(const Duration(seconds: 30));

    if (response.statusCode == 200) {
      final data = jsonDecode(response.body);
      return data['output']['choices'][0]['message']['content'][0]['image'];
    } else {
      throw "生成失败：Code ${response.statusCode}";
    }
  } on TimeoutException {
    throw "请求超时，AI 绘画可能需要更多时间，请检查网络";
  } catch (e) {
    throw "服务异常：$e";
  }
}

实战建议：由于通义万相是异步生成链路，虽然 API 提供了直接响应，但在高并发时可能会返回中间状态。建议在 UI 层增加对错误代码的语义化解析（如非法 Prompt 拦截）。

攻克鸿蒙持久化：权限合规与相册写入

在 HarmonyOS Next 中，保存图片到相册涉及'分布式能力'与'文件夹沙盒'双重规则。

关键：鸿蒙侧权限配置

在 ohos/entry/src/main/module.json5 中，必须声明媒体读写权限（针对使用三方持久化库的项目）：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.WRITE_IMAGEVIDEO",
        "reason": "$string:reason_save_image",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "always"
        }
      }
    ]
  }
}