Bắt đầu nhanh với API

Hướng dẫn này gửi một yêu cầu cơ bản đến endpoint Chat Completions OpenAI-compatible.

Điều kiện tiên quyết

Thiết lập các biến môi trường cho ví dụ:

export GETROUTER_API_KEY="YOUR_API_KEY"
export GETROUTER_MODEL="MODEL_ID"

cURL

curl https://getrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $GETROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$GETROUTER_MODEL"'",
    "messages": [
      {"role": "user", "content": "Write one sentence about reliable APIs."}
    ]
  }'

Văn bản được tạo sẽ được trả về tại:

choices[0].message.content

Python

Cài đặt OpenAI SDK:

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GETROUTER_API_KEY"],
    base_url="https://getrouter.ai/v1",
)

response = client.chat.completions.create(
    model=os.environ["GETROUTER_MODEL"],
    messages=[
        {"role": "user", "content": "Write one sentence about reliable APIs."}
    ],
)

print(response.choices[0].message.content)

Node.js / TypeScript

Cài đặt OpenAI SDK:

bun add openai
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.GETROUTER_API_KEY,
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.chat.completions.create({
  model: process.env.GETROUTER_MODEL!,
  messages: [
    { role: 'user', content: 'Write one sentence about reliable APIs.' },
  ],
})

console.log(response.choices[0]?.message.content)

Các lỗi thường gặp ở yêu cầu đầu tiên

LỗiNội dung cần kiểm tra
401Khóa API đầy đủ, đang hoạt động và được gửi dưới dạng Bearer YOUR_API_KEY
404Base URL không bị lặp và client đang gọi /chat/completions
Không tìm thấy mô hìnhDùng chính xác model ID từ trang Mô hình
Không đủ số dư hoặc hạn mứcKiểm tra số dư tài khoản và giới hạn sử dụng của khóa API
Thao tác không được hỗ trợChọn mô hình tương thích với Chat Completions

Bước tiếp theo