Flutter稳定性监控插件stability_sdk的使用

简介

stability_sdk 是一个在 Dart 中实现的 Stability AI SDK。Stability AI 是一个致力于创新理念的解决方案工作室。

前提条件

创建API密钥

Stability AI 需要你创建自己的 API 密钥才能调用 API。你可以在这里创建一个：创建API密钥。

设置环境变量

创建一个 .env 文件，并设置你的 Stability AI API 密钥。

使用方法

示例提供了如何直接在 Flutter 应用中使用 SDK 的方法。大多数情况下，你会在后端使用工具（如 dart_frog）来使用 SDK，以确保 API 密钥的安全，并更好地控制传入请求，例如限制速率或阻止敏感内容。

// 1. 设置 API 客户端
final client = StabilityApiClient.init("<YOUR_API_KEY_HERE>");

// 2. 创建生成请求
final request = RequestBuilder("an oil painting of a dog in the canvas, wearing knight armor, realistic painting by Leonardo da Vinci")
    .setHeight(512)
    .setWidth(512)
    .setEngineType(EngineType.inpainting_v2_0)
    .setSampleCount(1)
    .build();

// 3. 订阅响应
client.generate(request).listen((answer) {
    image = answer.artifacts?.first.getImage();
});

示例

Brush AI

狗

生成一张狗的油画，逼真，由列奥纳多·达芬奇绘制。

输出 1	输出 2	输出 3

猫

生成一张猫的油画，逼真，由列奥纳多·达芬奇绘制。

输出 1	输出 2	输出 3

赛博朋克

生成一张日本风格的赛博朋克场景，夜晚的真实街道。

输出 1	输出 2	输出 3

功能

• ✅ 文本到图像

即将推出的功能：

• ❌ 图像到图像
• ❌ 涂抹 + 掩模
• ❌ CLIP 引导
• ❌ 多提示

连接

在 Twitter 上与我联系。

许可证

该库采用 BSD 3-Clause 许可证。

示例代码

以下是一个完整的 Flutter 示例代码，展示了如何使用 stability_sdk 插件生成图像。

import 'package:flutter/material.dart';
import 'package:stability_sdk/stability_sdk.dart';

class SingleImagePage extends StatefulWidget {
  const SingleImagePage({super.key});

  [@override](/user/override)
  State<SingleImagePage> createState() => _SingleImagePageState();
}

class _SingleImagePageState extends State<SingleImagePage> {
  late StabilityApiClient client;
  late TextEditingController queryController;
  String? image;
  late bool hasInput;
  late bool isLoading;

  [@override](/user/override)
  void initState() {
    hasInput = false;
    isLoading = false;
    // 初始化客户端并设置 API 密钥
    client = StabilityApiClient.init(dotenv.get('STABILITY_API_KEY'));
    queryController = TextEditingController();
    queryController.addListener(() {
      if (queryController.text != null && queryController.text.isNotEmpty) {
        setState(() {
          hasInput = true;
        });
      } else {
        setState(() {
          hasInput = false;
        });
      }
    });

    super.initState();
  }

  Future<void> generateImage(String prompt) async {
    setState(() {
      isLoading = true;
      image = null;
    });

    // 创建生成请求
    final request = RequestBuilder(prompt)
        .setHeight(512)
        .setWidth(512)
        .setEngineType(EngineType.inpainting_v2_0)
        .setSampleCount(1)
        .build();

    // 订阅响应
    client.generate(request).listen((answer) {
      if (answer.artifacts?.isNotEmpty == true) {
        setState(() {
          image = answer.artifacts?.first.getImage();
          isLoading = false;
        });
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('生成图像'),
      ),
      body: Center(
        child: Padding(
          padding: const EdgeInsets.all(16),
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              // 显示生成的图像
              if (image != null && !isLoading)
                CachedMemoryImage(
                  base64: image!,
                  uniqueKey: image!.toString(),
                ),
              // 显示加载指示器
              if (isLoading) const CircularProgressIndicator(),
              const SizedBox(height: 32),
              // 输入框
              TextField(
                controller: queryController,
              ),
              const SizedBox(height: 32),
              // 生成按钮
              ElevatedButton(
                onPressed: hasInput
                    ? () {
                        generateImage(queryController.text);
                      }
                    : null,
                child: const Text('生成'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}