Orkas API 문서
Orkas의 채팅, 검색, 음성, 이미지, 동영상 기능을 자신의 도구에 연결하세요. 채팅부터 시작하여 대부분의 AI 애플리케이션에서 사용하는 기본 URL, API 키, 모델 이름을 확인하세요.
채팅
AI 애플리케이션, 명령줄 도구 또는 자체 서비스에서 OpenAI 호환 Chat Completions 형식을 사용하세요.
연결 설정
애플리케이션에서 기본 URL, API 키, 모델을 요청하면 다음 값을 입력하세요.
| 설정 | 값 | 설명 |
|---|---|---|
Base URL | https://orkas.ai/v1 | OpenAI 호환 서비스 주소로 사용하세요. |
API Key | 계정에서 키 만들기 | 애플리케이션의 API 키 필드에 키를 붙여 넣으세요. |
model | orkas-llm-1.5추천 | 일상적인 질의응답, 글쓰기, 사무 업무에 적합합니다. DeepSeek V4 · GPT-5.6 Luna · Claude-Sonnet-5 · Gemini-3.6 Flash를 포함합니다. |
orkas-llm-1.5-pro | 리서치, 동영상, R&D 및 기타 복잡한 작업에 적합합니다. 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 | 1M 토큰당이며 정확한 요율은 요청에 따라 달라집니다. |
orkas-llm-1.5-pro | 입력 140–1,000; 캐시 읽기 14–100; 캐시 생성 175–1,250; 출력 840–4,500 | 1M 토큰당이며 정확한 요율은 요청에 따라 달라집니다. |
검색
웹을 검색하여 애플리케이션에 관련 검색 결과를 간결한 목록으로 반환합니다.
웹 검색
엔드포인트
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 | 아니요 | 편집용 HTTPS URL 또는 지원되는 이미지 데이터 URL을 최대 4개 제공합니다. |
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를 설정하세요. API가 작업 id를 반환합니다. 결과가 준비될 때까지 상태 URL을 사용하세요.생성 상태 확인
엔드포인트
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 | 아니요 | 공개 HTTPS 이미지 URL을 최대 9개 제공합니다. |
reference_video_urls | array | 아니요 | 공개 HTTPS 동영상 URL을 최대 3개 제공합니다. |
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 | 출력 시간 1초당 |
balanced · 텍스트 또는 이미지로 동영상 생성 · 720p | 80 | 출력 시간 1초당 |
balanced · 텍스트 또는 이미지로 동영상 생성 · 1080p | 248 | 출력 시간 1초당 |
quality · 텍스트 또는 이미지로 동영상 생성 · 480p | 46 | 출력 시간 1초당 |
quality · 텍스트 또는 이미지로 동영상 생성 · 720p | 100 | 출력 시간 1초당 |
quality · 텍스트 또는 이미지로 동영상 생성 · 1080p | 248 | 출력 시간 1초당 |
balanced / quality · 동영상 편집 또는 참조 동영상 기반 생성 · 480p | 51 | 출력 시간 1초당 |
balanced / quality · 동영상 편집 또는 참조 동영상 기반 생성 · 720p | 109 | 출력 시간 1초당 |
balanced / quality · 동영상 편집 또는 참조 동영상 기반 생성 · 1080p | 271 | 출력 시간 1초당 |
| 동영상 상태 확인 | 0 | 요청당 |
보안 및 제한
API 키를 비공개로 유지하고 애플리케이션마다 별도의 키를 사용하세요. 유출되었을 가능성이 있다면 즉시 키를 삭제하세요.
Authorization: Bearer sk-orkas-…요청 헤더로 키를 보내세요.- 한 대화의 크레딧 사용량을 묶으려면 해당 대화의 요청마다
X-Orkas-Conversation-Id에 동일한 불투명 ID를 보내세요. 영문자, 숫자,-,_만 사용하고 최대 64자로 제한하세요. 제목이나 메시지 내용은 보내지 마세요. - 브라우저 또는 모바일 앱 코드, URL, 로그, 소스 관리 저장소에 키를 넣지 마세요.
- 다른 서비스에 영향을 주지 않고 교체할 수 있도록 애플리케이션마다 별도의 키를 만드세요.
- 키별 제한: 분당 채팅 및 검색 요청 120회, 음성 요청 60회, 이미지 요청 30회, 동영상 요청 10회입니다. 상태 확인은 분당 120회까지 허용됩니다.
- 요청이 너무 잦으면 API가 HTTP 429를 반환합니다. 잠시 기다린 뒤 다시 시도하세요.
크레딧 내역
API 사용량은 Orkas Web 크레딧 내역에 별도로 표시되어 Orkas 내 사용량과 구분할 수 있습니다.