豆包(Doubao)Free API — 增強版

AI/ML

概要

豆包 Free API の「增强版」は、既存の Free API 実装に対して不具合修正と機能拡張を加えた TypeScript ベースのサーバ実装です。主な強化点は「図文(画像+テキスト)によるマルチモーダル対話」の追加、応答の高速ストリーミング、多段(マルチターン)会話の保持、OpenAI API 互換フォーマットの提供、複数 sessionid のローテーション運用など。ゼロコンフィグで動作し、自動クリーンアップ機能も備えるため小〜中規模の自己ホストや開発環境で扱いやすく設計されています。

GitHub

リポジトリの統計情報

  • スター数: 11
  • フォーク数: 1
  • ウォッチャー数: 11
  • コミット数: 13
  • ファイル数: 19
  • メインの言語: TypeScript

主な特徴

  • 図文(画像+テキスト)によるマルチモーダル対話をサポート
  • レスポンスの高速ストリーミング(低遅延な逐次出力)に対応
  • OpenAI API と互換性のあるリクエスト/レスポンス形式を提供
  • 複数セッション(sessionid)をローテーションして利用可能、ゼロコンフィグでデプロイできる設計

技術的なポイント

本リポジトリは TypeScript で実装された軽量な API レイヤーで、フロントエンドや既存の OpenAI クライアントと組み合わせて動作することを想定しています。OpenAI 互換インターフェースを提供することで、既存のコードやクライアントライブラリをほとんど変更せずに差し替えられる点が大きな利点です。ストリーミング出力は(README の記載どおり)高速で連続的なレスポンスをサポートしており、内部的にはチャンク化した HTTP レスポンスや Server-Sent Events(SSE)/WebSocket などの仕組みを用いる設計が一般的です。また、画像を含むマルチモーダル対話を扱うため、リクエストで受け取ったバイナリ/URL 形式の画像を処理し、適切にモデルに渡す橋渡しロジックを持っていることが想定されます。運用面では、複数の sessionid をプールして順次使用するローテーション機能や、自動クリーンアップ(期限切れセッションやキャッシュの削除)機能により、長時間運用時の安定性を向上させています。さらにゼロコンフィグを目指しているため、環境変数での最小限の設定だけで立ち上げられ、Docker イメージ化やコンテナベースのデプロイにも配慮されている点が特徴です。TypeScript による型安全性や開発時の可読性・保守性も高く、ローカルでの試験運用からプロダクションのプロキシ用途まで幅広く使える実装方針です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .dockerignore: file — Docker ビルド時に除外するファイル/フォルダを指定
  • .github: dir — GitHub Actions ワークフローや issue テンプレートなどの CI/CD 設定(あれば)
  • .gitignore: file — Git 管理対象外のファイル指定
  • Dockerfile: file — コンテナイメージ化のための定義。ゼロコンフィグでのデプロイを容易にする
  • LICENSE: file — ライセンス情報(リポジトリに準拠)

…他 14 ファイル

補足(ファイル群の想定される役割):

  • README.md: プロジェクトの使い方・機能説明。今回の抜粋はここからの引用です。
  • package.json / package-lock.json: 依存関係とスクリプト定義。TypeScript ビルドや start スクリプトが定義されている想定。
  • tsconfig.json: TypeScript のコンパイラ設定。ES モジュールやターゲット指定など。
  • src/ ディレクトリ: サーバ本体のソース。エンドポイント定義、マルチモーダル入力処理、セッション管理、ストリーミングレスポンスの実装が入る想定。
  • bin/ または dist/: ビルド後に出力される実行用ファイル群(プロダクション向け)。
  • 設定ファイル(.env.example 等): API キーや sessionid プール、ポート指定、ストリーミング設定などを環境変数で管理するためのテンプレート。

運用面のポイント:

  • コンテナ化(Dockerfile)が用意されているため、Docker Compose や Kubernetes へ容易に組み込める。
  • マルチアカウント(複数 sessionid)対応は、高負荷時の冗長化やクォータ回避に有効だが、各サービスの利用規約に従った管理が必要。
  • 自動クリーンアップ機能はディスクやメモリの肥大化を防ぐ一方で、誤って重要セッションを削除しないよう保持期間・ルールの確認が重要。

まとめ

OpenAI 互換かつマルチモーダル対応のセルフホスト向け API 実装で、開発・試験運用に適した実用度の高いリポジトリです。

リポジトリ情報:

READMEの抜粋:

豆包 Free API - 增强版

🚀 增强版特性:在原版基础上修复问题并新增图文对话功能!

✨ 核心特性

  • 图文对话支持:支持发送图片进行多模态对话(新增)
  • 高速流式输出:实时响应,流畅体验
  • 多轮对话:支持上下文连续对话
  • OpenAI 兼容:完全兼容 OpenAI API 格式
  • 多账号支持:支持多个 sessionid 轮询使用
  • 零配置部署:开箱即用,无需复杂配置
  • 自动清理:自动清理会…