Proyecta AI Gateway

Thêm tính năng AI vào app đã publish — chatbot, tạo nội dung, tóm tắt. Tương thích OpenAI. Không cần API key của bên thứ ba.

Proyecta AI Gateway cho phép các app bạn xây dựng gọi đến các LLM hàng đầu mà không cần tạo tài khoản với từng nhà cung cấp, quản lý API key của họ, hay tự trả chi phí trước. Gateway tương thích với OpenAI — chỉ cần trỏ OpenAI SDK vào gateway là xong. Hiện tại, chỉ có các model Anthropic Claude khả dụng qua gateway. Hỗ trợ OpenAI, Google và Groq đang trong lộ trình phát triển.

Tôi có thể xây dựng gì với nó?

• Chatbot — hỗ trợ khách hàng, AI coaching, bot FAQ
• Tạo nội dung — mô tả, email, bản tóm tắt, bản nháp
• Phân tích — trích xuất thông tin từ văn bản, phân loại dữ liệu, phân hạng
• Tóm tắt — rút gọn tài liệu, bài viết, bản ghi
• Cá nhân hóa — gợi ý, UI thích ứng

Quickstart

Trong app được xây dựng bằng Proyecta, bạn có thể gọi gateway trực tiếp từ các trang với hook useAI() — không cần xử lý key, không cần 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>
    );
}

Để có cuộc hội thoại qua lại, hãy dùng useChat() thay thế — hook này tự động lưu lịch sử tin nhắn cho bạn.

Hai điều cần lưu ý, vì một người dùng ẩn danh sẽ tiêu credit của bạn: hãy giới hạn phạm vi prompt (đừng stream cả một bộ sưu tập vào system), và đừng gọi completion mỗi khi người dùng gõ phím.

Nhờ AI builder wire it up: "Add a chatbot to my app. The user types a question and gets a streaming response."

Từ backend của riêng bạn

Gateway sử dụng giao thức OpenAI Chat Completions, vì vậy từ một server bạn tự quản lý, bạn có thể trỏ OpenAI SDK chính thức vào đó — chỉ cần thay đổi hai thứ: baseURL và key:

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 hoạt động giống như với bất kỳ client tương thích OpenAI nào:

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 ?? '');
}

Các model

Các model sau đây khả dụng qua gateway:

Nhà cung cấp	Các model được hỗ trợ
Anthropic	claude-sonnet-5 (flagship), claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-opus-5, claude-opus-4-8, claude-opus-4-7

Truyền trực tiếp model ID, ví dụ: claude-sonnet-5, claude-haiku-4-5-20251001. Các yêu cầu dùng model ngoài danh sách này sẽ bị từ chối. Các nhà cung cấp bổ sung đang trong lộ trình phát triển.

API key, giới hạn tốc độ và ngân sách

Proyecta tự động cấp một PROYECTA_API_KEY cho runtime của bạn. Trong trường hợp thông thường, bạn không cần tự tạo key thủ công.

Chủ sở hữu tổ chức có thể xem mức sử dụng AI credit — chi tiêu trong kỳ hiện tại và hạn mức ngân sách của gói. Đây là thứ cung cấp dữ liệu cho chỉ số credit trong builder.

Tính phí như thế nào?

Việc sử dụng AI Gateway được theo dõi riêng biệt với các credit mà AI builder tiêu thụ khi chỉnh sửa app của bạn. Chi phí mỗi yêu cầu là mức giá của nhà cung cấp cơ bản, áp dụng vào số dư AI credit của tổ chức bạn.

Câu hỏi thường gặp

AI Gateway khác gì so với AI builder?

AI builder là agent viết code trong panel chat. AI Gateway là thứ app đã publish của bạn gọi đến khi người dùng của app muốn dùng tính năng AI.

Tôi có thể dùng key của nhà cung cấp riêng không?

Được — nhờ AI xóa các lời gọi gateway và cấu hình tích hợp trực tiếp với key của riêng bạn trong Environment Variables. Bạn sẽ mất tính năng thanh toán thống nhất và pool giới hạn tốc độ chung.

Tôi có thể dùng nó để tạo ảnh hay giọng nói không?

Chưa. Hiện tại gateway chỉ xử lý văn bản đầu vào và đầu ra. Các modality ảnh, giọng nói và video đang trong lộ trình phát triển. Để tạo ảnh, xem Image Generation.

Tôi xem mức sử dụng ở đâu?

Mức sử dụng credit hiển thị ở cấp tổ chức trong trang Settings (chi tiêu trong kỳ hiện tại và hạn mức ngân sách). Một panel AI Gateway chuyên dụng trong builder — với key theo từng app và biểu đồ sử dụng trực tiếp — đang trong lộ trình phát triển.

Sắp ra mắt

• Panel Builder cho AI Gateway — tạo key theo từng app, thiết lập danh sách model được phép, theo dõi chi tiêu trực tiếp và quản lý key mà không cần rời khỏi builder
• Modality ảnh và giọng nói — text-to-image, text-to-speech, speech-to-text
• Phân bổ mức sử dụng theo từng runtime — xem app nào trong tổ chức của bạn đang tiêu bao nhiêu