tinyship-ai

TinyShip AI 統合

TinyShip の AI 機能を設定するためのガイドです。Vercel AI SDK を基盤としています。

利用可能な機能

機能	プロバイダー	設定ファイル
AI チャット	Qwen、DeepSeek、OpenAI	config/ai.ts
画像生成	fal.ai、Gemini、Qwen	config/aiImage.ts
動画生成	Qwen（DashScope）、Volcengine	config/aiVideo.ts

有効にする機能をユーザーに確認してください。

AI チャットのセットアップ

ステップ 1：プロバイダーを選択

プロバイダー	強み	コスト	API キーの取得先
Qwen（推奨）	中国語・英語に対応、低コスト	低	Aliyun DashScope
DeepSeek	コーディングに強く、非常に低価格	非常に低	DeepSeek Platform
OpenAI	総合的に最高の性能	高	OpenAI Platform

ステップ 2：環境を設定

選択したプロバイダーの API キーを .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

ステップ 3：確認

1. 開発サーバーを起動します
2. /ai に移動します
3. テストメッセージを送信します
4. ストリーミング応答が機能することを確認します

画像生成のセットアップ

選択したプロバイダーの API キーを .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 キーを .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 を参照してください。概要は次のとおりです。

1. SDK をインストールします：pnpm add @ai-sdk/new-provider
2. libs/ai/types.ts の型を更新します
3. libs/ai/config.ts に環境変数キーのマッピングを追加します
4. libs/ai/providers.ts にプロバイダーを実装します
5. env.example に環境変数を追加します

TinyShip リポジトリ内の参考ファイル

• config/ai.ts — チャットプロバイダーの設定
• config/aiImage.ts — 画像生成の設定
• config/aiVideo.ts — 動画生成の設定
• config/credits.ts — AI 機能のクレジットコスト
• libs/ai/AGENTS.md — AI ライブラリのアーキテクチャとプロバイダーの実装パターン
• libs/credits/AGENTS.md — クレジットシステムのアーキテクチャ
• docs/user-guide/ai/chat.md — AI チャットのドキュメント
• docs/user-guide/ai/image.md — 画像生成のドキュメント
• docs/user-guide/ai/video.md — 動画生成のドキュメント