【初级五】为原型注入 AI 能力

课程来源Datawhale Easy-Vibe 教程一、API 基础概念API 是计算机领域的一个重要抽象概念我们可以简单理解为你按对方要求的格式发一个问题对方就按同样的格式回一个结果。你发出去的内容通常包括密钥API Key和你要生成什么对方回给你的内容成功就给结果失败会告诉你原因比如密钥不对余额不足参数写错具体来说需要掌握以下核心要素API Key你的通行证也是钱包钥匙。别人拿到它就可以替你调用接口并产生费用。Endpoint接口路径API 请求的具体路径告诉服务器你要访问哪个功能。完整的请求地址通常由基础 URL Endpoint路径构成。例如文本生成基础URL (https://api.service.com) Endpoint (/v1/chat/completions) 完整URLhttps://api.service.com/v1/chat/completions图像生成基础URL (https://api.service.com) Endpoint (/v1/images/generations) 完整URLhttps://api.service.com/v1/images/generations调用/请求向 AI 服务发送任务并获取结果的过程请求内容你发给AI的具体内容比如你想让AI写的文章主题、生成的图片描述等。响应结果AI处理完后返回给你的内容比如生成的文章、图片等。错误处理当出现问题时如API Key错误、请求太频繁等知道如何排查解决。二、接入文本生成 APIDeepSeek首先注册 DeepSeek 账号并创建一个 API Key并且充值少量费用进行验证。三、接入图像转文字 APIQwen3 VL进入 SiliconFlow 平台在 API 密钥中点击「新建 API 密钥」创建一个新的 API Key。基于下面的图生文接口 API 帮我们实现将上传的图片自动生成电商卖点文本、关键词的功能from openai import OpenAIfrom typing import Dict, Any, Listimport base64import osSILICONFLOW_API_KEY: str sk-xxSILICONFLOW_BASE_URL: str https://api.siliconflow.cn/v1/ MODEL_NAME: str Qwen/Qwen3-VL-8B-Instructdef encode_image(image_path: str) - str:with open(image_path, rb) as image_file:return base64.b64encode(image_file.read()).decode(utf-8)def get_vlm_completion(client: OpenAI, messages: List[Dict[str, Any]]) - str:response client.chat.completions.create(modelMODEL_NAME,messagesmessages,max_tokens512,temperature0.7,top_p0.7,frequency_penalty0.5,streamFalse,n1)return response.choices[0].message.contentdef caption_image(image_path: str) - str:base64_image encode_image(image_path)messages [{role: user,content: [{type: text,text: Please describe this image in detail.},{type: image_url,image_url: {url: fdata:image/jpeg;base64,{base64_image}}}]}]client OpenAI(api_keySILICONFLOW_API_KEY,base_urlSILICONFLOW_BASE_URL)return get_vlm_completion(client, messages)image_path images.jpgcaption caption_image(image_path)四、接入图像生成 APISeedream 即梦访问首页页面后点击登录。登录后找到页面右上角的充值选项。进行充值需要实名认证。认证成功后你可以充值 1 元用于测试。返回初始界面并点击 API 访问。请你基于下面 API帮我实现这个工程中电商业务的常见功能例如海报生成、抖音电商首图生成等等curl -X POST https://ark.cn-beijing.volces.com/api/v3/images/generations \-H Content-Type: application/json \-H Authorization: Bearer xxxxxxx \-d {model: doubao-seedream-4-5-251128,prompt: 将图1的服装换为图2的服装,image: [https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png, https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_2.png],sequential_image_generation: disabled,response_format: url,size: 2K,stream: false,watermark: true}五、总结在接入各类 AI 服务时不必把 API 想象得太复杂。把握住以下几个核心概念基本就能应对大多数场景API 的本质是通信桥梁。它做的事情很简单把你的请求发送出去再把模型的响应带回来。你不需要关心背后发生了什么只需要正确地组织请求格式。SDK 是对 API 的封装。如果说 API 是 raw 接口SDK 就是一套现成的工具箱——它把请求签名、错误处理、参数校验这些繁琐的细节都替你做好了。日常开发中优先选择 SDK 而不是直接调 API能省去不少麻烦。阅读文档时盯住三样东西就够了服务地址endpoint、身份凭证API key以及调用参数怎么填。把这三点弄清楚调通只是时间问题。剩下的工作IDE 和现代化的开发工具会帮你完成。专注于你的业务逻辑底层调用的事交给这些成熟的 SDK 和工具链。