Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Crear una respuesta de modelo

Servidor:https://openapi.felo.ai
Bibliotecas cliente

Crear una respuesta de modelo

​

Endpoint compatible con la API Responses de OpenAI. Una respuesta exitosa sin streaming usa la forma del objeto Responses; cuando stream=true, el endpoint devuelve eventos SSE de Responses. Un objeto Responses fallido puede usar status=failed con error={code,message} incluso cuando la solicitud HTTP en sí se completó.

Encabezados
  • X-Felo-Channel
    Tipo: string

    Códigos de canal públicos separados por comas y en orden. Omite este encabezado para usar default; default debe usarse solo. En modo monedero, default recorre en orden inverso el orden efectivo de canales públicos del modelo, omite los canales no publicados o no disponibles y selecciona el proveedor del primer canal disponible. Incluye los endpoints disponibles de ese proveedor con el mismo ID de modelo upstream y el mismo nivel de servicio. Los canales explícitos se validan en el orden indicado por el cliente; solo se envía el grupo de proveedores del primer canal. No hay respaldo automático a otros proveedores. Los encabezados de proveedor heredados no pueden anular el enrutamiento por canales.

Cuerpo·ResponsesRequest
obligatorio
application/json
  • input
    obligatorio
    • Tipo: string
  • model
    Tipo: string
    obligatorio
  • include
    Tipo: array string[]
  • instructions
    Tipo: string
  • max_output_tokens
    Tipo: integer
    mín.:  
    1

    Integer numbers.

  • metadata
    Tipo: object
    • propertyName
      Tipo: anything
  • previous_response_id
    Tipo: string
  • reasoning
    Tipo: object
    • propertyName
      Tipo: anything
  • service_tier
    Tipo: string | null

    Actualmente solo se admite default (estándar). Si se omite, es null, es un alias o es una cadena no admitida, se usa default; otros tipos devuelven HTTP 400. Los canales y precios configurados no cambian. Las API de texto envían el valor estándar del proveedor; las API Decisions y de generación omiten el campo upstream.

  • store
    Tipo: boolean
  • stream
    Tipo: boolean
  • temperature
    Tipo: number
    mín.:  
    0
  • propertyName
    Tipo: anything
  • text
    Tipo: object
    • propertyName
      Tipo: anything
  • tool_choice
    • Tipo: string
  • tools
    Tipo: array object[]
    • propertyName
      Tipo: anything
  • top_p
    Tipo: number
    mín.:  
    0
    máx.:  
    1
  • propertyName
    Tipo: anything
Respuestas
  • 200
    Tipo: object · ResponsesResponse

    Objeto de respuesta o eventos de respuesta en streaming

    • id
      Tipo: string
      obligatorio
    • object
      constante:  
      response
      obligatorio
    • status
      Tipo: string enum
      obligatorio
      valores
      • completed
      • failed
      • in_progress
      • cancelled
      • queued
      • incomplete
    • error
      Tipo: object · ResponsesError
      • code
        Tipo: string
        obligatorio
      • message
        Tipo: string
        obligatorio
      • propertyName
        Tipo: anything
    • metadata
      Tipo: object
      • propertyName
        Tipo: anything
    • model
      Tipo: string
    • output
      Tipo: array object[]
      • propertyName
        Tipo: anything
    • output_text
      Tipo: string
    • usage
      Tipo: object · Usage

      Objeto de uso del proveedor. Los campos varían según el endpoint y el proveedor.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
  • 400
    Tipo: object · OpenAIErrorResponse

    Solicitud, modelo o asignación de proveedor no válidos

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 401
    Tipo: object · OpenAIErrorResponse

    Clave de API de Felo no válida o ausente

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 402
    Tipo: object · OpenAIErrorResponse

    Saldo insuficiente

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 403
    Tipo: object · OpenAIErrorResponse

    La cuenta no tiene permiso para usar el modelo. Los modelos deshabilitados también se rechazan antes de las llamadas upstream. Las solicitudes y tareas ya aceptadas continúan.

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 429
    Tipo: object · OpenAIErrorResponse

    Se alcanzó el límite de gasto o de solicitudes

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 502
    Tipo: object · OpenAIErrorResponse

    Error en la solicitud al proveedor upstream

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
  • 503
    Tipo: object · OpenAIErrorResponse

    El proveedor o el servicio de facturación no está disponible

    Envoltorio de error compatible con OpenAI. El Router puede incluir code y message sin todos los campos upstream opcionales.

    • error
      Tipo: object
      obligatorio
      • message
        Tipo: string
        obligatorio
      • code
        Tipo: string | null
      • param
        Tipo: string | null
      • type
        Tipo: string

        Tipo de error compatible con OpenAI cuando se proporciona.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
    application/json
Request Example for post/api/v1/responses
curl https://openapi.felo.ai/api/v1/responses \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "gpt-5.5",
  "input": "Explain why the sky is blue in one sentence.",
  "stream": false
}'
{
  "id": "string",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "additionalProperty": "anything"
    }
  ],
  "output_text": "string",
  "error": {
    "code": "string",
    "message": "string",
    "additionalProperty": "anything"
  },
  "usage": {
    "additionalProperty": "anything"
  },
  "model": "string",
  "metadata": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}
Create a model response