Proyecta AI Gateway

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

Proyecta AI Gateway 让你构建的应用可以直接调用前沿大语言模型，无需为每个提供商单独注册账号、管理 API 密钥或预先垫付费用。它兼容 OpenAI 接口——将 OpenAI SDK 的请求地址指向 gateway 即可完成接入。目前，gateway 仅支持 Anthropic Claude 系列模型，OpenAI、Google 和 Groq 的支持已在路线图中。

我能用它构建什么？

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

快速开始

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

你也可以直接让 AI builder 帮你完成接入："Add a chatbot to my app using the Proyecta AI Gateway. The user types a question and gets a streaming response."

流式输出

流式输出的用法与其他兼容 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-4-6`、`claude-haiku-4-5-20251001`、`claude-opus-4-8`、`claude-opus-4-7`

直接传入模型 ID 即可，例如 claude-haiku-4-5-20251001、claude-sonnet-4-6。更多提供商支持已在路线图中。

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
图片与语音模态 — 文本转图片、文本转语音、语音转文本
按运行时环境归因用量 — 查看组织内各应用的具体消耗情况