OrkasOrkas
ดาวน์โหลด GitHub
Orkas API

เอกสาร Orkas API

เชื่อมต่อความสามารถด้านแชต การค้นหา เสียงพูด ภาพ และวิดีโอของ Orkas เข้ากับเครื่องมือของคุณเอง เริ่มที่แชตเพื่อดู URL ฐาน คีย์ API และชื่อโมเดลที่แอปพลิเคชัน AI ส่วนใหญ่ใช้

แชต

Chat และ Responses ให้คำตอบจากโมเดลและการเรียกฟังก์ชันที่กำหนดเองซึ่งแอปของคุณต้องจัดการ ส่วนเอนด์พอยต์รูปภาพและวิดีโอใช้สร้างสื่อ การเรียก API เหล่านี้จะไม่เริ่มงาน Commander ในแอปเดสก์ท็อปหรือเรียกใช้เอเจนต์ของแอปโดยอัตโนมัติ การประสานงานเอเจนต์เพิ่มเติมขึ้นอยู่กับเวิร์กโฟลว์ของแอปคุณ

การตั้งค่าการเชื่อมต่อ

หากแอปพลิเคชันขอ URL ฐาน คีย์ API และโมเดล ให้ป้อนค่าต่อไปนี้

การตั้งค่าค่าคำอธิบาย
Base URL
https://orkas.ai/v1
ใช้ค่านี้เป็นที่อยู่บริการที่เข้ากันได้กับ OpenAI
API Keyวางคีย์ลงในช่องคีย์ API ของแอปพลิเคชัน
model
orkas-llm-1.5แนะนำ
เหมาะที่สุดสำหรับการถามตอบทั่วไป งานเขียน และงานสำนักงาน มี DeepSeek V4.1 Flash · GPT-6 Luna · Claude Sonnet 5 · Gemini-3.8 Flash
orkas-llm-1.5-pro
เหมาะที่สุดสำหรับงานวิจัย วิดีโอ การวิจัยและพัฒนา และงานซับซ้อนอื่น ๆ มี GPT-6 Sol · Claude Opus 5.5 · Kimi K3

Responses แนะนำ

เอนด์พอยต์

POST
https://orkas.ai/v1/responses
Responses

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์ในเนื้อหาคำขอ

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
modelstringใช่orkas-llm-1.5 หรือ orkas-llm-1.5-pro
inputstring / arrayใช่ข้อความหรือรายการสนทนา
reasoningobjectไม่ระดับการให้เหตุผลที่เลือกได้: low, medium หรือ high
toolsarrayไม่คำจำกัดความฟังก์ชันของเครื่องมือที่แอปของคุณเรียกใช้
streambooleanไม่ส่งคำตอบแบบสตรีมเมื่อเป็น true ค่าเริ่มต้น: false

ตัวอย่างคำขอ

curl https://orkas.ai/v1/responses \
  -H "Authorization: Bearer $ORKAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "orkas-llm-1.5",
    "input": "Hello",
    "reasoning": {"effort": "medium"}
  }'

Chat

เอนด์พอยต์

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

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์ในเนื้อหาคำขอ

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
modelstringใช่orkas-llm-1.5 หรือ orkas-llm-1.5-pro
messagesarrayใช่ข้อความในบทสนทนา แต่ละรายการมี role และ content
streambooleanไม่ส่งคำตอบแบบสตรีมเมื่อเป็น 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อินพุต 50–100; อ่านแคช 5–10; สร้างแคช 62.5–125; เอาต์พุต 250–375ต่อ 1 ล้านโทเคนสำหรับโมเดลหลัก
orkas-llm-1.5-proอินพุต 200–400; อ่านแคช 10–20; สร้างแคช 250–500; เอาต์พุต 1,000–1,500ต่อ 1 ล้านโทเคนสำหรับโมเดลหลัก

เสียงพูด

เปลี่ยนข้อความเป็นไฟล์เสียง เลือก 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_bigttsvivi 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_bigttsTimอังกฤษ
en_female_dacey_uranus_bigttsDaceyอังกฤษ
en_female_stokie_uranus_bigttsStokieอังกฤษ

สร้างเสียงพูด

เอนด์พอยต์

POST
https://orkas.ai/v1/audio/speech
สร้างเสียงพูด

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์ในเนื้อหาคำขอ

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
modelstringใช่ใช้ orkas-tts-1
inputstringใช่ข้อความที่จะสังเคราะห์ สูงสุด 16,384 ไบต์ UTF-8
voicestringใช่ID เสียงจากรายการด้านบน
languagestringไม่ภาษาบรรยาย เช่น zh-CN หรือ en เสียงที่เลือกต้องรองรับภาษานั้น มิฉะนั้นจะใช้ภาษาเริ่มต้นของเสียง
response_formatstringไม่mp3, wav, opus หรือ ogg ค่าเริ่มต้น: mp3
speednumberไม่ความเร็วเสียงพูดตั้งแต่ 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ต่อวินาทีเอาต์พุตโดยประมาณ ปัดขึ้นโดยคิดขั้นต่ำหนึ่งวินาที

ภาพ

สร้างภาพจากคำอธิบาย หรือให้ภาพอ้างอิงเพื่อแก้ไข โดยจะส่งกลับหนึ่งภาพต่อคำขอ

สร้างภาพ

เอนด์พอยต์

POST
https://orkas.ai/v1/images/generations
สร้างภาพ

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์ในเนื้อหาคำขอ

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
promptstringใช่คำอธิบายภาพ สูงสุด 20,000 อักขระ
sizestringไม่1k / 1.5k / 2k หรือค่าความกว้าง×ความสูงที่รองรับ ค่าเริ่มต้น: 1.5k
response_formatstringไม่url หรือ b64_json ค่าเริ่มต้น: b64_json
reference_imagesarrayไม่URL แบบ HTTPS หรือ URL ข้อมูลภาพที่รองรับ สูงสุดสี่รายการสำหรับการแก้ไข
asyncbooleanไม่ส่งกลับ ID งานเมื่อเป็น true แนะนำเพื่อหลีกเลี่ยงคำขอหมดเวลา ค่าเริ่มต้น: 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":"1.5k",
    "response_format":"url",
    "async":true
  }'
สำหรับคำขอที่ใช้เวลานาน: ตั้งค่า "async": true API จะส่งกลับ id งาน ให้ใช้ URL สถานะจนกว่าผลลัพธ์จะพร้อม

ตรวจสอบสถานะการสร้าง

เอนด์พอยต์

GET
https://orkas.ai/v1/images/generations/{id}
ตรวจสอบสถานะการสร้าง

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์เส้นทาง

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
idstringใช่ID งานที่ส่งกลับจากคำขอสร้าง

ตัวอย่างคำขอ

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

การใช้เครดิต

รายการเรียกเก็บเงินเครดิตที่หักหน่วยเรียกเก็บเงิน
สร้างภาพ13–23 เครดิต / ภาพผลลัพธ์ + 5 / ภาพนำเข้า13–23 เครดิต / ภาพผลลัพธ์ + 5 / ภาพนำเข้า (≤2.61 MP: 13; >2.61 MP: 23)
ตรวจสอบสถานะการสร้าง0ต่อคำขอ

วิดีโอ

สร้างวิดีโอจากข้อความหรือสื่ออ้างอิง คำขอวิดีโอทำงานแบบอะซิงโครนัส จึงต้องใช้ ID งานที่ส่งกลับเพื่อตรวจสอบความคืบหน้า

สร้างวิดีโอ

เอนด์พอยต์

POST
https://orkas.ai/v1/videos
สร้างวิดีโอ

การยืนยันตัวตน

Authorization: Bearer $ORKAS_API_KEY

พารามิเตอร์ในเนื้อหาคำขอ

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
promptstringใช่คำอธิบายวิดีโอที่จะสร้างหรือแก้ไข
durationintegerไม่4–15 วินาที ค่าเริ่มต้น: 5
resolutionstringไม่480p, 720p หรือ 1080p ค่าเริ่มต้น: 720p
qualitystringไม่balanced สร้างสมดุลระหว่างความเร็วกับการใช้เครดิต ส่วน quality ให้ความสำคัญกับคุณภาพและความเสถียรในการสร้าง ค่าเริ่มต้น: balanced Orkas ยังคงเลือกโมเดลวิดีโอที่เข้ากันได้โดยอัตโนมัติ
ratiostringไม่16:9, 9:16, 1:1, 4:3, 3:4 หรือ 21:9 ค่าเริ่มต้น: 16:9
generate_audiobooleanไม่สร้างเสียงสำหรับวิดีโอ ค่าเริ่มต้น: true
reference_image_urlsarrayไม่URL ภาพ HTTPS ที่เข้าถึงได้สาธารณะ สูงสุดเก้ารายการ
reference_video_urlsarrayไม่URL วิดีโอ HTTPS ที่เข้าถึงได้สาธารณะ สูงสุดสามรายการ
operationstringไม่generate หรือ edit การแก้ไขต้องมีวิดีโออ้างอิงอย่างน้อยหนึ่งรายการ ค่าเริ่มต้น: generate
seedintegerไม่ค่า seed ที่ระบุได้เพื่อสร้างผลลัพธ์ซ้ำ

ตัวอย่างคำขอ

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

พารามิเตอร์เส้นทาง

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
idstringใช่ID งานที่ส่งกลับจากคำขอสร้าง

ตัวอย่างคำขอ

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

การใช้เครดิต

รายการเรียกเก็บเงินเครดิตที่หักหน่วยเรียกเก็บเงิน
balanced · ข้อความหรือภาพเป็นวิดีโอ · 480p37ต่อวินาทีเอาต์พุต
balanced · ข้อความหรือภาพเป็นวิดีโอ · 720p80ต่อวินาทีเอาต์พุต
balanced · ข้อความหรือภาพเป็นวิดีโอ · 1080p248ต่อวินาทีเอาต์พุต
quality · ข้อความหรือภาพเป็นวิดีโอ · 480p46ต่อวินาทีเอาต์พุต
quality · ข้อความหรือภาพเป็นวิดีโอ · 720p100ต่อวินาทีเอาต์พุต
quality · ข้อความหรือภาพเป็นวิดีโอ · 1080p248ต่อวินาทีเอาต์พุต
balanced / quality · การแก้ไขวิดีโอหรือการสร้างจากวิดีโออ้างอิง · 480p28001M tokens
วิดีโออ้างอิง: คิดตามโทเค็นจริง รวมวิดีโอนำเข้า/ผลลัพธ์และการใช้ขั้นต่ำ ภาพอ้างอิงไม่มีค่าบริการแยก
balanced / quality · การแก้ไขวิดีโอหรือการสร้างจากวิดีโออ้างอิง · 720p28001M tokens
วิดีโออ้างอิง: คิดตามโทเค็นจริง รวมวิดีโอนำเข้า/ผลลัพธ์และการใช้ขั้นต่ำ ภาพอ้างอิงไม่มีค่าบริการแยก
balanced / quality · การแก้ไขวิดีโอหรือการสร้างจากวิดีโออ้างอิง · 1080p31001M tokens
วิดีโออ้างอิง: คิดตามโทเค็นจริง รวมวิดีโอนำเข้า/ผลลัพธ์และการใช้ขั้นต่ำ ภาพอ้างอิงไม่มีค่าบริการแยก
ตรวจสอบสถานะวิดีโอ0ต่อคำขอ

ความปลอดภัยและข้อจำกัด

เก็บคีย์ API เป็นความลับ ใช้คีย์แยกสำหรับแต่ละแอปพลิเคชัน และลบคีย์ทันทีหากอาจรั่วไหล

  • ส่งคีย์ในส่วนหัวคำขอ Authorization: Bearer sk-orkas-…
  • หากต้องการจัดกลุ่มการใช้เครดิตจากบทสนทนาเดียวกัน ให้ส่ง ID ที่ไม่สื่อความหมายค่าเดียวกันใน X-Orkas-Conversation-Id ของคำขอเหล่านั้น ใช้เฉพาะตัวอักษร ตัวเลข - หรือ _ (สูงสุด 64 อักขระ) อย่าส่งชื่อเรื่องหรือเนื้อหาข้อความ
  • อย่าใส่คีย์ในโค้ดเบราว์เซอร์หรือแอปมือถือ URL บันทึกระบบ หรือระบบควบคุมซอร์สโค้ด
  • สร้างคีย์แยกสำหรับแต่ละแอปพลิเคชัน เพื่อเปลี่ยนคีย์ได้โดยไม่กระทบบริการอื่น
  • ขีดจำกัดต่อคีย์: 120 คำขอ/นาทีสำหรับแชตและการค้นหา 60 สำหรับเสียงพูด 30 คำขอภาพ และ 10 คำขอวิดีโอ การตรวจสอบสถานะทำได้ 120 คำขอ/นาที
  • หากส่งคำขอถี่เกินไป API จะส่งกลับ HTTP 429 โปรดรอสักครู่ก่อนลองอีกครั้ง

ประวัติเครดิต

การใช้ API จะมีเครื่องหมายแยกในประวัติเครดิตบนเว็บ Orkas เพื่อให้คุณแยกจากการใช้งานใน Orkas ได้