Orkas API

Orkas API 文件

把 Orkas 的對話、搜索、語音、圖片和影片能力接入你常用的工具。大多數 AI 應用只需要對話模塊中的 Base URL、API Key 和模型名稱。

對話

使用兼容 OpenAI 的 Chat Completions 格式，可接入 AI 應用、命令行工具或你自己的服務。

接入配置

如果應用要求填寫 Base URL、API Key 和模型，請使用下面的內容。

配置項	填寫內容	說明
`Base URL`	`https://orkas.ai/v1`	作為兼容 OpenAI 的服務地址填寫。
`API Key`	前往個人中心建立	把建立後的 Key 粘貼到應用的 API Key 輸入框。
`model`	`orkas-llm-1.5`推薦	適合問答、寫作、辦公等日常任務。包含：DeepSeek V4.1 Flash · GPT-6 Luna · Claude-Sonnet-5 · Gemini-3.8 Flash。
`model`	`orkas-llm-1.5-pro`	適合研究、影片、研發等複雜任務。包含：GPT-6 Sol · Claude Opus 5.5 · Kimi K3。

建立對話回復

介面地址

POST

https://orkas.ai/v1/chat/completions

建立對話回復

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求體參數

參數	類型	必填	說明
`model`	string	是	`orkas-llm-1.5` 或 `orkas-llm-1.5-pro`。
`messages`	array	是	對話消息數組，每項包含 `role` 和 `content`。
`stream`	boolean	否	設為 `true` 時流式返回，預設 `false`。

請求示例

curl https://orkas.ai/v1/chat/completions \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "orkas-llm-1.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

積分消耗

計費項目	積分抵扣	計費單位
`orkas-llm-1.5`	輸入 20–280；緩存讀取 2–28；緩存建立 25–350；輸出 120–1,260	每 100 萬 token；具體費率根據請求動態確定。
`orkas-llm-1.5-pro`	輸入 140–1,000；緩存讀取 14–100；緩存建立 175–1,250；輸出 840–4,500	每 100 萬 token；具體費率根據請求動態確定。

搜索

搜索網頁內容，為你的應用返回一組精簡、相關的結果。

搜索網頁

介面地址

POST

https://orkas.ai/v1/search

搜索網頁

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求體參數

參數	類型	必填	說明
`query`	string	是	要搜索的文字，最多 2,000 個字符。
`max_results`	integer	否	返回結果數量，1–20，預設 `8`。

請求示例

curl https://orkas.ai/v1/search \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest battery research","max_results":8}'

積分消耗

計費項目	積分抵扣	計費單位
搜索網頁	5.6	每次請求，最多返回 20 條結果。

語音

把文本轉換成音頻檔案。從下面選擇音色 ID，並指定需要的音頻格式。

查看音色

介面地址

GET

https://orkas.ai/v1/audio/voices

查看音色

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求參數

此介面沒有請求參數。

請求示例

curl https://orkas.ai/v1/audio/voices \
  -H "Authorization: Bearer $ORKAS_API_KEY"

可用音色 ID

音色 ID	名稱	語言
`zh_female_vv_uranus_bigtts`	vivi 2.0	中文 / 英文
`saturn_zh_female_cancan_tob`	知性灿灿	中文
`saturn_zh_female_keainvsheng_tob`	可爱女生	中文
`saturn_zh_female_tiaopigongzhu_tob`	调皮公主	中文
`saturn_zh_male_shuanglangshaonian_tob`	爽朗少年	中文
`saturn_zh_male_tiancaitongzhuo_tob`	天才同桌	中文
`zh_female_xiaohe_uranus_bigtts`	小何	中文
`zh_male_m191_uranus_bigtts`	云舟	中文
`zh_male_taocheng_uranus_bigtts`	小天	中文
`en_male_tim_uranus_bigtts`	Tim	英文
`en_female_dacey_uranus_bigtts`	Dacey	英文
`en_female_stokie_uranus_bigtts`	Stokie	英文

生成語音

介面地址

POST

https://orkas.ai/v1/audio/speech

生成語音

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求體參數

參數	類型	必填	說明
`model`	string	是	固定使用 `orkas-tts-1`。
`input`	string	是	需要合成的文本，最多 16,384 個 UTF-8 字節。
`voice`	string	是	從上方音色列表選擇音色 ID。
`language`	string	否	朗讀語言，例如 `zh-CN` 或 `en`。必須是所選音色支援的語言；不填寫時使用音色預設語言。
`response_format`	string	否	`mp3`、`wav`、`opus` 或 `ogg`，預設 `mp3`。
`speed`	number	否	語速範圍 0.5–2.0，預設 `1.0`。

請求示例

curl https://orkas.ai/v1/audio/speech \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"orkas-tts-1",
    "input":"你好，欢迎使用 Orkas。",
    "voice":"zh_female_vv_uranus_bigtts",
    "language":"zh-CN",
    "response_format":"mp3",
    "speed":1.0
  }' --output speech.mp3

積分消耗

計費項目	積分抵扣	計費單位
查看音色	0	每次請求
生成語音	0.125	按預估輸出時長每秒計費，至少按 1 秒向上取整。

圖片

根據文字描述生成圖片，也可以提供參考圖片進行編輯。每次請求返回一張圖片。

生成圖片

介面地址

POST

https://orkas.ai/v1/images/generations

生成圖片

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求體參數

參數	類型	必填	說明
`prompt`	string	是	圖片描述，最多 20,000 個字符。
`size`	string	否	`2k`、`3k`、`4k` 或受支援的寬×高，預設 `2k`。
`response_format`	string	否	`url` 或 `b64_json`，預設 `b64_json`。
`reference_images`	array	否	最多 4 個 HTTPS URL 或受支援的圖片 data URL，用於圖片編輯。
`async`	boolean	否	設為 `true` 時返回任務 ID，推薦使用以避免請求超時，預設 `false`。

請求示例

curl https://orkas.ai/v1/images/generations \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":"A product photo on a clean studio background",
    "size":"2k",
    "response_format":"url",
    "async":true
  }'

耗時較長時：設定 "async": true。介面會返回任務 id，使用狀態地址查詢，直到結果就緒。

查詢生成狀態

介面地址

GET

https://orkas.ai/v1/images/generations/{id}

查詢生成狀態

鑒權

Authorization: Bearer $ORKAS_API_KEY

路徑參數

參數	類型	必填	說明
`id`	string	是	建立任務時返回的任務 ID。

請求示例

curl https://orkas.ai/v1/images/generations/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

積分消耗

計費項目	積分抵扣	計費單位
生成圖片	22	每張生成圖片
查詢生成狀態	0	每次請求

影片

根據文字或參考媒體生成影片。影片請求為異步處理，請使用返回的任務 ID 查詢進度。

生成影片

介面地址

POST

https://orkas.ai/v1/videos

生成影片

鑒權

Authorization: Bearer $ORKAS_API_KEY

請求體參數

參數	類型	必填	說明
`prompt`	string	是	需要生成或編輯的影片描述。
`duration`	integer	否	4–15 秒，預設 `5` 秒。
`resolution`	string	否	`480p`、`720p` 或 `1080p`，預設 `720p`。
`quality`	string	否	`balanced` 平衡生成速度和積分消耗；`quality` 優先保證生成質量和穩定性。預設 `balanced`，實際影片模型仍由 Orkas 自動選擇。
`ratio`	string	否	`16:9`、`9:16`、`1:1`、`4:3`、`3:4` 或 `21:9`，預設 `16:9`。
`generate_audio`	boolean	否	是否生成影片音頻，預設 `true`。
`reference_image_urls`	array	否	最多 9 個公開 HTTPS 圖片 URL。
`reference_video_urls`	array	否	最多 3 個公開 HTTPS 影片 URL。
`operation`	string	否	`generate` 或 `edit`；編輯至少需要一個參考影片，預設 `generate`。
`seed`	integer	否	可選的生成隨機種子，用於提高結果的可復現性。

請求示例

curl https://orkas.ai/v1/videos \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":"Camera circles a ceramic lamp in a dark studio",
    "duration":5,
    "resolution":"720p",
    "quality":"balanced",
    "ratio":"16:9",
    "generate_audio":true
  }'

查詢影片狀態

介面地址

GET

https://orkas.ai/v1/videos/{id}

查詢影片狀態

鑒權

Authorization: Bearer $ORKAS_API_KEY

路徑參數

參數	類型	必填	說明
`id`	string	是	建立任務時返回的任務 ID。

請求示例

curl https://orkas.ai/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

積分消耗

計費項目	積分抵扣	計費單位
`balanced` · 文字或圖片生成影片 · 480p	37	每輸出秒
`balanced` · 文字或圖片生成影片 · 720p	80	每輸出秒
`balanced` · 文字或圖片生成影片 · 1080p	248	每輸出秒
`quality` · 文字或圖片生成影片 · 480p	46	每輸出秒
`quality` · 文字或圖片生成影片 · 720p	100	每輸出秒
`quality` · 文字或圖片生成影片 · 1080p	248	每輸出秒
`balanced` / `quality` · 影片編輯或參考影片生成 · 480p	51	每輸出秒
`balanced` / `quality` · 影片編輯或參考影片生成 · 720p	109	每輸出秒
`balanced` / `quality` · 影片編輯或參考影片生成 · 1080p	271	每輸出秒
查詢影片狀態	0	每次請求

安全與限流

請妥善保管 API Key，為不同應用分別建立 Key；如果可能洩露，應立即刪除。

請在請求頭中通過 Authorization: Bearer sk-orkas-… 發送 Key。
如需把同一會話的積分消耗合併展示，請在該會話的請求中使用相同的匿名 ID，並通過 X-Orkas-Conversation-Id 請求頭髮送。ID 僅支援字母、數字、-、_，最長 64 個字符；不要上傳會話標題或消息內容。
不要把 Key 放進瀏覽器或移動端代碼、URL、日誌或源碼倉庫。
建議每個應用單獨使用一個 Key，這樣更換時不會影響其他服務。
單 Key 限流：對話和搜索每分鐘 120 次、語音 60 次、圖片 30 次、影片 10 次；狀態查詢每分鐘 120 次。
請求過快時介面會返回 HTTP 429，請稍後再試。

積分記錄

API 產生的用量會在 Orkas Web 積分記錄中單獨標記，方便與 Orkas 內的用量區分。