tinyship-ai

用途

TinyShip AI 集成技能用于在 TinyShip 项目中配置 AI 功能。该技能基于 Vercel AI SDK 构建，覆盖 AI 对话、图像生成和视频生成三类能力，并可选地接入积分消耗机制。使用时会先询问用户希望启用哪些能力，再按对应流程进行配置。

主要能力

技能支持以下三类 AI 能力，每类能力对应不同的提供商与配置文件：

AI 对话：提供商包括 Qwen、DeepSeek、OpenAI，配置文件为 config/ai.ts。
图像生成：提供商包括 fal.ai、Gemini、Qwen，配置文件为 config/aiImage.ts。
视频生成：提供商包括 Qwen（DashScope）、火山引擎（Volcengine），配置文件为 config/aiVideo.ts。

使用方式

AI 对话配置

第一步选择提供商。资料给出的对比为：Qwen（推荐）擅长中英文、性价比高、成本低、API Key 来自阿里云 DashScope；DeepSeek 编码能力强、非常便宜、成本极低、API Key 来自 DeepSeek Platform；OpenAI 综合性能最佳、成本高、API Key 来自 OpenAI Platform。

第二步配置环境变量，将所选提供商的 API Key 添加到 .env：

# Default provider selection
AI_PROVIDER="qwen"  # or "deepseek" or "openai"

# Qwen
QWEN_API_KEY="sk-xxxxx"
QWEN_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"

# DeepSeek
DEEPSEEK_API_KEY="sk-xxxxx"

# OpenAI
OPENAI_API_KEY="sk-xxxxx"
OPENAI_BASE_URL=""  # optional: custom gateway URL

第三步验证：启动开发服务器，访问 /ai，发送测试消息，确认流式响应正常工作。

图像生成配置

将所选提供商的 API Key 添加到 .env：

# fal.ai (recommended, supports many models)
FAL_API_KEY="xxxxx"

# Google Gemini
GOOGLE_GENERATIVE_AI_API_KEY="xxxxx"
GOOGLE_GENERATIVE_AI_BASE_URL=""  # optional: custom gateway

# Qwen (reuses QWEN_API_KEY from chat setup)

在 config/aiImage.ts 中配置可用模型，该文件定义哪些模型可用及其默认参数。在 /image-generate 页面验证。

视频生成配置

将所选提供商的 API Key 添加到 .env：

# Qwen/DashScope (reuses QWEN_API_KEY)
# No additional config needed if Qwen chat is already set up

# Volcengine
VOLCENGINE_ACCESS_KEY_ID="xxxxx"
# VOLCENGINE_BASE_URL="https://ark.cn-beijing.volces.com"  # optional

在 config/aiVideo.ts 中配置可用模型。在 /video-generate 页面验证。

积分成本（可选）

若希望 AI 功能消耗积分，可配置 config/credits.ts：

credits: {
  consumptionMode: 'dynamic',
  dynamicChatCostPerKiloToken: 1,
  modelMultipliers: {
    'qwen-turbo': 1.0,
    'qwen-max': 2.0,
    'deepseek-chat': 0.5,
    'gpt-4': 3.0,
    'default': 1.0
  },
  imageGenerationCost: 5,   // credits per image
  videoGenerationCost: 20,  // credits per video
}

需确保积分购买方案已设置（使用 tinyship-payment 技能）。

新增 AI 提供商

完整模式参见 libs/ai/AGENTS.md，摘要如下：

安装 SDK：pnpm add @ai-sdk/new-provider
更新 libs/ai/types.ts 中的类型
在 libs/ai/config.ts 中添加环境变量键映射
在 libs/ai/providers.ts 中实现提供商
将环境变量添加到 env.example

适用场景

适用于在 TinyShip 项目中启用或扩展 AI 对话、图像生成、视频生成能力，以及为这些 AI 功能配置积分消耗与新增 AI 提供商。

限制

资料未提供各提供商的具体价格数值、速率限制、模型完整列表、部署要求或兼容性说明，这些信息暂未提供。