Proyecta AI Gateway

サードパーティのAPIキー不要。OpenAI互換のゲートウェイで、チャットボット・コンテンツ生成・要約などのAI機能を公開済みアプリに追加できます。

Proyecta AI Gatewayを使えば、各プロバイダーへのアカウント作成やAPIキーの管理、コストの立て替えなしに、あなたが作ったアプリからフロンティアLLMを呼び出せます。OpenAI互換なので、OpenAI SDKのbaseURLをゲートウェイに向けるだけで完了です。現在、ゲートウェイ経由で利用できるのはAnthropic Claudeモデルのみです。OpenAI・Google・Groqのサポートはロードマップに含まれています。

何が作れますか？

チャットボット — カスタマーサポート、AIコーチング、FAQボット
コンテンツ生成 — 説明文、メール、要約、下書き
分析 — テキストからのインサイト抽出、データのカテゴリ分類
要約 — ドキュメント・記事・文字起こしの要点整理
パーソナライゼーション — レコメンデーション、アダプティブUI

クイックスタート

Proyectaで作ったアプリでは、useAI() フックを使ってページから直接ゲートウェイを呼び出せます。キーの管理もbackendも不要です。

import { useAI } from '@/hooks/useAI.ts';

function Summarizer({ article }) {
    const { ask, isPending, error } = useAI({ system: 'You summarize articles.' });
    const [summary, setSummary] = useState('');

    return (
        <button
            disabled={isPending}
            onClick={async () => setSummary(await ask(`Summarize in 3 bullets: ${article}`))}
        >
            Summarize
        </button>
    );
}

来訪者と双方向の会話をしたい場合は、代わりに useChat() を使ってください。メッセージ履歴を自動で管理してくれます。

匿名の訪問者があなたのクレジットを消費する点に注意してください。プロンプトは適切な範囲に収め（コレクション全体を system にストリームしないなど）、キーを押すたびに補完をリクエストするような実装は避けましょう。

AIビルダーにこう依頼して自動で組み込むこともできます: "Add a chatbot to my app. The user types a question and gets a streaming response."

自前のbackendから呼び出す

ゲートウェイはOpenAI Chat Completionsプロトコルに対応しているため、自分で管理するサーバーから公式OpenAI SDKをそのまま向け先を変えて使えます。変更は baseURL とキーの2箇所だけです。

import OpenAI from 'openai';

const openai = new OpenAI({
    baseURL: 'https://cloud.proyecta.dev/v1/ai',
    apiKey: process.env.PROYECTA_API_KEY,
});

const response = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: 'Summarize this article in 3 bullet points: …' }],
});

ストリーミング

ストリーミングはOpenAI互換クライアントと同じように動作します。

const stream = await openai.chat.completions.create({
    model: 'claude-haiku-4-5-20251001',
    messages: [{ role: 'user', content: prompt }],
    stream: true,
});

for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

モデル

ゲートウェイ経由で利用できるモデルは以下のとおりです。

プロバイダー	対応モデル
Anthropic	`claude-sonnet-5`（フラッグシップ）、`claude-sonnet-4-6`、`claude-haiku-4-5-20251001`、`claude-opus-5`、`claude-opus-4-8`、`claude-opus-4-7`

モデルIDを直接指定してください（例: claude-sonnet-5、claude-haiku-4-5-20251001）。このリスト外のモデルへのリクエストは拒否されます。追加プロバイダーのサポートはロードマップに含まれています。

APIキー・レート制限・予算

Proyectaはランタイム用の PROYECTA_API_KEY を自動的に発行します。通常のユースケースでは手動で作成する必要はありません。

組織のオーナーはAIクレジットの使用状況（現在の期間の使用額とプランの上限額）を確認できます。これがビルダー内のクレジットインジケーターの元となるデータです。

料金の仕組み

AI Gatewayの使用量は、AIビルダーがアプリのコードを編集する際に消費するクレジットとは別に計測されます。リクエストごとのコストは各プロバイダーの料金に基づいており、組織のAIクレジット残高から差し引かれます。

よくある質問

AI GatewayとAIビルダーの違いは何ですか？

AIビルダーはチャットパネルでコードを書くエージェントです。AI Gatewayは、公開済みアプリの_ユーザー_がAI機能を使う際にアプリ側から呼び出すものです。

自前のプロバイダーキーを使えますか？

可能です。AIにゲートウェイ呼び出しを削除させ、環境変数に自前のキーを設定して直接統合するよう依頼してください。ただし、統合された請求と共有レート制限プールの恩恵は受けられなくなります。

画像や音声の生成に使えますか？

現時点では使えません。ゲートウェイはテキスト入力・テキスト出力のみに対応しています。画像・音声・動画のモダリティはロードマップに含まれています。画像生成については画像生成をご覧ください。

使用状況はどこで確認できますか？

クレジットの使用状況はSettingsページのorganizationレベルで確認できます（現在の期間の使用額と上限額）。アプリごとのキーやリアルタイムの使用状況グラフを含む専用のAI Gatewayパネルは、ビルダー内への追加がロードマップに含まれています。

近日公開予定

AI Gateway用ビルダーパネル — アプリごとのキー作成、モデルの許可リスト設定、リアルタイムの使用状況確認、キー管理をビルダー内で完結
画像・音声モダリティ — テキストから画像、テキストから音声、音声からテキスト
ランタイムごとの使用量アトリビューション — 組織内のどのアプリがどのくらい消費しているかを把握