GetRouter文件
  • 繁體中文

    • API 快速入門

    本指南會將基本請求傳送至 OpenAI 相容的 Chat Completions 端點。

    事前準備

    為範例設定環境變數：

    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": "請用一句話介紹可靠的 API。"}
    ]
  }'

    生成的文字會在以下位置傳回：

    choices[0].message.content

    Python

    安裝 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": "請用一句話介紹可靠的 API。"}
    ],
)

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

    Node.js / TypeScript

    安裝 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: '請用一句話介紹可靠的 API。' },
  ],
})

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

    第一次請求的常見錯誤

    錯誤檢查項目
    401API 金鑰完整、有效，並以 Bearer YOUR_API_KEY 傳送
    404Base URL 未重複，且用戶端呼叫 /chat/completions
    找不到模型使用 Models 中完全相符的模型 ID
    餘額或配額不足查看帳戶餘額與 API 金鑰用量上限
    不支援的操作選擇與 Chat Completions 相容的模型

    後續步驟