软件工程课程个人作业（一）

这个作业属于哪个课程	202601 软件工程
这个作业要求在哪里	2026秋软件工程个人作业（第一次） - 作业 - 202601 软件工程 - 班级博客 - 博客园
这个作业的目标	1. 掌握 Hugging Face API 工程化调用并结合前端实现交互式图像生成 2. 搭建规范且美观的 GitHub 个人主页并制定三年规划 3. 梳理个人技能树与代码量，完成严谨自我评估 4. 让AI 生成的软工学习指南，对其进行批判性审视
学号	102401609

软件工程第一次个人作业：AI工程实践、技能树梳理与自我规划

一、Hugging Face API 的工程化调用与前端交互生成

1.1 API调用成功的记录以及前端页面最终生成图像的截图

提示词设计思路

我想到了此时此刻我正在做软工作业，于是设计了这个提示词：A Chinese college student, at night, using a laptop under a desk lamp to do software engineering homework, with the laptop on the desk, seen from a side view. 我想如果没有说侧面视角的话可能会把重点放到电脑屏幕上，易生成乱码，我也试了以下，但是并没有如我所想那样，而是生成了以下这张图：

修改过程

第一次生成的图存在以下问题：台灯直射眼睛、背景空间感过假，于是我把图和提示词还有存在的问题给了AI，让它帮我优化一下提示词解决这两个问题，最终提示词为：A candid side view of a young Chinese male college student wearing glasses and a grey hoodie, typing on a laptop on his desk at night, a desk lamp angled downward illuminating only the keyboard and desk surface without blinding his eyes, subtle realistic screen glow on his face, background shows a dimly lit room with soft spatial depth and faint city night lights outside a blurred window, clean composition, authentic documentary photography, natural skin texture 生成图片：

以上两个问题是解决了，但是在皮肤和手部细节上我觉得不如最开始那张图，我原打算再试一次，但是调用次数达到上限了

1.2 API调用的操作步骤

一开始我让Gemini帮我生成了套初版代码，但是填入Access Token后并没有调用成功，再修改了一版后还是没有成功，具体报错是什么记不得了，我就自己先尝试python代码直接调用，用了平台示例代码：

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    provider="fal-ai",
    api_key=os.environ["HF_TOKEN"],
)

# output is a PIL.Image object
image = client.text_to_image(
    "Astronaut riding a horse",
    model="XLabs-AI/flux-RealismLora",
)

HF_TOKEN这个放在了.env文件里，第一次调用后什么都没有，我还以为出了什么问题，第二次调用报错402，原因是第三方免费额度用完了，我求助了Trae里的AI后，建议我换成black-forest-labs/FLUX.1-schnell（FLUX 快速版，HF 免费推理支持）这个模型，并帮我把代码改为：

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    api_key=os.environ["HF_TOKEN"],
)

# output is a PIL.Image object
image = client.text_to_image(
    "Astronaut riding a horse",
    model="black-forest-labs/FLUX.1-schnell",
)

执行了一次又没有看到图片，我才发现，和第一次调用时问题一样，都是无输出无报错，原来是图片没保存，补上了image.save("output.png")后成功生成了图片，最后把这份成功调用的代码给Gemini让它重新修改代码，并让它根据我的要求去掉了前端的一些冗余项，最终得到了API调用成功的记录以及前端页面最终生成图像的截图

1.3 API 调用时的体验和心得

之前调用 API 时，我都是直接把 base_url、api_key 和 API 文档一股脑丢给 AI，让它直接生成代码。但这次是我第一次亲手通过代码调用 API，虽然过程中也请 AI 帮我解决了一些问题。我并没有从一开始调用失败后，让它反复修改几次，那样多半也能调通，可我就没法知道到底哪里容易出问题了。只有亲自踩过这些坑，以后遇到类似情况，我才能直接让 AI 去排查是不是同样的问题，这样它也能更快地帮我解决。