Inicio rápido de API
Comience con las API de Ninja y potencie sus productos de IA con una velocidad, escalabilidad y confiabilidad incomparables.
Inscripción
Inscríbase en Super.myNinja.ai para empezar a usar nuestras API.
Puedes registrarte gratis o suscribirte a un nivel Ultra o Business. Ultra y Business te brindan acceso ilimitado al campo de juego para experimentar con nuestros programas de LLM emblemáticos, de razonamiento e investigación profunda*.
Cuando esté listo para pasar de la exploración a la ejecución, compre créditos para empezar a crear productos y experiencias de IA para la codificación, la escritura y mucho más.
* Sujeto a umbrales de abuso
Créditos de compra
Después de registrarse en Super.myNinja.ai, vaya al panel de la izquierda y haga clic en Icono de API.

A continuación, vaya a «Suscripción y créditos».

Bajo «Tus créditos», hacer clic «Créditos de compra».

En el «Importe de pago automático» campo, introduce la cantidad que deseas comprar para obtener créditos (mínimo 30$).

En el «Umbral de pago automático» campo, establece el importe límite para que, cuando tu saldo caiga por debajo de este importe, recargaremos el «Importe de pago automático». Esto garantiza que no te quedes sin créditos ni que tu clave de API deje de funcionar (mínimo 25$).

Selecciona tu método de pago preferido y haz clic «Confirmar y pagar». A continuación, se te redirigirá a la pantalla de facturación de Stripe para completar el pago.

Generar una clave de API
Después de comprar tus créditos, ve a «Gestiona tus claves de API» sección sobre la Página de claves de API y créditos.

Haga clic en el «Crear una nueva clave» botón.

En el «Nombre» campo, introduce un nombre para tu clave (p. ej., Clave de producción) y, a continuación, haga clic «Crear clave».

Una vez que se genere la clave, cópialo y guárdala en un lugar seguro, ya que cualquier persona con acceso puede usarla. Si es necesario, puede regenerarse una nueva clave.

Uso de las API Ninja
Vista general
URL base:
https://api.myninja.ai/v1
Autenticación:
Todas las solicitudes requieren que se pase una clave de API en el encabezado de la siguiente manera: ¿dónde <token-key>está tu token de autenticación?
Autorización: Portador <token-key>
Punto final:
PUBLICAR /chat/finalizaciones
Este punto final acepta solicitudes de chat y transmite las respuestas según el modelo especificado.
Modelos:
Los modelos disponibles actualmente incluyen:
ninja-deep research
ninja-super-agent: turbo
ninja-superagente: apex
Superagente ninja: razonamiento
Estos modelos se pueden seleccionar proporcionando el modelo parámetro en el cuerpo de su solicitud.
Formato de solicitud
La API Ninja sigue las Especificación de la API OpenAI de cerca. El objeto JSON de la solicitud contiene:
modelo (cadena):
El identificador del modelo que se va a utilizar (p. ej., «investigación profunda de ninjas»).
mensajes (matriz):
Conjunto de objetos de mensaje. Cada objeto sigue el formato:
flujo (booleano):
Cuando se establece en cierto, la API responde con una respuesta de streaming.
stream_options (objeto):
Opciones adicionales para la transmisión, como «include_usage»: verdadero para incluir detalles sobre el uso de los tokens.
extra_headers (objeto):
Cualquier encabezado adicional requerido por la API Ninja (ninguno en este momento)
Ejemplo de solicitud (json)
Respuesta
La API devuelve un flujo de ChateFination Chunk objetos. Cada fragmento puede contener:
Contenido:
El texto de la finalización, que puede incluir pasos de razonamiento envueltos en XML.
Citas:
Una lista de URL que respaldan el razonamiento proporcionado.
Información de uso:
Estadísticas de uso de tokens si «include_usage»: verdadero se especificó.
El código del cliente puede procesar estos fragmentos para mostrar una respuesta completa que incluya:
Pasos de razonamiento: Extraído y formateado a partir de segmentos XML.
Citas: Se muestra como una lista numerada.
Estadísticas de uso: Mostrando los tokens de entrada y salida.
Ejemplos de código de muestra
Fijación
Modo
Precio de entrada/ por M tokens
Precio de producción/ por M tokens
Precio/ tarea
Codificador Qwen 3 480V (Cerebras)
—
—
1,50$
Modo estándar
—
—
1,00$
Modo complejo
—
—
1,50$
Modo rápido
—
—
1,50$
Modo
Precio de entrada/ por M tokens
Precio de producción/ por M tokens
Precio/ tarea
Codificador Qwen 3 480V (Cerebras)
3,75$
3,75$
—
Modo estándar
1,50$
1,50$
—
Modo complejo
4,50$
22,50$
—
Modo rápido
3,75$
3,75$
—
modelo
Precio de entrada/ por M tokens
Precio de producción/ por M tokens
Turbo 1.0
0,11$
0,42$
Apex 1.0
0,88$
7,00$
Razonamiento 2.0
0,38$
1,53$
Investigación profunda 2.0
1,40$
5,60$
Límites de tarifas
Ninja AI impone límites de velocidad en las solicitudes de inferencia por modelo para garantizar que los desarrolladores puedan probar la inferencia más rápida.
modelo
Solicitud por minuto (RPM)
Turbo 1.0
50
Apex 1.0
20
Razonamiento 2.0
30
Investigación profunda 2.0
5
Preguntas frecuentes
Esto es lo que necesita saber sobre la API de Ninja en función de lo que más nos preguntan.
¿Cómo puedo aumentar el límite y el importe de mi pago automático?
En Ninja, ve al panel de la izquierda y haz clic en Icono de administración de API.
Bajo «Tus créditos», hacer clic «Administrar créditos».
En el «Importe de pago automático» campo, introduce la cantidad que deseas aumentar para obtener créditos (mínimo 30$).
En el «Umbral de pago automático» campo, edita el importe límite por el que, cuando tu saldo caiga por debajo de este importe, recargaremos el «Importe de pago automático». Esto garantiza que no te quedes sin créditos ni que tu clave de API deje de funcionar (mínimo 25 dólares).
Haga clic «Guardar cambios» para confirmar.
¿Cómo puedo cancelar mi acuerdo de pago automático?
En Ninja, ve al panel de la izquierda y haz clic en Icono de administración de API.
Seleccione «Claves y créditos de API» luego ve a «Tus créditos» sección.
Bajo «Tus créditos», hacer clic «Más opciones».
Seleccione «Cancelar el pago automático de créditos»(mínimo 30$).
Haga clic «Eliminar pago automático» para confirmar.
¿Cómo elimino una clave de API?
En Ninja, ve al panel de la izquierda y haz clic en Icono de administración de API.
Seleccione «Claves y créditos de API», luego ve a «Claves de API».
Busca tu clave de API y selecciona el icono de la papelera a la derecha.
Haga clic «Eliminar clave de API» para confirmar.
¿Cómo puedo ver el uso de cada solicitud de API?
En Ninja, ve al panel de la izquierda y haz clic en Icono de administración de API.
A continuación, haga clic «Uso de API».
En el «Uso de API» en esta página, verás una tabla que muestra los siguientes detalles de cada API:
Nombre clave
modelo
Tokens de entrada y salida
Coste de entrada y salida
Marca de tiempo para la solicitud
Coste total