如何为Jellyfish添加新的LLM供应商:能力注册表与任务适配器完整清单
如何为Jellyfish添加新的LLM供应商能力注册表与任务适配器完整清单【免费下载链接】JellyfishAn end-to-end production workspace for AI-generated short dramas. From script input to structured storyboarding, consistency management, shot preparation, video generation, and export.项目地址: https://gitcode.com/gh_mirrors/jellyfish9/Jellyfish在Jellyfish这个 AI 短剧生产工作流平台中添加新的LLM 供应商如 OpenAI、火山引擎、阿里百炼遵循一套清晰的双层注册机制能力注册表 任务适配器注册。本文带你完整走一遍流程。为什么要区分两层注册Jellyfish 中供应商相关概念分为两层扩展时通常要同时考虑层级回答的问题实现位置能力注册表系统认识哪些供应商 key、别名、支持哪些模型类别、默认 base URLprovider_registry.py任务执行器注册表某类异步任务图片/视频生成在某个供应商上由哪个工厂函数构造执行器registry.py 核心区别能力表只说明产品层面支持任务表说明Worker 能执行。两层都注册新功能才真正可用。Jellyfish 的资产管理界面示例供应商生成的图片、视频等资产在此统一管理第一层在能力注册表中登记供应商能力规格通过ProviderSpec数据类描述内置供应商的登记入口在 provider_bootstrap.py。以新增 keyacme为例需要补充以下字段key稳定小写 key与任务注册、数据库中的命名约定一致aliases兼容历史名称、中文名、常见拼写如火山引擎的别名包含volc、doubao、bytedancesupported_categories该供应商实际支持的模型类别text/image/videodefault_base_urlUI 创建 Provider 时展示的默认 endpoint纯网关型可留空。注册逻辑在 provider_registry.py 的register_provider中实现key 或别名与已有注册冲突时会直接抛错避免静默覆盖保证注册表数据可靠。第二层注册任务适配器能力表有 key 不代表能跑任务。任务适配器的注册表以(任务类型, 供应商 key)二元组为索引内置注册清单集中在 tasks/bootstrap.py 的TASK_ADAPTER_SPECS中image_generationopenai→ImageGenerationTask._build_openai_implimage_generationvolcengine→ImageGenerationTask._build_volcengine_implvideo_generationopenai→VideoGenerationTask._build_openai_implvideo_generationvolcengine→VideoGenerationTask._build_volcengine_impl新增供应商时对每一种要跑在它上面的任务类型调用一次register_task_adapter即可。工厂未注册时任务分派会在运行时报错这个显式报错反而有助于尽早暴露遗漏。编写具体实现类在 integrations 目录下OpenAI 与火山引擎的 HTTP 适配层按供应商分目录组织openai/images.py、video.py、video_payload.py、image_capabilities.py、video_capabilities.pyvolcengine/与上述同构的适配文件新增供应商acme时的步骤在app/core/integrations/下为acme增加图片/视频 API 适配类httpx 调用与 JSON 映射在 image_generation_tasks.py / video_generation_tasks.py 中增加_build_acme_impl工厂构造 Task 并注入对应 adapter在 bootstrap.py 中把(task_kind, acme)→ 工厂 注册进去。注意ImageGenerationTask/VideoGenerationTask本身只做生命周期管理与轮询节奏不直接拼 httpx 细节与任务输入输出共用的 Pydantic 模型放在app/core/contracts/下避免循环导入。启动顺序与 Base URL 优先级应用启动时由 bootstrap.py 的bootstrap_all_registries()先bootstrap 供应商能力再bootstrap 任务适配器保证解析供应商 key 时注册表已就绪。运行时 Base URL 的解析优先级按类别imageimage_base_urlbase_urlProviderSpec.default_base_urlvideovideo_base_urlbase_urlProviderSpec.default_base_urltextbase_urlProviderSpec.default_base_url该逻辑由 provider_resolver.py 的resolve_effective_base_url实现优先级链清晰且可测试。前端展示与验证清单能力注册表对外只读入口是GET /api/v1/llm/providers/supported可按category过滤供前端展示可选能力与默认值提示路由见 routes/llm.py。Jellyfish 项目工作台界面短剧从剧本输入到分镜、镜头准备、视频生成与导出的一体化流程验证新供应商时建议按官方文档 llm-provider-registration.md 的清单逐项检查✅ 跑 LLM 路由相关测试如 test_llm_api_responses.py 中对providers/supported的断言✅ 跑任务注册测试 test_task_registry.py✅ 适配层可在backend/tests/core/integrations/下补充基于httpx.MockTransport的单测无需真实网络✅ 若暴露了新 API 或响应字段执行pnpm run openapi:update更新前端 generated client。小结为 Jellyfish 添加新 LLM 供应商的核心路径可以概括为一条清单能力注册表在provider_bootstrap.py增加一条ProviderSpeckey、别名、类别、默认 URL任务适配器在tasks/bootstrap.py为每种任务类型注册工厂HTTP 适配层在integrations/下新增供应商目录与实现类验证跑路由与注册表测试必要时更新 OpenAPI 生成物。理解能力表 产品支持、任务表 可执行这一分工你就掌握了 Jellyfish 供应商扩展机制的完整脉络后续接入任何新模型服务商都能按图索骥、快速落地。【免费下载链接】JellyfishAn end-to-end production workspace for AI-generated short dramas. From script input to structured storyboarding, consistency management, shot preparation, video generation, and export.项目地址: https://gitcode.com/gh_mirrors/jellyfish9/Jellyfish创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

51单片机光立方实例:原理、驱动与调试全解析

51单片机光立方实例:原理、驱动与调试全解析

简介:本资源是一套面向电子信息类本科生及嵌入式初学者的毕业设计级光立方实战项目,聚焦51单片机核心控制与三维LED显示系统开发,解决硬件搭建、驱动编程与动态效果实现等典型嵌入式实践难题。压缩包共136个文件,涵盖63张原理图与…

2026/11/22 14:35:54 阅读更多 →
从GRIP到NXOpen:UG二次开发环境配置与错误排查指南

从GRIP到NXOpen:UG二次开发环境配置与错误排查指南

简介:本资源是面向UG/NX二次开发工程师的实战型中文技术资料包,聚焦Grip注册表配置、梅雷.NET API常见错误排查、梅雷定制工具箱使用及NXOpen与Visual Studio 2015集成开发四大核心痛点,适用于机械设计、模具开发等工业领域中需定制菜单、对话…

2026/11/16 4:02:07 阅读更多 →
如何用 Continue 在 VS Code 里把代码补全、对话和 Agent 跑通:一个免费开源 AI 代码助手的完整上手

如何用 Continue 在 VS Code 里把代码补全、对话和 Agent 跑通:一个免费开源 AI 代码助手的完整上手

如何用 Continue 在 VS Code 里把代码补全、对话和 Agent 跑通:一个免费开源 AI 代码助手的完整上手 【免费下载链接】continue open-source coding agent 项目地址: https://gitcode.com/GitHub_Trending/co/continue Continue 是一款免费开源的 AI 代码助手…

2026/11/16 4:02:07 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻