Proyecta AI Gateway

为你发布的应用添加 AI 功能——聊天机器人、内容生成、摘要提取。兼容 OpenAI。无需第三方 API 密钥。

Proyecta AI Gateway 让你构建的应用可以直接调用前沿大语言模型，无需向各个提供商注册账号、管理 API 密钥或预付费用。它兼容 OpenAI 协议——将 OpenAI SDK 指向 gateway 即可完成接入。目前，gateway 仅支持 Anthropic Claude 系列模型。OpenAI、Google 和 Groq 的支持已在规划中。

我能用它构建什么？

聊天机器人 — 客服支持、AI 辅导、FAQ 机器人
内容生成 — 描述文案、邮件、摘要、草稿
分析 — 从文本中提取洞察、数据分类、内容分类
摘要提取 — 压缩文档、文章、转录内容
个性化 — 推荐系统、自适应 UI

快速开始

在 Proyecta 构建的应用中，你可以通过 useAI() hook 直接在页面中调用 gateway——无需处理密钥，也无需 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 builder 帮你接入："Add a chatbot to my app. The user types a question and gets a streaming response."

从你自己的 backend 调用

gateway 遵循 OpenAI Chat Completions 协议，因此在你自己控制的服务器上，可以将官方 OpenAI SDK 指向它——只需修改两处：baseURL 和密钥：

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: …' }],
});

Streaming

Streaming 的用法与任何兼容 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 ?? '');
}

模型

以下模型可通过 gateway 使用：

提供商	支持的模型
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 积分用量——当前周期的消耗和套餐的预算上限。这也是 builder 中积分指示器的数据来源。

如何计费？

AI Gateway 的用量与 AI builder 编辑应用时消耗的积分分开计算。每次请求的费用按底层提供商的费率计算，从你的组织 AI 积分余额中扣除。

常见问题

AI Gateway 和 AI builder 有什么区别？

AI builder 是在聊天面板中编写代码的智能体。AI Gateway 是你发布的应用在其用户需要 AI 功能时所调用的服务。

我可以使用自己的提供商密钥吗？

可以——让 AI 移除 gateway 调用，并在环境变量中配置使用你自己密钥的直连集成。这样你将失去统一计费和共享速率限制池的便利。

我可以用它生成图像或语音吗？

目前还不支持。gateway 目前仅支持文本输入/文本输出。图像、语音和视频模态已在规划中。关于图像生成，请参阅图像生成。

在哪里可以查看用量？

积分用量可在 Settings 页面的组织级别查看（当前周期消耗和预算上限）。builder 内专属的 AI Gateway 面板——支持按应用创建密钥并查看实时用量图表——已在规划中。

即将推出

AI Gateway 的 Builder 面板 — 创建按应用独立的密钥、设置模型白名单、监控实时消耗，以及全程在 builder 内管理密钥
图像与语音模态 — 文本转图像、文本转语音、语音转文本
按运行时归因用量 — 查看组织内各应用的积分消耗情况