Saltar al contenido principal
Crea una clave de API, envía una solicitud a POST /v1/responses y lee la respuesta en output_text.

Empieza con tu agente de código

Copia este prompt en tu agente de código. Detecta el lenguaje de tu proyecto, instala el SDK, dirige al agente a la documentación de Phaseo, mantiene tu clave fuera del código y hace una primera solicitud. Si tu proyecto ya usa Phaseo, revisa esa configuración en lugar de empezar de cero. phaseo/free funciona sin créditos; cámbialo por cualquier ID de modelo de texto de Modelos.

Prompt de configuración para tu agente de código. Cópialo o ábrelo en Cursor.

Abrir en Cursor
Para configurarlo tú mismo, sigue los pasos de abajo.

1. Crea una clave de API

Crea una clave en el panel, en Ajustes -> Claves de API, y expórtala:
La clave solo se muestra una vez. Cada solicitud la envía como token de portador:
Trata tu clave de API como una contraseña. Guárdala en código del servidor y nunca la incluyas en un navegador ni en una aplicación móvil.

Añade créditos para modelos de pago

phaseo/free funciona sin créditos. Los modelos de pago como openai/gpt-6-astra necesitan saldo en el monedero:
Con una tarjeta guardada, un propietario o administrador del espacio de trabajo confirma el cargo desde un enlace enviado por correo. Sin tarjeta guardada, el comando devuelve un enlace de pago que un propietario o administrador abre para pagar, y la tarjeta queda guardada para las recargas posteriores.

2. Envía una solicitud de texto

POST /v1/responses es el endpoint recomendado para el trabajo nuevo con texto. Los ejemplos usan openai/gpt-6-astra, un modelo de pago. Para probar sin créditos, sustitúyelo por phaseo/free, que elige un modelo gratuito disponible; consulta Lanza con el router gratuito. cURL y fetch no necesitan instalar nada. Para usar un SDK, instálalo primero:
Consulta la página de instalación de TypeScript y Python para conocer los requisitos de entorno de ejecución y los demás SDK.

3. Lee la respuesta

Transmite la respuesta

Usa streaming para mostrar la respuesta a medida que se genera. El campo text de cada evento response.output_text.delta contiene solo el texto nuevo, así que este bucle imprime la respuesta una sola vez. Los eventos de cierre como response.output_text.done repiten texto que ya se ha transmitido. Consulta Streaming para ver la lista completa de eventos.

4. Soluciona los problemas de la primera solicitud

La referencia de errores enumera todos los códigos de error y qué hacer con cada uno.

Obtén respuestas tipadas en lugar de texto

Cuando tu código necesita un valor y no texto libre, envía preguntas a POST /v1/decisions (Beta). Cada respuesta vuelve tipada, con probabilidades, en el mismo orden que las preguntas. Los tipos de pregunta son predicate (sí/no), choice (una de tus opciones) y score (un nivel en tu escala).
La respuesta (valores ilustrativos):
Lee answers[0].choice o answers[1].probability, y usa confidence o probabilities para fijar tu propio umbral. La referencia de Decisions enumera todos los modelos de decisión, sus límites y precios, la entrada de imágenes y el formato antiguo state con mapas de preguntas con nombre (noul, criteria), que sigue funcionando y que algunos modelos exigen.

Genera un vídeo

La generación de vídeo es asíncrona: crea un trabajo, consulta su estado y después descarga el archivo.
Para recibir un webhook en lugar de consultar el estado, consulta Trabajos asíncronos y webhooks.

Sigue construyendo

Integrar el Gateway

Elige un endpoint y configura una integración para producción.

Referencia de la API

Todos los campos de solicitud y respuesta de cada endpoint.

Ejemplos

Aplicaciones iniciales para flujos de trabajo habituales.

Soporte

Obtén ayuda con la depuración, el enrutamiento y el comportamiento de los modelos.
Última modificación el 16 de noviembre de 2026