開發者中心

概覽

使用與 OpenAI 相容的 API 呼叫 nextAPI 中可用的模型。

鑑權方式

• 請在控制檯建立 API 金鑰。
• 請僅在伺服器端保存 API 金鑰，切勿暴露在瀏覽器程式碼中。

基礎位址與請求規範

基礎位址

/v1

驗證方式

Bearer API 金鑰

• 請使用 Content-Type: application/json 傳送 JSON 請求本文。
• 設定 stream 為 true 可接收 Server-Sent Events，讀取 data 訊框直到 [DONE]。
• 使用相容 OpenAI 的用戶端，並將基礎位址設定為 /v1。

SDK 接入範例

平臺相容 OpenAI Chat Completions 協議。建立 API Key 後，將 SDK 的 base_url 指向 https://www.nextapi.com/v1，並使用目前模型 ID 發起呼叫。

在「API Keys」中建立並妥善儲存 API Key。
選擇下方語言安裝官方 OpenAI SDK。
透過環境變數傳入 API Key，避免將金鑰提交到程式碼儲存庫。

pip install openai

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["NEXTAPI_API_KEY"],
    base_url="https://www.nextapi.com/v1"
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

npm install openai

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: process.env.NEXTAPI_API_KEY,
  baseURL: "https://www.nextapi.com/v1"
})

const response = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "Hello" }]
})
console.log(response.choices[0].message.content)

POST

聊天補全 API

以與 OpenAI 相容的請求本文呼叫已上架模型。

/v1/chat/completions

請在 Authorization 標頭中傳送有效 API 金鑰。

請求標頭

請求參數

回應欄位

多語言範例

curl -X POST /v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-id","messages":[{"role":"user","content":"Hello"}]}'

範例請求

{"model":"your-model-id","messages":[{"role":"user","content":"Hello"}]}

範例回應

{"choices":[{"message":{"content":"Hello"}}]}

POST

嵌入向量 API

使用支援嵌入向量的模型建立文字向量。

/v1/embeddings

請使用獲授權存取所選嵌入模型的 API 金鑰。

請求標頭

請求參數

回應欄位

多語言範例

curl -X POST /v1/embeddings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-embedding-model-id","input":"Hello"}'

範例請求

{"model":"your-embedding-model-id","input":"Hello"}

範例回應

{"data":[{"embedding":[0.01,0.02],"index":0}],"usage":{"prompt_tokens":1,"total_tokens":1}}

價格與計費說明

• 費用依模型與 Token 用量計算。
• 只有成功且實際扣費大於零的呼叫會計費。
• 正式使用前請在模型廣場確認目前價格。

錯誤碼

常見問題

在哪裡建立 API 金鑰？

登入後，在控制檯的 API Keys 頁面建立。

支援哪些 API 格式？

閘道支援與 OpenAI 相容的聊天補全與嵌入向量請求。