Saltar al contenido principal

Primeros pasos

Esta guía lleva a un usuario de autoservicio desde el registro hasta la primera solicitud a la API. Si su organización está siendo conectada por OmevAI, utilice el acceso y la clave proporcionados durante la configuración gestionada; los pasos de la API que se describen a continuación son los mismos.

1. Cree una cuenta de autoservicio​

  1. Abra cabinet.omev.be y seleccione Start free trial.
  2. Introduzca su correo electrónico de trabajo y describa cómo utiliza la IA. Los datos de la empresa y el volumen mensual previsto son opcionales.
  3. Complete la verificación del navegador y envíe el formulario.
  4. Abra el correo electrónico de OmevAI. Contiene un enlace de inicio de sesión y un código de seis dígitos; cualquiera de los dos métodos funciona.
  5. Tras la verificación, el panel de control crea la cuenta y muestra la clave de API inicial.

La prueba de autoservicio incluye 5 USD de crédito durante 10 días y no requiere una tarjeta de pago. La API de texto y la API de lenguaje natural funcionan con cualquier clave; las imágenes, el vídeo y los productos de investigación se activan para una clave bajo petición.

2. Guarde la clave​

Copie la clave completa directamente en su gestor de contraseñas o sistema de gestión de secretos. Para la clave inicial, la pantalla Keys puede ofrecer una acción adicional de Show the key once. Una vez utilizada esa visualización, solo estará disponible una máscara. Una clave creada posteriormente en una pantalla de la organización debe copiarse durante su creación.

Nunca ponga una clave en JavaScript del lado del navegador, una aplicación móvil, un repositorio público, una captura de pantalla o un mensaje de soporte. Los ejemplos siguientes suponen que la clave está almacenada en el servidor como OMEV_API_KEY.

3. Compruebe qué puede usar la clave​

curl -sS https://llmapi.omev.be/v1/models \
  -H "Authorization: Bearer $OMEV_API_KEY"

Desarrolle únicamente utilizando los nombres públicos documentados omev-* que se devuelven para su clave. Los productos de imagen solo aparecen después de que se haya habilitado su acceso. Los precios de todos los productos están en Modelos y precios.

4. Envíe la primera solicitud de texto​

curl -sS https://llmapi.omev.be/v1/chat/completions \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omev-lite",
    "messages": [
      {"role": "system", "content": "Follow the requested format carefully."},
      {"role": "user", "content": "Summarise this text in five bullets: ..."}
    ],
    "temperature": 0.2,
    "max_tokens": 500,
    "stream": false
  }'

La respuesta se encuentra en choices[0].message.content. Consulte Modelos para Python, selección de modelos, streaming y JSON estructurado.

5. Pruebe una solicitud exacta en el Playground​

Abra el Playground en el panel de control web cuando quiera probar el mismo cuerpo JSON que enviará su aplicación. Puede pegar un comando curl existente o construir una solicitud en el formulario. El Playground muestra la respuesta, el recuento de tokens, la duración, el cuerpo de la solicitud y ejemplos de código para curl, Python y NodeJS.

La clave en el código copiado está enmascarada. Reemplace la máscara con OMEV_API_KEY o una referencia a su gestor de secretos antes de ejecutar el ejemplo fuera del navegador.

6. Revise el uso y el coste​

Las cuentas de autoservicio utilizan las secciones Dashboard, Usage, Journal y Billing en el panel de control web. Las llamadas recientes pueden tardar unos minutos en aparecer.

Los clientes corporativos también reciben acceso a usage.omev.be después de que se aprovisionen la organización y el primer propietario aprobado. El propietario puede invitar a otras personas sin tener que pedir a OmevAI que introduzca cada correo electrónico manualmente.

7. Continúe de forma segura​

  • Utilice claves distintas cuando el panel de control y su rol lo permitan y sea útil un control separado.
  • Establezca max_tokens para limitar los tokens de salida facturados, defina tiempos de espera (timeouts) y use un número máximo de reintentos pequeño.
  • Reintente las respuestas 429, las 5xx temporales y los errores de red transitorios con un retardo creciente. No repita una solicitud 400, 401, 403, 404 o 413 sin cambios.
  • Valide la salida estructurada en su propia aplicación.
  • Guarde los identificadores de solicitud y las máscaras de clave en los registros, nunca las claves completas ni los prompts confidenciales.

Para preguntas sobre el acceso o un problema no resuelto, contacte con support@omev.be. Incluya el correo electrónico de la cuenta, la hora aproximada y la zona horaria, el endpoint, el modelo público, el estado, el identificador de la solicitud cuando esté disponible y un ejemplo saneado.