civitai_api 是一个用于在 Flutter 应用中集成 Civitai API 的插件。Civitai 是一个专注于 AI 生成艺术的平台，提供了丰富的 API 接口，允许开发者访问和操作平台上的资源，如模型、图像、用户信息等。

以下是如何在 Flutter 项目中使用 civitai_api 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 civitai_api 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  civitai_api: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化 Civitai API 客户端

在你的 Dart 代码中，首先需要初始化 CivitaiApi 客户端。你可以通过提供 API 密钥来初始化客户端。

import 'package:civitai_api/civitai_api.dart';

final civitaiApi = CivitaiApi(apiKey: 'YOUR_API_KEY');

如果你不需要 API 密钥（例如，只是进行公开数据的读取），你可以不提供 apiKey 参数。

3. 使用 API 方法

civitai_api 提供了多种方法来与 Civitai API 进行交互。以下是一些常见的用法示例：

获取模型列表

void fetchModels() async {
  try {
    final models = await civitaiApi.getModels();
    print(models);
  } catch (e) {
    print('Error fetching models: $e');
  }
}

获取单个模型的详细信息

void fetchModelDetails(int modelId) async {
  try {
    final model = await civitaiApi.getModelById(modelId);
    print(model);
  } catch (e) {
    print('Error fetching model details: $e');
  }
}

获取用户信息

void fetchUserInfo(int userId) async {
  try {
    final user = await civitaiApi.getUserById(userId);
    print(user);
  } catch (e) {
    print('Error fetching user info: $e');
  }
}

上传图像

void uploadImage(File imageFile) async {
  try {
    final response = await civitaiApi.uploadImage(imageFile);
    print(response);
  } catch (e) {
    print('Error uploading image: $e');
  }
}

4. 处理响应

Civitai API 的响应通常是 JSON 格式的数据。你可以使用 Dart 的 jsonDecode 函数来解析这些数据，或者直接使用 civitai_api 提供的模型类来访问数据。

5. 错误处理

在使用 API 时，可能会遇到各种错误，如网络错误、API 限制、认证失败等。确保在你的代码中妥善处理这些错误，以提供更好的用户体验。

6. 示例代码

以下是一个完整的示例，展示如何获取模型列表并在 Flutter 应用中显示它们：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Civitai API Example'),
        ),
        body: ModelList(),
      ),
    );
  }
}

class ModelList extends StatefulWidget {
  [@override](/user/override)
  _ModelListState createState() => _ModelListState();
}

class _ModelListState extends State<ModelList> {
  List<Model> models = [];
  bool isLoading = true;

  [@override](/user/override)
  void initState() {
    super.initState();
    fetchModels();
  }

  void fetchModels() async {
    final civitaiApi = CivitaiApi(apiKey: 'YOUR_API_KEY');
    try {
      final modelList = await civitaiApi.getModels();
      setState(() {
        models = modelList;
        isLoading = false;
      });
    } catch (e) {
      print('Error fetching models: $e');
      setState(() {
        isLoading = false;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return isLoading
        ? Center(child: CircularProgressIndicator())
        : ListView.builder(
            itemCount: models.length,
            itemBuilder: (context, index) {
              final model = models[index];
              return ListTile(
                title: Text(model.name),
                subtitle: Text(model.description),
              );
            },
          );
  }
}