Bắt đầu nhanh

> Bắt đầu với ProxyLLM chỉ trong vài phút. Làm theo các bước sau để thực hiện yêu cầu API đầu tiên.

[INFO]Bạn sẽ cần API key

Bạn cần API key để làm theo hướng dẫn này. Nếu bạn chưa có, tạo tài khoản miễn phí để bắt đầu.

//1 – Lấy API Key của bạn

Sau khi tạo tài khoản, đi đến bảng điều khiển và sao chép API key của bạn. Xuất nó như một biến môi trường để sử dụng trong ứng dụng của bạn.

Terminalbash
export PROXYLLM_API_KEY=your-api-key-here

Để biết các tùy chọn xác thực chi tiết, xem Hướng dẫn Xác thực.

//2 – Chọn API format

Catalog public hiện dùng endpoint OpenAI-compatible. Dùng model ID từ /v1/models.

//3 – Thực hiện Yêu cầu Đầu tiên

Sử dụng ngôn ngữ hoặc công cụ ưa thích của bạn để thực hiện yêu cầu API đầu tiên:

cURLbash
curl https://proxyllm.eu/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PROXYLLM_API_KEY" \
  -d '{
    "model": "claude-opus-4.7",
    "messages": [
      { "role": "user", "content": "Hello! What can you help me with?" }
    ]
  }'
Python SDKpython
from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://proxyllm.eu/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-4.7",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)
Node.js SDKjavascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "your-api-key",
  baseURL: "https://proxyllm.eu/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-opus-4.7",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

//4 – Xác minh Thiết lập

Nếu mọi thứ được cấu hình chính xác, bạn sẽ nhận được phản hồi như sau:

>Phản hồi định dạng OpenAI

choices[0].message.content chứa câu trả lời.

OpenAI Formatjson
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1701234567,
  "model": "claude-opus-4.7",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hello! I'm an AI assistant..." },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 45, "total_tokens": 57 }
}

//Phản hồi Streaming

ProxyLLM hỗ trợ server-sent events (SSE) streaming cho định dạng OpenAI. Bật streaming bằng cách thêm "stream": true vào yêu cầu của bạn – token được gửi khi chúng được tạo ra.

OpenAI – SSE Streamingbash
curl https://proxyllm.eu/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PROXYLLM_API_KEY" \
  -d '{
    "model": "claude-opus-4.7",
    "stream": true,
    "messages": [{ "role": "user", "content": "Tell me a short story." }]
  }'

//Vấn đề Thường gặp

[WARN]Giới hạn Tốc độ

Nếu bạn nhận được lỗi 429, bạn có thể đang đạt giới hạn tốc độ. Kiểm tra tài liệu Giới hạn Tốc độ để biết chi tiết.

[WARN]Xác thực Thất bại

Đảm bảo API key của bạn chính xác và chưa hết hạn. Xem Hướng dẫn Xác thực để khắc phục sự cố.

//Bước Tiếp theo