v0.4.0

OpenAPI 3.1.0

Crear un mensaje de Claude

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

Crear un mensaje de Claude

Endpoint compatible con la API Messages de Claude. Establece stream=true para recibir eventos de flujo de mensajes al estilo de Claude. Los campos de solicitud, respuesta y error de validación siguen el protocolo Claude Messages; el Router también puede devolver un envoltorio de error de gateway saneado para fallos de infraestructura.

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·ClaudeMessagesRequest

obligatorio

application/json

max_tokens
Tipo: integer
mín.:
1
obligatorio

Integer numbers.
messages
Tipo: array object[] · ClaudeMessage[] 1…
obligatorio
- content
  obligatorio
  Tipo: string
- role
  Tipo: string enum
  obligatorio
  valores
  user
  assistant
- propertyName
  Tipo: anything
model
Tipo: string
obligatorio
metadata
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.
stop_sequences
Tipo: array string[]
stream
Tipo: boolean
system
Tipo: string
temperature
Tipo: number
mín.:
0
máx.:
1
thinking
Tipo: object
- propertyName
  Tipo: anything
tool_choice
Tipo: string
tools
Tipo: array object[]
- propertyName
  Tipo: anything
propertyName
Tipo: anything

top_k
Tipo: integer
mín.:
0

Integer numbers.
top_p
Tipo: number
mín.:
0
máx.:
1
propertyName
Tipo: anything

Respuestas

200
Tipo: object · ClaudeMessageResponse

Mensaje de Claude o respuesta en streaming
content
Tipo: array object[] · ClaudeContentBlock[]
obligatorio
type
Tipo: string enum
obligatorio
valores
text
image
document
tool_use
tool_result
thinking
content
Tipo: string | array
id
Tipo: string
input
Tipo: object
propertyName
Tipo: anything
name
Tipo: string
source
Tipo: object
propertyName
Tipo: anything
text
Tipo: string
propertyName
Tipo: anything
id
Tipo: string
obligatorio
model
Tipo: string
obligatorio
role
constante:
assistant
obligatorio
stop_reason
Tipo: string | null
obligatorio
type
constante:
message
obligatorio
stop_sequence
Tipo: string | null
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 · ClaudeErrorResponse

Claude invalid_request_error o error de validación de la solicitud del Router

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
401
Tipo: object · ClaudeErrorResponse

Clave de API de Felo no válida o ausente

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
402
Tipo: object · ClaudeErrorResponse

Saldo insuficiente

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
403
Tipo: object · ClaudeErrorResponse

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 la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
429
Tipo: object · ClaudeErrorResponse

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

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
502
Tipo: object · ClaudeErrorResponse

Error en la solicitud al proveedor upstream

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json
503
Tipo: object · ClaudeErrorResponse

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

Envoltorio de error compatible con la API Errors de Claude para solicitudes Messages.
error
Tipo: object
obligatorio
message
Tipo: string
obligatorio
type
Tipo: string
obligatorio
propertyName
Tipo: anything
type
constante:
error
obligatorio
request_id
Tipo: string
propertyName
Tipo: anything
application/json

post/api/v1/messages

curl https://openapi.felo.ai/api/v1/messages \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "claude-sonnet-4-5",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Write a one-sentence greeting."
    }
  ],
  "stream": false
}'

Mostrar esquema

{
  "id": "string",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "string",
      "id": "string",
      "name": "string",
      "input": {
        "additionalProperty": "anything"
      },
      "content": "string",
      "source": {
        "additionalProperty": "anything"
      },
      "additionalProperty": "anything"
    }
  ],
  "model": "string",
  "stop_reason": null,
  "stop_sequence": null,
  "usage": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}

Mensaje de Claude o respuesta en streaming

Crear un mensaje de Claude

AutenticaciónRequired

Crear un mensaje de Claude