Ligue a conversa, a pesquisa, a voz, a imagem e o vídeo do Orkas às suas ferramentas. Para a maioria das aplicações de IA, basta usar o URL base, a chave de API e o modelo da secção Conversa.
Chat e Responses fornecem respostas do modelo e chamadas de funções personalizadas que a sua aplicação deve tratar; os endpoints de imagem e vídeo geram conteúdos multimédia. Estas chamadas à API não iniciam uma tarefa do Commander na aplicação de computador nem envolvem automaticamente os seus agentes. Qualquer coordenação adicional de agentes depende do fluxo de trabalho da sua aplicação.
Definições de ligação
Se uma aplicação pedir o URL base, a chave de API e o modelo, introduza os valores abaixo.
Configuração
Valor
Descrição
Base URL
https://orkas.ai/v1
Use como endereço do serviço compatível com OpenAI.
Cole a chave no campo de chave de API da aplicação.
model
orkas-llm-1.5Recomendado
Ideal para perguntas e respostas, redação e tarefas quotidianas de escritório. Inclui DeepSeek V4.1 Flash · GPT-6 Luna · Claude Sonnet 5 · Gemini-3.8 Flash.
orkas-llm-1.5-pro
Ideal para pesquisa, vídeo, I&D e outras tarefas complexas. Inclui GPT-6 Sol · Claude Opus 5.5 · Kimi K3.
Responses Recomendado
Ponto de acesso
POST
https://orkas.ai/v1/responses
Responses
Autenticação
Authorization: Bearer $ORKAS_API_KEY
Parâmetros do corpo do pedido
Parâmetro
Tipo
Obrigatório
Descrição
model
string
Sim
orkas-llm-1.5 ou orkas-llm-1.5-pro.
input
string / array
Sim
Texto ou itens da conversa.
reasoning
object
Não
Esforço de raciocínio opcional: low, medium ou high.
tools
array
Não
Definições de funções das ferramentas executadas pela sua aplicação.
stream
boolean
Não
Devolve a resposta de forma contínua quando true. Predefinição: false.
13–23 créditos / imagem de saída + 5 / imagem de entrada
13–23 créditos / imagem de saída + 5 / imagem de entrada (≤2.61 MP: 13; >2.61 MP: 23)
Consultar geração
0
Por pedido
Vídeos
Crie um vídeo a partir de texto ou conteúdos multimédia de referência. O processamento é assíncrono; use o ID devolvido para o acompanhar.
Gerar vídeo
Ponto de acesso
POST
https://orkas.ai/v1/videos
Gerar vídeo
Autenticação
Authorization: Bearer $ORKAS_API_KEY
Parâmetros do corpo do pedido
Parâmetro
Tipo
Obrigatório
Descrição
prompt
string
Sim
Descrição do vídeo a gerar ou editar.
duration
integer
Não
4–15 segundos. Predefinição: 5.
resolution
string
Não
480p, 720p ou 1080p. Predefinição: 720p.
quality
string
Não
balanced equilibra a velocidade e o uso de créditos; quality dá prioridade à qualidade e à estabilidade da geração. Predefinição: balanced. O Orkas continua a selecionar automaticamente o modelo de vídeo compatível.
ratio
string
Não
16:9, 9:16, 1:1, 4:3, 3:4 ou 21:9. Predefinição: 16:9.
generate_audio
boolean
Não
Gera áudio para o vídeo. Predefinição: true.
reference_image_urls
array
Não
Até nove URLs HTTPS públicas de imagem.
reference_video_urls
array
Não
Até três URLs HTTPS públicas de vídeo.
operation
string
Não
generate ou edit. A edição exige pelo menos um vídeo de referência. Predefinição: generate.
seed
integer
Não
Semente opcional para melhorar a repetibilidade.
Exemplo de pedido
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 / quality · Edição ou geração com vídeo de referência · 480p
2800
1M tokens Vídeo de referência: tokens faturados incluem vídeo de entrada/saída e utilização mínima; imagens de referência sem custo separado
balanced / quality · Edição ou geração com vídeo de referência · 720p
2800
1M tokens Vídeo de referência: tokens faturados incluem vídeo de entrada/saída e utilização mínima; imagens de referência sem custo separado
balanced / quality · Edição ou geração com vídeo de referência · 1080p
3100
1M tokens Vídeo de referência: tokens faturados incluem vídeo de entrada/saída e utilização mínima; imagens de referência sem custo separado
Consultar vídeo
0
Por pedido
Segurança e limites
Mantenha as chaves privadas, use uma por aplicação e elimine imediatamente uma chave que possa ter sido exposta.
Envie a chave no cabeçalho Authorization: Bearer sk-orkas-….
Para agrupar o consumo de créditos de uma conversa, envie o mesmo ID anónimo no cabeçalho X-Orkas-Conversation-Id dos pedidos. Use apenas letras, números, - ou _ (até 64 caracteres); não envie o título nem o conteúdo das mensagens.
Não coloque chaves no código do navegador ou da aplicação móvel, em URLs, registos ou no controlo de versões.
Use uma chave por aplicação para poder trocá-la sem afetar outros serviços.
Limites por chave: 120 req/min para conversa e pesquisa, 60 para voz, 30 para imagem e 10 para vídeo. A consulta de estado permite 120 req/min.
Pedidos demasiado frequentes devolvem HTTP 429. Aguarde um pouco antes de tentar novamente.
Histórico de créditos
O uso da API aparece separado no histórico do Orkas Web, o que facilita a distinção face ao uso dentro do Orkas.