Kết nối các khả năng trò chuyện, tìm kiếm, giọng nói, hình ảnh và video của Orkas với công cụ riêng của bạn. Bắt đầu với Trò chuyện để tìm URL cơ sở, khóa API và tên mô hình được hầu hết ứng dụng AI sử dụng.
Chat và Responses cung cấp phản hồi của mô hình và lời gọi hàm tùy chỉnh để ứng dụng của bạn xử lý; các endpoint hình ảnh và video tạo nội dung đa phương tiện. Những lệnh gọi API này không khởi chạy tác vụ Commander trên ứng dụng máy tính hoặc tự động huy động các tác nhân của ứng dụng đó. Việc điều phối tác nhân bổ sung phụ thuộc vào quy trình của ứng dụng bạn.
Cài đặt kết nối
Nếu ứng dụng yêu cầu URL cơ sở, khóa API và mô hình, hãy nhập các giá trị sau.
Cài đặt
Giá trị
Mô tả
Base URL
https://orkas.ai/v1
Dùng giá trị này làm địa chỉ dịch vụ tương thích OpenAI.
13–23 điểm tín dụng / ảnh đầu ra + 5 / ảnh đầu vào
13–23 điểm tín dụng / ảnh đầu ra + 5 / ảnh đầu vào (≤2.61 MP: 13; >2.61 MP: 23)
Kiểm tra trạng thái tạo
0
Mỗi yêu cầu
Video
Tạo video từ văn bản hoặc nội dung tham chiếu. Yêu cầu video chạy bất đồng bộ, vì vậy hãy dùng ID tác vụ được trả về để kiểm tra tiến độ.
Tạo video
Điểm cuối
POST
https://orkas.ai/v1/videos
Tạo video
Xác thực
Authorization: Bearer $ORKAS_API_KEY
Tham số nội dung yêu cầu
Tham số
Loại
Bắt buộc
Mô tả
prompt
string
Có
Mô tả video cần tạo hoặc chỉnh sửa.
duration
integer
Không
4–15 giây. Mặc định: 5.
resolution
string
Không
480p, 720p hoặc 1080p. Mặc định: 720p.
quality
string
Không
balanced cân bằng tốc độ và mức sử dụng điểm tín dụng; quality ưu tiên chất lượng tạo và độ ổn định. Mặc định: balanced. Orkas vẫn tự động chọn mô hình video tương thích.
ratio
string
Không
16:9, 9:16, 1:1, 4:3, 3:4 hoặc 21:9. Mặc định: 16:9.
generate_audio
boolean
Không
Tạo âm thanh cho video. Mặc định: true.
reference_image_urls
array
Không
Tối đa chín URL hình ảnh HTTPS công khai.
reference_video_urls
array
Không
Tối đa ba URL video HTTPS công khai.
operation
string
Không
generate hoặc edit. Chỉnh sửa cần ít nhất một video tham chiếu. Mặc định: generate.
seed
integer
Không
Giá trị khởi tạo ngẫu nhiên tùy chọn để có thể lặp lại kết quả tạo.
Ví dụ yêu cầu
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
}'
balanced · Văn bản hoặc hình ảnh thành video · 480p
37
Mỗi giây đầu ra
balanced · Văn bản hoặc hình ảnh thành video · 720p
80
Mỗi giây đầu ra
balanced · Văn bản hoặc hình ảnh thành video · 1080p
248
Mỗi giây đầu ra
quality · Văn bản hoặc hình ảnh thành video · 480p
46
Mỗi giây đầu ra
quality · Văn bản hoặc hình ảnh thành video · 720p
100
Mỗi giây đầu ra
quality · Văn bản hoặc hình ảnh thành video · 1080p
248
Mỗi giây đầu ra
balanced / quality · Chỉnh sửa video hoặc tạo video từ video tham chiếu · 480p
2800
1M tokens Video tham chiếu: token tính phí thực tế gồm video đầu vào/đầu ra và mức dùng tối thiểu; ảnh tham chiếu không tính phí riêng
balanced / quality · Chỉnh sửa video hoặc tạo video từ video tham chiếu · 720p
2800
1M tokens Video tham chiếu: token tính phí thực tế gồm video đầu vào/đầu ra và mức dùng tối thiểu; ảnh tham chiếu không tính phí riêng
balanced / quality · Chỉnh sửa video hoặc tạo video từ video tham chiếu · 1080p
3100
1M tokens Video tham chiếu: token tính phí thực tế gồm video đầu vào/đầu ra và mức dùng tối thiểu; ảnh tham chiếu không tính phí riêng
Kiểm tra trạng thái video
0
Mỗi yêu cầu
Bảo mật và giới hạn
Giữ kín khóa API, dùng khóa riêng cho từng ứng dụng và xóa khóa ngay nếu có khả năng bị lộ.
Gửi khóa trong tiêu đề yêu cầu Authorization: Bearer sk-orkas-….
Để nhóm mức sử dụng điểm tín dụng của một cuộc trò chuyện, hãy gửi cùng một ID không chứa thông tin có nghĩa trong X-Orkas-Conversation-Id trên các yêu cầu của cuộc trò chuyện đó. Chỉ dùng chữ cái, chữ số, - hoặc _ (tối đa 64 ký tự); không gửi tiêu đề hay nội dung tin nhắn.
Không đặt khóa trong mã trình duyệt hoặc ứng dụng di động, URL, nhật ký hay hệ thống quản lý mã nguồn.
Tạo khóa riêng cho từng ứng dụng để có thể thay thế mà không ảnh hưởng đến dịch vụ khác.
Giới hạn cho mỗi khóa: 120 yêu cầu/phút cho trò chuyện và tìm kiếm, 60 cho giọng nói, 30 yêu cầu hình ảnh và 10 yêu cầu video. Kiểm tra trạng thái cho phép 120 yêu cầu/phút.
Nếu gửi yêu cầu quá thường xuyên, API trả về HTTP 429. Đợi một lát trước khi thử lại.
Lịch sử điểm tín dụng
Mức sử dụng API được đánh dấu riêng trong lịch sử điểm tín dụng trên Orkas Web, giúp bạn phân biệt với mức sử dụng trong Orkas.