快速接入指南

只需 3 個簡單步驟，即可在幾分鐘內完成接入並開始呼叫大模型。

---

步驟一：獲取 API 金鑰 (API Key)

1. 登入 Ainfix 控制台。
2. 在左側選單中進入 「API 金鑰」 (Tokens)。
3. 點擊 「新增權杖」，設定權杖名稱與額度限制，儲存並複製產生的 sk-... 金鑰。

:::caution 安全提醒 API 金鑰具備呼叫額度權限，切勿直接提交至公開程式碼儲存庫或硬編碼在前端用戶端中。 :::

---

步驟二：介面接入位址 (Base URL)

本平台標準介面位址為：

https://api.ainfix.com/v1

---

步驟三：程式碼呼叫範例

1. Python (使用官方 openai 函式庫)

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-ainfix-token-here",
    base_url="https://api.ainfix.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "你好，请介绍一下你自己！"}
    ],
    stream=False
)

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

---

2. Node.js / TypeScript (使用官方 openai 函式庫)

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-ainfix-token-here',
  baseURL: 'https://api.ainfix.com/v1',
});

async function main() {
  const completion = await client.chat.completions.create({
    model: 'gpt-5.6-sol',
    messages: [{ role: 'user', content: 'Hello!' }],
  });

  console.log(completion.choices[0].message.content);
}

main();

---

3. cURL (命令列直接呼叫)

curl https://api.ainfix.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-ainfix-token-here" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "Hello World!"
      }
    ]
  }'

---

第三方用戶端設定說明

如果您使用圖形化用戶端（如 NextChat、Cherry Studio、ChatBox、LobeChat、Cursor、Dify 等）：

1. 介面類型 (API Provider)：選擇 OpenAI。
2. API 網域名稱 (Base URL / API Host)：填入 https://api.ainfix.com（部分用戶端會自動補齊 /v1，若支援完整路徑可填 https://api.ainfix.com/v1）。
3. API 金鑰 (API Key)：填入在 Ainfix 控制台產生的 sk-... 權杖。
4. 模型名稱 (Model)：直接填入平台支援的模型名稱（如 gpt-4o, claude-3-5-sonnet, gemini-1.5-pro 等）。