文件

OpenAI 相容 API

更新於 2026-07-21

/v1/chat/completions 是跨廠商最通用的主要端點。將官方 OpenAI SDK 的 Base URL 改為 https://api.rokoapi.com/v1，即可呼叫本站已上線模型。

本頁對應「相容模式」接入；若您需要 OpenAI Responses 原生協定，請見 Responses API。

為何使用相容模式

一套程式碼支援多模型：同一 SDK 可呼叫 DeepSeek、OpenAI、圖像模型等已上線通道
生態成熟：LangChain、各類 IDE 外掛、代理客戶端預設使用 Chat Completions
遷移成本低：只需修改 base_url / baseURL 與 model

何時改用 Responses：當您需要 Responses 的結構化 output、語意化串流事件，或上游僅在該端點開放的功能——請見 Responses API。

快速開始

curl https://api.rokoapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "你是一位回答精簡的助理"},
      {"role": "user", "content": "請用一句話介紹你自己"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "你是一位回答精簡的助理"},
        {"role": "user", "content": "請用一句話介紹你自己"},
    ],
)
print(resp.choices[0].message.content)

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.rokoapi.com/v1',
})

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [
    { role: 'system', content: '你是一位回答精簡的助理' },
    { role: 'user', content: '請用一句話介紹你自己' },
  ],
})

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

model 必須使用已上線模型開發指南中的真實模型 ID，請勿使用未開通的名称。

請求參數速查

參數	類型	說明
`model`	string	必填，已上線模型 ID
`messages`	array	必填，對話訊息
`stream`	boolean	`true` 時回傳 SSE
`temperature`	number	取樣溫度；部分推理模型可能不支援
`max_tokens` / `max_completion_tokens`	int	最大輸出長度
`tools` / `tool_choice`	—	函式呼叫；視模型與通道支援情況而定
`response_format`	object	JSON 等輸出格式約束

更詳細的欄位說明請見 Chat Completions。

回應結構

成功時回傳標準 Chat Completion JSON，文字位於 choices[0].message.content。錯誤時通常包含 error.message（及可選 error.type / error.code）。

串流輸出

設定 "stream": true。串流細節請見串流請求。

圖像等非文字功能

圖像生成等請使用對應端點（如 /v1/images/generations），並將 model 替換為圖像模型 ID。各系列範例請參閱側邊欄「已上線模型」。