Início rápido da API
Comece a usar as APIs da Ninja e potencialize seus produtos de IA com velocidade, escalabilidade e confiabilidade incomparáveis.
Registro
Inscreva-se em Super.myninja.ai para começar a usar nossas APIs.
Você pode se inscrever gratuitamente ou assinar um nível Ultra ou Business. O Ultra e o Business oferecem acesso ilimitado ao playground para experimentar nossos principais LLMs de raciocínio e pesquisa profunda*.
Quando estiver pronto para passar da exploração para a execução, compre créditos para começar a criar produtos e experiências de IA para codificação, escrita e muito mais.
* Sujeito a limites de abuso
Créditos de compra
Depois de se inscrever no Super.myninja.ai, vá para o painel esquerdo e clique no Ícone da API.

Então vá para “Assinatura e créditos”.

Abaixo “Seus créditos,” clique “Comprar créditos”.

Na “Valor do pagamento automático” campo, insira o valor que você gostaria de comprar para créditos (mínimo $30).

Na “Limite de pagamento automático” campo, defina o valor limite de que, quando seu saldo cair abaixo desse valor, recarregaremos o “Valor do pagamento automático”. Isso garante que você não fique sem créditos ou que sua chave de API pare de funcionar. (mínimo $25).

Selecione seu método de pagamento preferido e clique em “Confirme e pague.” Em seguida, você será redirecionado para uma tela de cobrança do Stripe para concluir seu pagamento.

Gere uma chave de API
Depois de comprar seus créditos, acesse o “Gerencie suas chaves de API” seção sobre o Página de chaves e créditos da API.

Clique no “Criar uma nova chave” botão.

Na “Nome” campo, insira um nome para sua chave (por exemplo, Chave de produção) e, em seguida, clique em “Criar chave”.

Depois que sua chave for gerada, copiá-lo e salve-o em algum lugar seguro, pois qualquer pessoa com acesso pode usá-lo. Se necessário, você pode regenerar uma nova chave.

Usando APIs Ninja
Visão geral
URL base:
https://api.myninja.ai/v1
Autenticação:
Todas as solicitações exigem uma chave de API passada no cabeçalho da seguinte forma: onde <token-key>está seu token de autenticação:
Autorização: Portador <token-key>
Ponto final:
POSTAR /chat/conclusões
Esse endpoint aceita solicitações de bate-papo e transmite respostas com base no modelo especificado.
Modelos:
Os modelos atualmente disponíveis incluem:
pesquisa profunda sobre ninjas
superagente ninja: turbo
superagente ninja: apex
Super-agente ninja: raciocínio
Esses modelos podem ser selecionados fornecendo o modelo parâmetro no corpo da solicitação.
Formato da solicitação
A API Ninja segue as Especificação da API OpenAI de perto. O objeto JSON da solicitação contém:
modelo (string):
O identificador do modelo a ser usado (por exemplo, “pesquisa profunda sobre ninjas”).
mensagens (matriz):
Uma matriz de objetos de mensagem. Cada objeto segue o formato:
fluxo (booleano):
Quando definido como verdade, a API responde com uma resposta de streaming.
stream_options (objeto):
Opções adicionais para streaming, como “include_usage”: verdadeiro para incluir detalhes de uso do token.
extra_headers (objeto):
Qualquer cabeçalho extra exigido pela API Ninja (nenhum no momento)
Exemplo de solicitação (json)
Resposta
A API retorna um fluxo de Fragmento de conclusão de bate-papo objetos. Cada pedaço pode conter:
Conteúdo:
O texto da conclusão, que pode incluir etapas de raciocínio empacotadas em XML.
Citações:
Uma lista de URLs que apoiam o raciocínio fornecido.
Informações de uso:
Estatísticas de uso do token se “include_usage”: verdadeiro foi especificado.
O código do cliente pode processar esses fragmentos para exibir uma resposta avançada que inclui:
Etapas de raciocínio: Extraído e formatado dos segmentos XML.
Citações: Exibido como uma lista numerada.
Estatísticas de uso: Mostrando tokens de entrada e saída.
Exemplos de código de amostra
Preços
Modo
Preço de entrada/ por M tokens
Preço de saída/ por M tokens
Preço/ tarefa
Qwen 3 Coder 480B (Cérebras)
—
—
$1,50
Modo padrão
—
—
$1,00
Modo complexo
—
—
$1,50
Modo rápido
—
—
$1,50
Modo
Preço de entrada/ por M tokens
Preço de saída/ por M tokens
Preço/ tarefa
Qwen 3 Coder 480B (Cérebras)
$3,75
$3,75
—
Modo padrão
$1,50
$1,50
—
Modo complexo
$4,50
$22,50
—
Modo rápido
$3,75
$3,75
—
modelo
Preço de entrada/ por M tokens
Preço de saída/ por M tokens
Turbo 1.0
0,11 US$
$0,42
Apex 1.0
$0,88
$7,00
Raciocínio 2.0
$0,38
$1,53
Pesquisa profunda 2.0
$1,40
$5,60
Limites de tarifa
A Ninja AI impõe limites de taxa nas solicitações de inferência por modelo para garantir que os desenvolvedores possam testar a inferência mais rápida.
modelo
Solicitação por minuto (RPM)
Turbo 1.0
50
Apex 1.0
20
Raciocínio 2.0
30
Pesquisa profunda 2.0
5
Perguntas frequentes
Aqui está o que você precisa saber sobre a API do Ninja com base no que mais nos perguntam.
Como posso aumentar meu limite e valor de pagamento automático?
No Ninja, vá para o painel esquerdo e clique no Ícone de gerenciamento de API.
Abaixo “Seus créditos,” clique “Gerenciar créditos”.
Na “Valor do pagamento automático” campo, insira o valor que você gostaria de aumentar para créditos (mínimo $30).
Na “Limite de pagamento automático” campo, edite o valor limite que, quando seu saldo cair abaixo desse valor, recarregaremos o “Valor do pagamento automático”. Isso garante que você não fique sem créditos ou que sua chave de API pare de funcionar (mínimo de $25).
Clique “Salvar alterações” para confirmar.
Como posso cancelar meu contrato de pagamento automático?
No Ninja, vá para o painel esquerdo e clique no Ícone de gerenciamento de API.
Selecione “Chaves e créditos da API” então vá para “Seus créditos” seção.
Abaixo “Seus créditos,” clique “Mais opções”.
Selecione “Cancelar pagamento automático de créditos”(mínimo $30).
Clique “Excluir pagamento automático” para confirmar.
Como excluo uma chave de API?
No Ninja, vá para o painel esquerdo e clique no Ícone de gerenciamento de API.
Selecione “Chaves e créditos da API” então vá para “Chaves de API”.
Encontre sua chave de API e selecione o ícone da lixeira à direita.
Clique “Excluir chave de API” para confirmar.
Como posso ver o uso de cada solicitação de API?
No Ninja, vá para o painel esquerdo e clique no Ícone de gerenciamento de API.
Em seguida, clique em “Uso da API”.
Na “Uso da API” Na página, você verá uma tabela exibindo os seguintes detalhes de cada API:
Nome da chave
modelo
Tokens de entrada e saída
Custo de entrada e saída
Carimbo de data/hora para solicitação
Custo total