メインコンテンツへスキップ

​
Syntheticの動作方法

Syntheticは、専用インフラでオープンソースコーディングLLMを実行し、OpenAI互換（およびAnthropic互換）APIを通じて提供するサブスクリプションサービスです。トークンごとの支払いではなく、定額月額サブスクリプションを支払い、プラットフォーム上のすべてのモデルをカバーする充実したレート制限バジェットが付きます。 コーディングを多く行う開発者向けに、Claudeの月額20/20/200プランの直接代替として位置づけられています：同じ価格帯、数倍高いレート制限、そしてオープンソースモデルの選択肢があります。 KodusはOpenAI互換エンドポイントを通じてSyntheticに到達するため、アダプターの変更は不要です — BYOKクレデンシャルだけです。

​
プランの概要

価格とレート制限は変更されます。ティアを選択する前に、synthetic.new/pricingで必ず確認してください。

​
サブスクリプション（コードレビューに推奨）

プラン価格レート制限
月額約30/月（30/月（1/日）5時間ウィンドウあたり約500メッセージ
エンタープライズ/使用量ベースSyntheticに問い合わせペイパートークンオプション
  • すべての標準モデルはサブスクリプションで対象です — model フィールドを変更することで任意のモデルを選択できます。
  • レート制限は月単位ではなく、5時間ローリングウィンドウで適用されます — そのウィンドウに収まるよう同時実行数を計画してください。
  • Syntheticはプロンプト/完了データのトレーニングを行わず、14日以内にAPIデータを削除します。

​
推奨モデル

SyntheticはHuggingFaceスタイルのプレフィックス（hf:org/model）を使用してモデルを公開しています。コードレビューに強い選択肢：
モデルID備考
hf:zai-org/GLM-4.6GLMファミリー；汎用レビューにバランスの取れた選択肢。
hf:moonshotai/Kimi-K2-Instruct長コンテキストKimi K2 — 大きなPRに最適。
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct強力な専門コーダー。
hf:deepseek-ai/DeepSeek-V3.1DeepSeek V3.1；強力なエージェント/コーディング動作。
完全なカタログはdev.synthetic.new/docs/openai/modelsで確認できます。

​
APIキーの作成

APIを使用するには、アクティブなサブスクリプションを持つSyntheticアカウントが必要です。
  1. synthetic.newにアクセスしてサインアップまたはログインします。
  2. synthetic.new/pricingでプランにサブスクライブします。
  3. 開発者コンソールを開いてAPIキーを作成します。キーをすぐにコピーします — 完全なキーを再度見ることはできません。

​
KodusでSyntheticを設定する

主なフローはKodus CloudでのBYOKです。セルフホストインストールでは、第2のオプションとして環境変数を使用できます。

​
オプション1 — Kodus CloudでのBYOK（推奨）

  1. Kodusウェブ UIで、設定 → BYOKを開き、メインモデル（またはフォールバック）の編集をクリックします。
  2. ベースURLと自由テキストのモデル名を入力できるよう、フォームをカスタムモードに切り替えます。
  3. フィールドを入力します：
    フィールド値
    プロバイダーOpenAI Compatible
    APIキーSynthetic APIキー
    ベースURLhttps://api.synthetic.new/openai/v1
    モデル例：hf:zai-org/GLM-4.6（hf: プレフィックスと完全なHuggingFaceパスを使用）
    最大同時リクエスト数大きなPRの5時間バジェットに収まるよう3〜5から始める
    最大出力トークン切り捨てが発生しない限りデフォルトのまま
  4. 保存します。Kodusはエンドポイントに対して検証し、401 / 404があれば即座に表示されます。
  5. 任意のPRを開いてレビューをトリガーします；設定のBYOKステータスバッジは最初の成功した呼び出しで緑になります。
500メッセージ/5時間のバジェットはサブスクリプションごとで、PRごとではありません。継続的なレビューを行うチームには、1つの大きなマルチファイルPRがウィンドウを消費しないよう 最大同時リクエスト数 を十分に低く保つか、複数のサブスクリプションに作業を分散させてください。
Syntheticをメインとして設定し、OpenAIまたはAnthropicキーをフォールバックとして保持します — 5時間ウィンドウが一杯になったとき、Kodusは自動的にフェイルオーバーしてレビューが継続されます。

​
オプション2 — セルフホスト（環境変数）

固定モード（単一グローバルプロバイダー、BYOKなし）でKodusを実行している場合は、APIとワーカーコンテナの .env でSyntheticを設定します： 
# Synthetic設定（固定モード）
API_LLM_PROVIDER_MODEL="hf:zai-org/GLM-4.6"                    # カタログの任意のモデルID
API_OPENAI_FORCE_BASE_URL="https://api.synthetic.new/openai/v1"
API_OPEN_AI_API_KEY="your-synthetic-api-key"
このパスは意図的にBYOKを無効にしているセルフホストKodusインストールにのみ必要です。セルフホストインスタンスでBYOKが有効な場合は、オプション1を優先してください — UIベースのフローはクラウドと同じです。
.env を編集後、APIとワーカーコンテナを再起動して確認します： 
docker-compose logs api worker | grep -iE "synthetic|api\.synthetic"
完全なセルフホストセットアップ（ドメイン、セキュリティキー、データベース、Webhook、リバースプロキシ）については、汎用VMデプロイガイドに従い、LLMブロックのみ上記のものと置き換えてください。

​
Syntheticを選ぶ場合

  • 主なモデルがオープンソース（Kimi、DeepSeek、Qwen Coder、GLM）で、プロバイダーごとのトークン費用を管理する代わりに単一の定額請求を希望する場合。
  • **Claude Max（200/月）とレビュースループットを比較している場合∗∗—200/月）とレビュースループットを比較している場合** — 30/月のSyntheticは、同等のコーディングモデルに対して数倍のレート制限バジェットを提供します。
  • 強力なデータ体制が必要な場合 — Syntheticはトレーニングなしと14日間のプロンプト/完了保持を明示しています。
トラフィックがバースト的な場合、またはペイパートークン（Moonshot、Fireworks、Together、Groq）を選択するか、特にGLMファミリーをティア付きコミットで希望する場合は別のサブスクリプション（Z.AI GLMコーディングプラン）を選択してください。

​
トラブルシューティング

  • サブスクリプションバジェットは1時間や月ごとではなく、5時間ローリングウィンドウごとです。Syntheticダッシュボードで最近送信したリクエスト数を確認します。
  • ウィンドウのロールフォワードを待つか、BYOKで 最大同時リクエスト数 を下げるか、プランをアップグレード/追加します。
  • レート制限中もレビューが継続されるよう フォールバック BYOKプロバイダーを設定します。
  • Syntheticダッシュボードでキーがアクティブでサブスクリプションが最新であることを確認します。
  • .env の値に末尾のスペースや引用符がないことを確認します。
  • Syntheticは hf:org/model 形式を使用します。hf: プレフィックスを省略したり異なる大文字小文字を使用すると404になります。
  • dev.synthetic.new/docs/openai/modelsでクロスチェックします。
  • 一部の大きなモデルは、非アクティブ期間後に最初に使用されるときにコールドスタートする場合があります。
  • 最初の呼び出しのレイテンシがKodusのヘルスチェックをブロックしている場合は、PRを開く前に小さなテストリクエストを発行してモデルをウォームアップします。
  • サーバーが api.synthetic.new に到達できることを確認します。
  • APIとワーカーのログで正確な上流エラーを確認します。

​
関連リンク