Inicio, autenticación, endpoints y códigos de error
RoboVAI es compatible con los clientes oficiales de OpenAI y Anthropic: solo cambia el base_url y el api_key.
https://api.robovai.comEl endpoint siguiente lo devuelve el gateway actual; introdúcelo en el campo base_url / endpoint de API de tu cliente.
Los clientes compatibles con OpenAI usan https://api.robovai.com/api/open/v1; los compatibles con Anthropic (p. ej. Claude Code) usan https://api.robovai.com/api/plan.
Crea una clave en “Panel → Claves de API” y ponla en el campo api_key de tu cliente.
Cada petición envía la clave de API mediante una cabecera HTTP:
apiDocs.auth.headerFormato de clave: las de suscripción empiezan por sub_, las de pago por uso por api_.
No incrustes claves en código frontend ni repositorios públicos; restablécela en el panel si se filtra.
https://api.robovai.com/api/planCompatible con la API Messages de Anthropic — para Claude Code, SDK oficiales de Claude, etc. Ruta completa: https://api.robovai.com/api/plan
https://api.robovai.com/api/open/v1Compatible con la API Chat/Completions de OpenAI — para ChatBox, OpenCat, etc. Ruta completa: https://api.robovai.com/api/open/v1
Endpoints agrupados por modalidad de entrada/salida. El chat de texto es síncrono/streaming; la generación de imágenes devuelve una URL de forma síncrona; la generación de vídeo es asíncrona (enviar y luego consultar). Todos los cuerpos de petición se reenvían al proveedor: solo model es obligatorio; el resto de campos sigue la especificación del modelo correspondiente.
Endpoint asíncrono: envía para obtener un task_id y luego consulta el resultado.
Chat de texto síncrono o en streaming, compatible con los protocolos de OpenAI y Anthropic.
https://api.robovai.com/api/open/v1/chat/completionsCompatible con OpenAI, soporta streaming. Ruta completa: https://api.robovai.com/api/open/v1/chat/completions
https://api.robovai.com/api/plan/v1/messagesCompatible con Anthropic, para Claude Code, etc. Ruta completa: https://api.robovai.com/api/plan/v1/messages
| Estado | Significado | Sugerencia |
|---|---|---|
| 400 Bad Request | Parámetros de petición inválidos | Revisa el cuerpo, el nombre del modelo y el formato de parámetros. |
| 401 Unauthorized | Clave ausente o inválida | Asegúrate de que la cabecera Authorization lleve una clave válida. |
| 402 Payment Required | Saldo insuficiente o cuota agotada | Recarga en el panel o cambia de clave. |
| 403 Forbidden | Sin acceso al modelo | Confirma que el plan de tu clave incluya el modelo. |
| 404 Not Found | Modelo o endpoint no encontrado | Verifica el ID del modelo y la ruta del endpoint. |
| 429 Too Many Requests | Límite de peticiones | Reduce la frecuencia o reintenta más tarde. |
https://api.robovai.com/api/open/v1/responsesOpenAI Responses API (incl. WebSocket). Ruta completa: https://api.robovai.com/api/open/v1/responses
https://api.robovai.com/api/open/v1/embeddingsVectorización de texto. Ruta completa: https://api.robovai.com/api/open/v1/embeddings
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo. |
| messages | array | Sí | Array de mensajes con role y content. |
| stream | boolean | No | Respuesta en streaming, por defecto false. |
| temperature | number | No | Temperatura de muestreo, 0–2, por defecto 1. |
| max_tokens | integer | No | Máximo de tokens a generar. |
| tools | array | No | Lista de herramientas/funciones invocables. |
apiDocs.modalities.text.requestapiDocs.modalities.text.responseDevuelve la URL de la imagen generada de forma síncrona (OpenAI gpt-image vía /api/open; Volcengine Doubao Seedream etc. vía /api/multimodal; Midjourney vía /api/mj).
https://api.robovai.com/api/open/v1/images/generationsOpenAI gpt-image y modelos similares. Ruta completa: https://api.robovai.com/api/open/v1/images/generations
https://api.robovai.com/api/open/v1/images/editsEdición de imagen a partir de una imagen de referencia. Ruta completa: https://api.robovai.com/api/open/v1/images/edits
https://api.robovai.com/api/multimodal/v1/images/generationsVolcengine Doubao Seedream y modelos multimodales similares. Ruta completa: https://api.robovai.com/api/multimodal/v1/images/generations
https://api.robovai.com/api/mj/submit/:actionimagine/blend/action/describe etc.; consulta vía GET /api/mj/task/:task_id. Ruta completa: https://api.robovai.com/api/mj/submit/:action
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo (p. ej. gpt-image, serie Seedream). |
| prompt | string | Sí | Prompt descriptivo de la imagen. |
| n | integer | No | Número de imágenes, por defecto 1. |
| size | string | No | Tamaño de imagen, p. ej. 1024x1024. |
| quality | string | No | Calidad (OpenAI): standard/hd. |
| response_format |
apiDocs.modalities.image.requestapiDocs.modalities.image.responseInterfaz asíncrona: envía una tarea para obtener un task_id y luego consulta hasta que tenga éxito y devuelva result_url.
https://api.robovai.com/api/multimodal/v1/videos/generationsEnvía una generación de vídeo, devuelve task_id. Ruta completa: https://api.robovai.com/api/multimodal/v1/videos/generations
https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_idConsulta el estado de la tarea; devuelve result_url al success. Ruta completa: https://api.robovai.com/api/multimodal/v1/videos/tasks/:task_id
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo (p. ej. serie Seedance). |
| prompt | string | Sí | Prompt descriptivo del vídeo. |
| duration | number | No | Duración del vídeo en segundos, p. ej. 5. |
| resolution | string | No | Resolución, p. ej. 720p, 1080p. |
| ratio | string | No | Relación de aspecto, p. ej. 16:9, 9:16. |
| fps | number | No | Fotogramas por segundo, p. ej. 24, 30. |
apiDocs.modalities.video.requestapiDocs.modalities.video.submitResponseFlujo: POST enviar → obtener task_id → consultar GET a intervalos → leer result_url cuando status sea succeeded.
apiDocs.modalities.video.pollResponseEndpoints de audio compatibles con OpenAI: texto a voz, transcripción, traducción.
https://api.robovai.com/api/open/v1/audio/speechTTS; recibe texto, devuelve audio. Ruta completa: https://api.robovai.com/api/open/v1/audio/speech
https://api.robovai.com/api/open/v1/audio/transcriptionsAudio a texto. Ruta completa: https://api.robovai.com/api/open/v1/audio/transcriptions
https://api.robovai.com/api/open/v1/audio/translationsTraduce audio a texto en el idioma destino. Ruta completa: https://api.robovai.com/api/open/v1/audio/translations
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo (p. ej. tts-1). |
| input | string | Sí | Texto a sintetizar. |
| voice | string | Sí | Voz, p. ej. alloy, echo, nova. |
| response_format | string | No | Formato de audio: mp3/opus/aac/flac, por defecto mp3. |
| speed | number | No | Velocidad, 0.25–4, por defecto 1. |
apiDocs.modalities.audio.request(flujo de audio binario, Content-Type: audio/mpeg)| 500 Internal Server Error |
| Error del servidor |
| Reintenta más tarde; contacta con soporte si persiste. |
| 503 Service Unavailable | Servicio no disponible temporalmente | Reintenta en errores transitorios; no reintentes a ciegas endpoints no idempotentes. |
| string |
| No |
| Formato de retorno: url o b64_json, por defecto url. |
| style | string | No | Estilo (OpenAI): vivid/natural. |