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 · GPT-5.6 Luna · Claude-Sonnet-5 · Gemini-3.6 Flash。
`model`	`orkas-llm-1.5-pro`	适合研究、视频、研发等复杂任务。包含：GPT-5.6 Sol · Claude Opus 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 内的用量区分。