快速开始

在介绍 OOMOL Studio 的各种概念之前,让我们先使用 OOMOL Studio 开始做一些有意思的事情吧。

获取 NASA 每日天文图片(APOD)

在正式开始前,你可以通过点击这里,先在本地进行尝试。

在这个示例中,我们将使用 OOMOL Studio 获取 NASA 每日天文图片(APOD),并压缩保存到本地。

根据 NASA APOD API 的文档,我们可以使用以下 API 获取每日天文图片:

GET https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY
信息

你可以打开 https://api.nasa.gov/ 网站,并花 30 秒的时间申请一个免费的 API Key。 但是你在不注册的情况下,可以使用 DEMO_KEY,只不过它有一些限制。但是对于这个示例来说,使用 DEMO_KEY 是完全可以的。

在上面的示例图中,我们使用了 context.preview 函数来预览图片,并将图片的描述通过 X AI Grok 3 Mini BetaGemini2 5 Flash 模型进行翻译。你无需单独配置这些 API 和 Key,因为 OOMOL Studio 已经内置了 AI 的 API。

context.preview 是我们内置的函数之一,它可以预览图片、视频、音频、文本等多种类型的文件。这将在后面的章节中详细介绍。

压缩并保存图片

在这个例子中,我们使用了 sharp 库来压缩图片,并将图片保存在了 ~/oomol-storage/apod 目录下。

信息

你可能会发现,在 Save Block 中,我们填写的路径是 /oomol-driver/oomol-storage/apod,而实际保存的路径却是 ~/oomol-storage/apod。 这是因为 OOMOL Studio 在默认情况下不会把当前用户的所有文件或者目录都暴露给 OOMOL Studio 中的虚拟环境中,这主要是为了安全起见。 在以后的章节中,我们会介绍如何将本地指定目录暴露给 OOMOL Studio 中的虚拟环境中。

使用密钥优化

在多次运行后,你可能会发现,请求报错,就像下面这样:

这是错误是因为 NASA 的 DEMO_KEY 有请求限制。你可以通过申请一个免费的 API Key 来解决这个问题。

在 OOMOL Studio 中,我们可以使用 密钥 来存储 API Key。你可以在左侧的菜单中找到 OOMOL 密钥,然后点击 添加密钥 按钮,添加一个新的密钥。如图

然后在 Block 中,添加一个 输入接口,并将类型修改为 密钥,然后选择你刚刚添加的密钥。并将代码中使用的 DEMO_KEY 替换为 ${params.input}接口

信息

在使用密钥时,不用担心将项目分享给其他人时,密钥会泄露。因为 OOMOL Studio 只会在运行时才会将密钥传递给工作流,以确保密钥的安全性。

在本次示例中,我们简单了解了如何请求 APOD、使用 LLM 翻译、使用第三方库去压缩图片、将图片保存到本地、使用密钥来存储 API Key。

作为一次简单的快速开始,我们已经完成了一个完整的工作流。后续章节我们将会介绍更多有趣且实用的 OOMOL Studio 的功能和用法。