快速入门 (简体中文)

本指南将帮助您快速开始使用 QwenImageEdit SDK，涵盖了从安装到执行第一个图像编辑操作的步骤。

1. 安装 SDK

您可以使用 npm 或 yarn 将 QwenImageEdit SDK 添加到您的项目中：

npm install @qwen-image-edit/sdk
# 或者
yarn add @qwen-image-edit/sdk

2. 获取 API 密钥

在使用 SDK 之前，您需要从 QwenImageEdit 控制台获取一个 API 密钥。请访问 QwenImageEdit 官方网站注册并获取您的密钥。

重要提示： 请妥善保管您的 API 密钥，不要将其直接暴露在客户端代码中。建议使用环境变量或安全的配置管理方式。

3. 初始化 SDK

使用您的 API 密钥初始化 QwenImageEdit 对象：

import { QwenImageEdit } from '@qwen-image-edit/sdk';

const qwenImageEdit = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY', // 替换为您的实际 API 密钥
  region: 'us-east-1',    // 可选：指定服务区域，例如 'us-west-2', 'eu-central-1'
});

4. 执行您的第一个操作：移除背景

让我们尝试一个简单的图像编辑操作：移除图像背景。这通常用于产品照片或头像处理。

import { QwenImageEdit } from '@qwen-image-edit/sdk';

const qwenImageEdit = new QwenImageEdit({ apiKey: 'YOUR_API_KEY' });

async function removeImageBackground(imageUrl) {
  try {
    console.log(`正在移除图像背景: ${imageUrl}`);
    const result = await qwenImageEdit.image.removeBackground({
      imageUrl: imageUrl,
    });
    console.log('背景移除成功！处理后的图像 URL:', result.outputUrl);
    return result.outputUrl;
  } catch (error) {
    console.error('背景移除失败:', error);
    throw error;
  }
}

// 调用函数并传入一个图像 URL
// removeImageBackground('https://example.com/your-image.jpg')
//   .then(outputUrl => {
//     if (outputUrl) {
//       console.log('您可以在浏览器中查看处理后的图像:', outputUrl);
//     }
//   })
//   .catch(err => {
//     console.error('操作过程中发生错误:', err);
//   });

5. 接下来做什么？

恭喜您！您已经成功执行了第一个 QwenImageEdit SDK 操作。接下来，您可以探索更多功能：

API 参考：了解所有可用的图像编辑方法和参数。
示例：查看更多高级用例和代码示例。
配置指南：深入了解 SDK 的配置选项，包括缓存、代理和日志。
故障排除：获取常见问题和错误解决方案的帮助。

如果您有任何问题或需要帮助，请随时查阅我们的文档或联系支持团队。