使用 Node.js 上传文件到 Replicate API 的正确方法

本文档旨在指导开发者如何使用 Node.js 正确地将文件上传到 Replicate API。Replicate API 期望文件输入采用 Base64 编码的 Data URI 格式。本文将提供详细的代码示例，展示如何读取本地文件，将其转换为 Base64 编码的 Data URI，并将其作为输入传递给 Replicate API。通过本文，开发者可以避免常见的 “Unprocessable Entity” 错误，并成功地与 Replicate API 进行交互。

将文件上传到 Replicate API

Replicate API 要求文件以 Base64 编码的 Data URI 格式进行上传。直接传递文件路径或使用 fs.readFile 读取的 Buffer 对象通常会导致 “Unprocessable Entity” 错误。以下步骤展示了如何正确地将文件转换为 Replicate API 可接受的格式。

步骤 1：安装必要的依赖

确保你已经安装了 replicate 和 dotenv 两个 npm 包。如果没有，可以使用以下命令安装：

npm install replicate dotenv

步骤 2：读取文件并转换为 Base64 Data URI

使用 Node.js 的 fs 模块读取文件，然后将其转换为 Base64 编码的 Data URI。以下代码展示了如何实现：

import Replicate from "replicate";
import dotenv from "dotenv";
import { promises as fs } from "fs";
dotenv.config();
async function convertImageToBase64(imagePath) {
try {
const data = await fs.readFile(imagePath);
const base64 = data.toString("base64");
const mimeType = "image/jpg"; // 根据你的文件类型修改 MIME 类型
const dataURI = `data:${mimeType};base64,${base64}`;
return dataURI;
} catch (error) {
console.error("Error converting image to base64:", error);
throw error;
}
}
async function convertAudioToBase64(audioPath) {
try {
const data = await fs.readFile(audioPath);
const base64 = data.toString("base64");
const mimeType = "audio/mp3"; // 根据你的文件类型修改 MIME 类型
const dataURI = `data:${mimeType};base64,${base64}`;
return dataURI;
} catch (error) {
console.error("Error converting audio to base64:", error);
throw error;
}
}

步骤 3：调用 Replicate API

Clay AI

Clay AI 是一款可以将人物照片转换为粘土风格图像的AI工具，Clay AI：利用粘土动画让角色栩栩如生

131

查看详情

现在，你可以使用转换后的 Data URI 作为输入来调用 Replicate API。

async function getVideo(inputImage, inputAudio) {
const replicate = new Replicate({
auth: process.env.REPLICATE_API_TOKEN,
});
try {
const output = await replicate.run(
"cjwbw/sadtalker:3aa3dac9353cc4d6bd62a8f95957bd844003b401ca4e4a9b33baa574c549d376",
{
input: {
source_image: inputImage,
driven_audio: inputAudio,
},
}
);
console.log(output);
} catch (error) {
console.error("Error calling replicate API:", error);
}
}
async function main() {
try {
const imageBase64 = await convertImageToBase64("./deepfakeImage.jpg");
const audioBase64 = await convertAudioToBase64("./deepfakeAudio.mp3");
await getVideo(imageBase64, audioBase64);
} catch (error) {
console.error("An error occurred:", error);
}
}
main();

完整代码示例

import Replicate from "replicate";
import dotenv from "dotenv";
import { promises as fs } from "fs";
dotenv.config();
async function convertImageToBase64(imagePath) {
try {
const data = await fs.readFile(imagePath);
const base64 = data.toString("base64");
const mimeType = "image/jpg"; // 根据你的文件类型修改 MIME 类型
const dataURI = `data:${mimeType};base64,${base64}`;
return dataURI;
} catch (error) {
console.error("Error converting image to base64:", error);
throw error;
}
}
async function convertAudioToBase64(audioPath) {
try {
const data = await fs.readFile(audioPath);
const base64 = data.toString("base64");
const mimeType = "audio/mp3"; // 根据你的文件类型修改 MIME 类型
const dataURI = `data:${mimeType};base64,${base64}`;
return dataURI;
} catch (error) {
console.error("Error converting audio to base64:", error);
throw error;
}
}
async function getVideo(inputImage, inputAudio) {
const replicate = new Replicate({
auth: process.env.REPLICATE_API_TOKEN,
});
try {
const output = await replicate.run(
"cjwbw/sadtalker:3aa3dac9353cc4d6bd62a8f95957bd844003b401ca4e4a9b33baa574c549d376",
{
input: {
source_image: inputImage,
driven_audio: inputAudio,
},
}
);
console.log(output);
} catch (error) {
console.error("Error calling replicate API:", error);
}
}
async function main() {
try {
const imageBase64 = await convertImageToBase64("./deepfakeImage.jpg");
const audioBase64 = await convertAudioToBase64("./deepfakeAudio.mp3");
await getVideo(imageBase64, audioBase64);
} catch (error) {
console.error("An error occurred:", error);
}
}
main();

注意事项：

• MIME 类型： 确保 mimeType 变量与你上传的文件类型匹配。常见的 MIME 类型包括 image/jpeg, image/png, audio/mp3, audio/wav 等。
• 错误处理： 代码中包含了错误处理机制，以便在文件读取或 API 调用失败时能够及时发现问题。
• 异步操作： 使用 async/await 处理异步操作，使代码更易于阅读和维护。
• API 密钥： 确保你的 Replicate API 密钥已正确设置在 .env 文件中。

总结：

通过将文件转换为 Base64 编码的 Data URI，你可以成功地将文件上传到 Replicate API，并避免常见的错误。本文提供的代码示例可以作为你开发过程中的参考，并根据你的实际需求进行修改和扩展。请务必注意文件类型与 MIME 类型的匹配，并妥善处理错误，以确保程序的稳定性和可靠性。