Synthetic の動作方法
Synthetic は、専用インフラでオープンソースコーディング LLM を実行し、OpenAI 互換(および Anthropic 互換)API を通じて提供するサブスクリプションサービスです。トークンごとの支払いではなく、定額月額サブスクリプションを支払い、プラットフォーム上のすべてのモデルをカバーする充実したレート制限バジェットが付きます。 コーディングを多く行う開発者向けに、Claude の 200/月 プランの直接代替として位置づけられています:同じ価格帯、数倍高いレート制限、そしてオープンソースモデルの選択肢があります。 Kodus は OpenAI 互換エンドポイントを通じて Synthetic に到達するため、アダプターの変更は不要です — BYOK クレデンシャルだけです。プランの概要
価格とレート制限は変更されます。ティアを選択する前に、synthetic.new/pricing で必ず確認してください。
サブスクリプション(コードレビューに推奨)
- すべての標準モデルはサブスクリプションの対象です —
modelフィールドを変更することで任意のモデルを選択できます。 - レート制限は月単位ではなく、5時間ローリングウィンドウで適用されます — そのウィンドウに収まるよう同時実行数を計画してください。
- Synthetic はプロンプト/完了データのトレーニングを行わず、14日以内に API データを削除します。
推奨モデル
Synthetic は HuggingFace スタイルのプレフィックス(hf:org/model)を使用してモデルを公開しています。コードレビューに強い選択肢:
完全なカタログは dev.synthetic.new/docs/openai/models で確認できます。
APIキーの作成
- synthetic.new にアクセスしてサインアップまたはログインします。
- synthetic.new/pricing でプランにサブスクライブします。
- 開発者コンソールを開いて APIキーを作成します。キーをすぐにコピーします — 完全なキーを再度見ることはできません。
Kodus で Synthetic を設定する
主なフローは Kodus Cloud での BYOK です。セルフホストインストールでは、第2のオプションとして環境変数を使用できます。オプション1 — Kodus Cloud での BYOK(推奨)
- Kodus ウェブ UI で、設定 → BYOK を開きます(app.kodus.io/organization/byok)。
-
Synthetic はキュレートされたカタログにはありません — モデルリストの下部にある Configure manually をクリックします。メインモデルの代わりにフォールバックを設定する場合は URL に
?slot=fallbackを使用します。 -
ウィザードを入力します:
- Test & save をクリックします。Kodus はエンドポイントをプローブし、成功時に設定を保存します。401 はキーが間違っていることを意味し、404 は通常ベース URL またはモデルパスが間違っていることを意味します。
Synthetic をメインとして設定し、OpenAI または Anthropic キーをフォールバックとして保持します — 5時間ウィンドウが一杯になったとき、Kodus は自動的にフェイルオーバーしてレビューが継続されます。
オプション2 — セルフホスト(環境変数)
固定モード(単一グローバルプロバイダー、組織ごとの BYOK なし)で Kodus を実行している場合は、API とワーカーコンテナの.env で Synthetic を設定します:
このパスは意図的に BYOK を無効にしているセルフホスト Kodus インストールにのみ必要です。セルフホストインスタンスで BYOK が有効な場合は、オプション1を優先してください — UI ベースのフローはクラウドと同じです。
.env を編集後、API とワーカーコンテナを再起動して確認します:
Synthetic を選ぶ場合
- 主要モデルがオープンソース(Kimi、DeepSeek、Qwen Coder、GLM)で、プロバイダーごとのトークン費用を管理する代わりに単一の定額請求を希望する場合。
- **Claude Max(30/月の Synthetic は同等のコーディングモデルに対して数倍のレート制限バジェットを提供します。
- 強力なデータ体制が必要な場合 — Synthetic はトレーニングなしと14日間のプロンプト/完了保持を明示しています。
トラブルシューティング
5時間ウィンドウ内での 429 Too Many Requests
5時間ウィンドウ内での 429 Too Many Requests
- サブスクリプションバジェットは1時間や月ごとではなく、5時間ローリングウィンドウごとです。Synthetic ダッシュボードで最近送信したリクエスト数を確認します。
- ウィンドウのロールフォワードを待つか、BYOK で
Max Concurrent Requestsを下げるか、プランをアップグレード/追加します。 - レート制限中もレビューが継続されるよう
FallbackBYOK プロバイダーを設定します。
401 / 認証エラー
401 / 認証エラー
- Synthetic ダッシュボードでキーがアクティブでサブスクリプションが最新であることを確認します。
.envの値に末尾のスペースや引用符がないことを確認します。
モデルが見つからない
モデルが見つからない
- Synthetic は
hf:org/model形式を使用します。hf:プレフィックスを省略したり異なる大文字小文字を使用すると 404 になります。 - dev.synthetic.new/docs/openai/models でクロスチェックします。
最初の呼び出しで長いコールドスタート
最初の呼び出しで長いコールドスタート
- 一部の大きなモデルは、非アクティブ期間後に最初に使用されるときにコールドスタートする場合があります。
- 最初の呼び出しのレイテンシが Kodus のヘルスチェックをブロックしている場合は、PR を開く前に小さなテストリクエストを発行してモデルをウォームアップします。
接続エラー
接続エラー
- サーバーが
api.synthetic.newに到達できることを確認します。 - API とワーカーのログで正確な上流エラーを確認します。