想上手豆包的话，看这一篇就够了，避坑点都帮你标出来了。
外卖评价里那句“菜是热的但等了一小时”，到底算口味问题还是配送问题？做本地生活数据的人大概都碰过这种分类难题。美团LongCat-2.5发布后，官方技术博客提到它在商业分析和多模态理解上有针对性优化，API开放平台也同步放出了接入文档。这篇不聊跑分，只把接入路径、能力边界和跟豆包的差别摆清楚。
接入前先弄清两件事
LongCat开放平台的API文档显示，接口走的是OpenAI Responses兼容格式，端点地址为`https://api.longcat.chat/openai/v1/responses`，认证方式是在请求头里放`Bearer YOUR_API_KEY`。也就是说，之前写过OpenAI接口调用的代码，改base URL和key就能跑，不用重写请求结构。
注册流程在`longcat.chat/platform`完成，实名认证后能领到一笔新手Token额度，官方页面标注可用于LongCat-2.0和LongCat-2.5-Preview。拿到Key之后，第一个请求建议用非流式模式验证连通性：body里`model`填`LongCat-2.5-Preview`，`input`直接给一个字符串，`stream`留空或设false。返回对象里`status`为`completed`、`output`数组里有`message`项，就说明链路通了。想省事的话，Vercel AI Gateway也接入了这个模型，模型名写作`meituan/longcat-2.5`，用AI SDK的`streamText`调就行，适合已经在用Vercel那套工具链的人。
结构化输出：外卖评价打标签的可行路径
官方文档里有个容易被忽略的字段：`text.format`。设成`json_schema`并附上name和schema，模型输出会被强约束在指定字段和类型上；设成`json_object`则只保证是合法JSON、不校验字段。对评价摘要这类任务，前者更稳——比如定义一个schema，要求返回`{“taste_tags”: [], “delivery_issue”: bool, “summary”: “”}`，模型就没法用一段散文糊弄过去。
图片输入也支持，`content`数组里放`input_image`类型的块即可，但文档明确写了图片链接必须公网可访问，本地路径传不进去。这意味着拿外卖截图做分析的场景，得先把图传到可访问的存储上。至于摘要准不准、标签能不能落到具体菜品，官方技术博客给的案例是经营数据分析和客户反馈归类，没有公开评价摘要的专项评测数据，实际效果得拿自己的样本跑一批才知道。
多轮约束：文档说支持，边界要自己试
Responses接口的`input`支持消息数组，多轮对话靠把历史消息按`role`回填实现。文档还提到`instructions`字段可以放系统级指令，适合把“预算不超过50、忌口香菜、必须能开发票”这类硬约束固定在会话开头。但要注意，`max_output_tokens`统计的是含推理token在内的总生成量，约束太多、推理拉长时容易提前触顶，返回`status`会变成`incomplete`。
另一个细节：`reasoning.effort`有none到xhigh多档，开启思考时`temperature`会被固定为1.0，传别的值会被覆盖。做需要稳定输出的抽取任务，把effort调低、关掉思考，反而比默认档更可控。这些参数行为在文档里写得很细，接入前花十分钟过一遍，比事后debug省事。
限流和长文本：文档没承诺的部分别赌
公开资料里能查到的硬指标是100万token上下文窗口、最大输出131072 token，来自Vercel AI Gateway的模型页面和OpenCode的模型目录。但限流策略、免费额度的具体消耗规则，官方文档没有给出逐条说明，只在新手资源包处标注了额度可用于哪些模型。拿它跑批量任务之前，先用小样本测一下并发下的报错行为，比照着猜测写重试逻辑靠谱。
长文本截断的判断依据在响应对象里：`status`为`incomplete`就是被`max_output_tokens`截了，不是网络问题。另外工具调用这块，`tools`数组的字段是平铺的，`type`、`name`、`parameters`直接放在工具对象上，套成Chat Completions那种`function`子对象会报`tools[0].name is required`。这个坑文档专门标了，但迁移旧代码时很容易顺手带错。
跟豆包的差别在哪
豆包的优势在中文对话体验和字节系产品内的集成深度，日常问答、写作辅助这类场景开箱即用，不需要碰API。LongCat-2.5的定位偏Agentic任务，官方发布信息里强调的是长程任务、视觉编程、多步骤工具调用，配套的CatPaw平台也是给需要自定义模型接入的用户准备的。价格维度上，Vercel AI Gateway页面显示的LongCat-2.5-Preview输入为每百万token 0.30美元、输出1.20美元，标注为折扣价；豆包的具体计费以火山引擎官方页面为准，两边口径不同，直接比数字意义不大。
选型上可以这么分：只想在对话框里问问题、写东西，豆包够用且省心；要把模型嵌进自己的数据管道、需要JSON schema约束输出、或者要处理图文混合输入，LongCat-2.5的API形态更合适。两者不是替代关系，是使用姿势不同。
FAQ
这玩意儿要收费吗？
API按token计费，Vercel AI Gateway页面标的输入0.30美元/百万token、输出1.20美元/百万token是折扣价，官方注明以LongCat平台实际账单为准。新用户实名后有免费Token额度，OpenCode上曾有LongCat-2.5-Preview的限时免费窗口，但官方没有公布截止日期，别把长期免费当预期。
和豆包怎么选？
看你要不要自己写代码调接口。要接进现有系统、要结构化输出约束、要图文一起喂，选LongCat-2.5；只是日常对话和内容生成，豆包的成品界面更直接。两个都免费试一下再定，比看参数表快。
爱国者aigo翻译机 AI多语种离线翻译机 同声传译拍照翻译
小提示：如果你也想搭建自己的 AI 网站或跑 AI 应用，腾讯云新用户有云服务器特惠，轻量服务器性价比很高，可以点这里看看优惠。