小白入门:前端前端调用 AI 接口全流程(附具体案例)

很多前端新手在调用 AI 接口时会犯怵:不知道 “怎么怎么传参数?”“流式响应怎么处理?”“不同功能(润色 / 扩写)调用方式不一样吗?”

其实很简单!本文以 “智能文本处理工具” 为例,手把手教你从 0 到 1 调用 AI 接口,包含润色、扩写等功能,看完就能上手。


准备工作:先看懂这 3 个核心文件

在开始前,我们需要明确项目中 3 个关键文件的作用(这些文件你可能已经有了,只是不知道怎么用):

  • vite.config.js:配置后端接口代理,解决跨域问题
  • apiClient.js:封装好的 HTTP 请求工具,帮你发请求
  • aiService.js:封装好的 AI 功能函数(润色 / 扩写等)
配置文件(vite.config.js)

这个文件告诉前端:" 调用 /writer_api 开头的接口时,自动转发到后端服务器 "。

// vite.config.js exportdefaultdefineConfig({ server:{ proxy:{// AI功能接口代理(润色/扩写等) '/writer_api':{ target:'http://192.168.0.1:3000',// 后端服务器地址  changeOrigin:true,// 解决跨域 rewrite:path=> path.replace(/^\/writer_api/,'')// 去掉前缀 }}}});
请求工具(apiClient.js)

这个文件封装了发送请求的逻辑,你不用关心 fetchaxios 的细节,直接调用即可。

// apiClient.js classHttpClient{asyncpost(url, data){returnfetch(url,{ method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(data)});}}exportdefaultnewHttpClient();
AI 功能封装(aiService.js)

这里已经帮你写好了调用各种 AI 功能的函数,直接用就行!

// aiService.js import apiClient from'./apiClient.js';// 润色功能 exportconstpolishText=async(text, style)=>{return apiClient.post('/writer_api/generate/',{ writing_mode:`润色${style}`, text: text });};// 扩写功能 exportconstexpandText=async(text)=>{return apiClient.post('/writer_api/generate/',{ writing_mode:'扩写', text: text });};// 处理流式响应(AI逐字返回结果时用) exportconstreadStreamResponse=async(response, onUpdate)=>{const reader = response.body.getReader();const decoder =newTextDecoder();let result ='';while(true){const{ done, value }=await reader.read();if(done)break; result += decoder.decode(value);onUpdate(result);// 实时更新结果 }return result;};

实战案例:做一个 AI 文本处理工具

我们来做一个简单的页面,包含:

  • 输入框(用户输入文本)
  • 功能按钮(润色 / 扩写)
  • 结果展示区(显示 AI 处理后的内容)
页面结构(Vue 组件为例)

先写好 HTML 结构,让用户能输入文本、选择功能、看到结果。

<template> <div> <!-- 输入区域 --> <textarea v-model="userText" placeholder="请输入需要处理的文本..." ></textarea> <!-- 功能按钮 --> <div> <button @click="handlePolish">润色</button> <button @click="handleExpand">扩写</button> </div> <!-- 结果展示 --> <div> <h3>处理结果:</h3> <p>{{ resultText }}</p> </div> </div> </template> 
核心逻辑:调用 AI 接口

重点看 JavaScript 部分,这是调用接口的核心代码。

<script setup> import { ref } from 'vue'; // 导入AI功能函数 import { polishText, expandText, readStreamResponse } from './aiService.js'; // 定义变量 const userText = ref(''); // 用户输入的文本 const resultText = ref(''); // AI返回的结果 // 1. 调用润色功能 const handlePolish = async () => { // 先检查用户有没有输入内容 if (!userText.value) { alert('请输入文本!'); return; } try { // 调用润色接口,传入文本和风格(这里固定用"更正式") const response = await polishText(userText.value, '更正式'); // 处理AI的流式响应(实时更新结果) await readStreamResponse(response, (partialResult) => { resultText.value = partialResult; // 实时显示到页面 }); } catch (error) { alert('润色失败,请重试!'); console.error(error); } }; // 2. 调用扩写功能(和润色几乎一样) const handleExpand = async () => { if (!userText.value) { alert('请输入文本!'); return; } try { // 调用扩写接口,只需要传入文本 const response = await expandText(userText.value); // 同样用流式响应处理结果 await readStreamResponse(response, (partialResult) => { resultText.value = partialResult; }); } catch (error) { alert('扩写失败,请重试!'); } }; </script> 
样式美化(可选)

加一点 CSS 让页面好看点:

<style scoped> .ai-tool { max-width: 800px; margin: 20px auto; padding: 20px; } textarea { width: 100%; height: 150px; padding: 10px; margin-bottom: 10px; } .buttons { margin-bottom: 20px; } button { margin-right: 10px; padding: 8px 16px; cursor: pointer; } .result { padding: 10px; border: 1px solid #eee; } </style> 

关键步骤总结

不管调用哪种 AI 功能,步骤都是固定的:

  1. 获取用户输入:从输入框拿到 userText
  2. 调用对应函数
    • 润色用 polishText(文本, 风格)
    • 扩写用 expandText(文本)
  3. 处理流式响应:用 readStreamResponse 实时显示结果
  4. 错误处理:用 try/catch 捕获异常,提示用户

常见问题解答

Q:为什么要处理流式响应?
A:AI 生成内容时是逐字返回的(比如 “你好→你好,→你好,我是→…”),流式处理能让用户实时看到结果,体验更好。

Q:想加翻译功能怎么办?
A:在 aiService.js 里加一个 translateText 函数,然后在页面加个按钮调用它,逻辑和扩写完全一样。

Q:后端接口地址变了怎么办?
A:只需要改 vite.config.js 里的 target 地址,不用改业务代码。

通过这个例子,你应该能明白:调用 AI 接口其实就是 “传参数→等结果→显示结果” 这三步。不管是润色、扩写还是其他功能,都是同样的套路,换个函数名就行~

如果还有疑问,欢迎在评论区留言!

Read more

前端国际化实现方案:让你的应用走向全球

前端国际化实现方案:让你的应用走向全球 毒舌时刻 国际化?听起来就像是前端工程师为了显得自己很专业而特意搞的一套复杂流程。你以为随便加个i18n库就能实现国际化?别做梦了!到时候你会发现,翻译文件比代码还多,维护起来比代码还麻烦。 你以为翻译就是简单的文本替换?别天真了!不同语言的语法结构不同,直接替换会导致语法错误。还有那些所谓的国际化库,看起来高大上,用起来却各种问题。 为什么你需要这个 1. 全球用户:国际化可以让你的应用支持全球用户,扩大用户群体。 2. 用户体验:使用用户的母语可以提高用户体验,增加用户粘性。 3. 市场竞争力:支持多语言的应用在国际市场上更具竞争力。 4. 合规要求:某些国家和地区要求应用提供当地语言支持。 5. 品牌形象:支持多语言可以提升品牌的国际化形象。 反面教材 // 1. 硬编码文本 function Welcome() { return <h1>Welcome to our app!</h1&

HTML前端如何调用大模型?OpenAI接口兼容模式来了

HTML前端如何调用大模型?OpenAI接口兼容模式来了 在当今的Web开发中,越来越多的应用开始集成大语言模型(LLM)能力——从智能客服到内容生成,从前端自动化助手到多模态交互界面。然而,一个现实问题是:前端本身无法直接运行大模型,而传统的API接入方式又往往依赖特定平台、协议不统一、集成复杂。 有没有一种方式,能让纯HTML页面像调用普通HTTP接口一样,轻松“对话”本地或私有部署的大模型? 答案是肯定的——通过 OpenAI接口兼容模式,任何支持fetch的浏览器环境都可以无缝对接开源大模型服务,无需SDK、无需后端代理封装,真正实现“开箱即用”的前端集成体验。 这种模式的核心思想其实很朴素:让非OpenAI的服务,说OpenAI的语言。 换句话说,即便你部署的是Qwen、Llama3或者ChatGLM这类开源模型,只要你的推理服务能接收 /v1/chat/completions 这样的请求路径,并返回与OpenAI格式一致的JSON结构,那么前端代码就可以完全复用现有的调用逻辑,甚至可以直接使用 openai-js 客户端库。 这背后的关键推动力之一,正是像 ms

国产化服务器部署:银河麒麟系统搭建 Web 服务实战

一、前言 在国产化替代浪潮下,政企单位对服务器硬件、操作系统的国产化适配需求日益迫切。银河麒麟操作系统(Kylin OS)作为国内自主研发的主流服务器操作系统,凭借其高安全性、稳定兼容性和完善的国产化生态支持,成为服务器部署的核心选择之一。 Web 服务作为企业数字化转型的基础载体,广泛应用于内部办公系统、业务展示平台、国产化应用发布等场景。本文将聚焦 “银河麒麟服务器版搭建 Web 服务” 的全流程实战,从环境准备、软件安装、配置优化到访问测试,一步步带大家实现国产化服务器的 Web 服务部署,同时规避常见坑点,兼顾实用性与国产化适配特性。 本文适用于银河麒麟服务器版(推荐 Kylin Server V10 SP3),以主流的 Nginx 作为 Web 服务器软件(轻量化、高性能,适配国产化芯片架构),全程提供可直接复制的命令和配置示例,零基础也能快速上手。 二、前期准备 2.1

【魅影AI远程控制】:基于WebRTC+AI的智能远程控制解决方案

【魅影AI远程控制】:基于WebRTC+AI的智能远程控制解决方案

x 魅影AI远程控制:基于WebRTC+AI的智能远程控制解决方案 📖 前言 在移动互联网时代,远程控制技术已经成为企业IT支持、无障碍辅助、智能家居等领域的重要工具。传统的远程控制方案往往需要用户手动操作,效率低下。今天,我将为大家介绍一款革命性的魅影AI远程控制应用,它通过WebRTC实时通信和AI智能识别技术,实现了"语音指令→智能理解→自动执行"的完整闭环,让远程控制变得像对话一样简单。 🎯 项目概述 什么是魅影AI远程控制? 魅影AI远程控制是一款双端合一的Android应用,集成了远程控制、AI语音助手、OCR识别等多项前沿技术。它最大的特点是智能化:用户只需说出需求,AI就能理解意图并自动完成操作。 核心价值 传统远控:手动点击、滑动 → 繁琐、低效 AI远控:语音命令、智能识别、自动执行 → 简单、高效、智能 一句话描述: "说出你的需求,AI帮你完成" -